Create schedule

Queue a batch of outbound calls to be dispatched at a future time.

Authorization

ApiKeyAuth

X-API-Key<token>

Voice platform authentication secret. Create one from the API Keys endpoint or your dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

agentId*string

Target agent to run the batch.

contactCount*integer

Number of contacts in the batch.

name*string

Human-readable campaign name.

scheduledAt*string

ISO 8601 time to begin dispatch.

Response Body

`application/json`

curl -X POST "https://example.com/schedules" \  -H "Content-Type: application/json" \  -d '{    "agentId": "agt_8skd92ja",    "name": "June re-engagement batch",    "contactCount": 120,    "scheduledAt": "2026-06-25T15:00:00Z"  }'

{  "id": "string",  "agentId": "string",  "name": "string",  "contactCount": 0,  "scheduledAt": "string",  "status": "string"}

{  "statusCode": 400,  "message": [    "name should not be empty"  ],  "error": "Bad Request"}

{  "statusCode": 401,  "message": "Unauthorized",  "error": "Unauthorized"}

Create schedule

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`