Enroll a store into a cadence

POST/cadences/{id}/enrollments

Requires scope: write:outreach

Parameters

Parameter	In	Type	Description
`id`required	path	string	Cadence id
`Idempotency-Key`	header	string	Accepted; enrollment dedupe is one-live-per-store so a repeat is a no-op.

Request body

Field	Type	Allowed values	Description
`store_id`required	string	any string
`contact_id`	string	any string	Optional; the best contact on file is chosen otherwise

Responses

Status	Description
`200`	Enrolled
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`409`	Already in a cadence / not enrollable
`422`	No usable contact for the store
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/cadences/:id/enrollments" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "store_id": "b7c9a2e1-0000-4000-8000-000000000000",
  "contact_id": "b7c9a2e1-0000-4000-8000-000000000000"
}'

Response (200)

{
  "ok": true,
  "enrolled": 0,
  "earliest_next_send_at": "string"
}