---
title: "Schedule Call"
method: POST
path: "/v1/schedule-call"
---

# Schedule Call

`POST /v1/schedule-call`

Schedules a call at the earliest opportunity within the dialer window. May occur immediately or on the next business day depending on settings. Requires the auto dialer to be enabled.

## Request body

- object
  - `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`

Call scheduled successfully

- object
  - `status` string
  - `contact_id` string, uuid
  - `loop_id` string, uuid

## 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)