---
title: "Schedule Calls Batch"
method: POST
path: "/v1/schedule-calls-batch"
---

# Schedule Calls Batch

`POST /v1/schedule-calls-batch`

Schedules multiple calls in a single request. Limited to 50 contacts per request.

## Request body

- object
  - `contacts` object[], required — Array of contacts to schedule calls for. Maximum 50 contacts per request.
    - `contact_id` string, uuid, required — telli contact ID of the contact to schedule a call with
    - `agent_id` string, required — Agent ID to use for the call
    - `max_retry_days` number — Optional number of days to retry the call. Defaults to the account's max retry days
    - `override_from_number` string — Optional phone number to use as the caller ID. Must be a valid E.164 number that belongs to the account
    - `schedule` object, nullable — Optional schedule configuration. Use to schedule a call at a specific time, and optionally to bypass dialing window restrictions. Setting a schedule will override any existing schedule for the contact and agent.
      - `at` string, date-time, required — ISO 8601 timestamp in UTC to schedule the call at a specific time. Must be in the future (up to 90 days)
      - `ignore_dialing_window` boolean — Optional flag to bypass dialing window restrictions for the scheduled call. When true, calls at the scheduled time regardless of dialing windows. When false or omitted, respects dialing windows

## Response `200`

Calls scheduled successfully

- object[]
  - `contact_id` string, uuid — The telli contact ID (only present for successful scheduling)
  - `status` 'success' | 'error' — Status of the call scheduling
  - `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)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key
- `402` — Payment Required

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)