curl --request POST \
--url https://julian.11x.ai/api/v1/agents/{agentId}/schedule/sequences \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contacts": [
{
"name": "John Doe",
"phoneNumber": "+12125550123",
"account_id": "account_123"
},
{
"name": "Jane Smith",
"phoneNumber": "+12125550124",
"account_id": "account_456"
}
]
}
'{
"batchId": "550e8400-e29b-41d4-a716-446655440000",
"total": 2,
"accepted": 2,
"rejected": []
}Enroll multiple contacts
Schedule up to 1,000 contacts in a single request — the API equivalent of CSV import.
Validation is per-contact: valid contacts are queued, and invalid contacts are returned in rejected[] with their original zero-based index. total always equals accepted + rejected.length on a 202. Invalid JSON, invalid field types, invalid request options, agent configuration errors, no valid contacts, or insufficient credits reject the whole request.
Examples: the request examples assume the agent requires account_id. Replace that field with every custom input variable required by your agent, directly on each contact. Use List agent input variables to discover them. The default example omits scheduledAt so 11x chooses times using the agent’s schedule. Provide toEmailAddress for agents with email steps.
Asynchronous results: 202 confirms that accepted contacts passed upfront checks and were queued. Sequence creation happens in the background and can still fail. batchId identifies the request; sequence IDs are not returned here, and there is no public batch-status endpoint. Inspect background scheduling failures in the agent’s scheduling logs. Receive completed-call results through the Call Results webhook, or retrieve available conversation results using Search conversations.
Duplicate detection: phone numbers are normalized first, so +12125550123 and +1 (212) 555-0123 collide. By default only the first occurrence in the batch is accepted. Contacts are also rejected if a sequence for the same phone number on this agent is still in progress or started within the past 30 days. allowDuplicates: true bypasses both duplicate checks. Opt-outs and California calling restrictions still apply.
Contact chaining (groupByField): contacts are grouped by the value of the named custom variable. Only the first valid contact in each group is scheduled immediately; the rest activate automatically when an earlier call in the same group does not reach a successful outcome.
Rate limiting: this endpoint allows 600 requests per minute per agent by default, shared across API keys for the same organization. The agent may have a different configured limit. On 429, wait for Retry-After seconds before retrying.
Idempotency: send an Idempotency-Key to make retries safe. Retrying a request that returned 202 with the same key and the same body returns the original response with Idempotent-Replayed: true and schedules nothing again. See the Idempotency-Key header for the other cases.
Request signing: agents with signing enabled also require X-HMAC-Timestamp and X-HMAC-Signature. See Authentication for the signature format.
curl --request POST \
--url https://julian.11x.ai/api/v1/agents/{agentId}/schedule/sequences \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contacts": [
{
"name": "John Doe",
"phoneNumber": "+12125550123",
"account_id": "account_123"
},
{
"name": "Jane Smith",
"phoneNumber": "+12125550124",
"account_id": "account_456"
}
]
}
'{
"batchId": "550e8400-e29b-41d4-a716-446655440000",
"total": 2,
"accepted": 2,
"rejected": []
}Authorizations
Organization API key. Get it from the 11x team or from the platform.
Headers
Optional, max 255 characters after trimming. When supplied, its value is returned as batchId; otherwise 11x generates a UUID. Only a 202 records the key, for 24 hours. Within that time, a request with the same key and a byte-for-byte identical body returns the stored 202 response with the Idempotent-Replayed: true header and schedules nothing again; the same key with a different body returns 422 IDEMPOTENCY_KEY_REUSED. While the first request with a key is still being processed, another request with that key returns 409 IDEMPOTENCY_KEY_IN_PROGRESS. If the first request with a key does not return 202, nothing is recorded and the key can be reused for a corrected request. Use a new key for each new batch.
Required when request signing is enabled for this agent. Current Unix time in seconds, within the agent's configured tolerance (default ±300 seconds).
^\d{1,10}$Required when request signing is enabled for this agent. Base64-encoded HMAC-SHA256 of POST + newline + timestamp + newline + the exact JSON body, using the agent's signing secret. The x-api-key header is also required.
Path Parameters
ID of the agent, e.g. agent.abc123.
Body
Contacts to enroll (1–1,000).
1 - 1000 elementsShow child attributes
Show child attributes
Default IANA timezone applied to contacts that don't supply their own. If omitted, falls back to the agent's first configured timezone.
"America/New_York"
Group contacts by the value of a custom variable for contact chaining. Only the first valid contact per group is scheduled immediately. Cannot be combined with allowDuplicates.
"account_id"
Custom variable names to title-case before scheduling (e.g. "JOHN" → "John"). Only applied for organizations in the normalization allowlist.
Bypass duplicate checks within the batch and against sequences on this agent that are still in progress or started within the past 30 days. Opt-outs and California calling restrictions still apply. Cannot be combined with groupByField.
Response
Accepted contacts were queued for asynchronous processing. Both full and partial acceptance return 202. Inspect rejected[] and do not assume sequence creation has completed.
Request correlation identifier: the trimmed Idempotency-Key when supplied, otherwise a generated UUID. This identifier is not a sequence ID.
"550e8400-e29b-41d4-a716-446655440000"
Total contacts submitted.
1 <= x <= 10002
Contacts that passed upfront checks and were queued for background scheduling. Background creation can still fail.
1 <= x <= 10002
Per-contact validation failures (empty when all passed).
Show child attributes
Show child attributes