Skip to main content
POST
/
v1
/
schedule-calls-batch
Schedule Calls Batch
curl --request POST \
  --url https://api.telli.com/v1/schedule-calls-batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contacts": [
    {
      "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "<string>",
      "max_retry_days": 123,
      "override_from_number": "<string>",
      "schedule": {
        "at": "2024-01-01T10:00:00.000Z",
        "ignore_dialing_window": false
      }
    }
  ]
}
'
[
  {
    "contact_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "success",
    "loop_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  },
  {
    "contact_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "status": "success",
    "loop_id": "d4e5f6a7-b8c9-0123-defg-h23456789012"
  },
  {
    "contact_id": "e5f6a7b8-c9d0-1234-efgh-i34567890123",
    "status": "error",
    "error_message": "Contact not found",
    "error_code": 400
  }
]

Authorizations

​
Authorization
string
header
required

API key must be provided as: Bearer <api_key>

Body

application/json
​
contacts
object[]
required

Array of contacts to schedule calls for. Maximum 50 contacts per request.

Response

Calls scheduled successfully

​
contact_id
string<uuid>

The telli contact ID (only present for successful scheduling)

​
status
enum<string>

Status of the call scheduling

Available options:
success,
error
​
loop_id
string<uuid>

The call loop ID (only present for successful scheduling)

​
error_message
string

Error message (only present for failed scheduling)

​
error_code
integer

Error code (only present for failed scheduling)