Sequences
Enroll by IDs
Enroll existing contacts into a sequence by their IDs.
POST /api/v1/sequences/:id/enroll
Enroll one or more existing contacts by their IDs. Contacts that already have an active run in the sequence are skipped.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
contactIds | string[] | Yes | Array of contact UUIDs (max 500) |
Example
curl -X POST /api/v1/sequences/SEQUENCE_ID/enroll \
-H "x-api-key: mndr_..." \
-H "Content-Type: application/json" \
-d '{
"contactIds": [
"contact-uuid-1",
"contact-uuid-2"
]
}'{
"enrollment": {
"id": "uuid",
"sequenceId": "uuid",
"status": "completed",
"totalContacts": 2,
"successfulEnrollments": 2,
"failedEnrollments": 0,
"skippedDuplicates": 0
},
"summary": {
"processed": 2,
"successful": 2,
"failed": 0,
"skipped": 0
}
}Summary Fields
- processed — Total contacts attempted
- successful — New sequence runs created
- failed — Contacts that errored during enrollment
- skipped — Contacts already enrolled (active run exists)