---
title: "Initiate Call"
method: POST
path: "/v1/initiate-call"
---

# Initiate Call

`POST /v1/initiate-call`

[Not recommended] Initiates an immediate call to a contact. Will call even outside business hours, which is why we recommend using schedule-call instead. If contact cannot be reached and Auto Dialer is enabled, telli will continue trying according to Auto Dialer settings.

## Request body

- object
  - `contact_id` string, uuid, required — telli contact ID of the contact to call
  - `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

## Response `200`

Call initiated successfully

- object
  - `message` string
  - `call_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)