post
https://api.speculo.ai/v1/calls/enroll
Enroll a contact in a Convert flow to trigger an outbound voice call.
This endpoint:
- Creates or updates the contact in your organization
- Looks up the Convert flow by its lead_email identifier
- Enrolls the contact in the flow
- Triggers the outbound call sequence
- Implements automatic deduplication (prevents duplicate calls within 24 hours)
Deduplication Logic:
- Prevents enrollment if the contact has an execution of THIS flow in the last 24 hours
- Prevents enrollment if the contact has an active/pending execution of THIS flow
- Returns existing execution details if duplicate is detected
Security Note: The endpoint automatically extracts your organization ID from the bearer token and only allows enrollment in flows belonging to your organization.
