Voice / Calls (legacy) API

Open API playground All endpoints

Deprecated endpoints kept for backwards compatibility. Prefer the Voice / Calls endpoints for all new integrations.

(Deprecated) Initiate a call

POST/api/v1/calls/initiatedeprecated

Deprecated. Use POST /api/v1/voice/calls/initiate (Voice / Calls) instead. This path is kept only for backwards compatibility and will be removed in a future version.

Auth: x-api-key header

Request body

from_numberrequiredstring

The number to place the call from, in E.164 format. Must be a number you own.

to_numberrequiredstring

The destination number to dial, in E.164 format.

flow_urlrequiredstring (uri)

HTTPS URL Teler fetches when the call connects to obtain the call flow that drives the call.

status_callback_urlrequiredstring (uri)

HTTPS URL that receives status webhooks for the lifetime of the call.

recordboolean

Whether to record the call. Defaults to true.

Example request

{
  "flow_url": "https://example.com/flows/123",
  "from_number": "+14155552671",
  "record": true,
  "status_callback_url": "https://yourapp.com/callback",
  "to_number": "+14155559876"
}

Responses

Status	Description
202	The call was accepted and is being placed.
403	The x-api-key header is missing or invalid.
422	The request body or query parameters failed validation.
502	Teler could not reach the call-control service.
504	The call could not be initiated in time.

Example response (202)

{
  "data": {
    "from_number": "+14155552671",
    "id": "cs_01JQ8Z9K7M3N2P4R5S6T7V8W9X",
    "record": true,
    "status_callback_url": "https://yourapp.com/callback",
    "to_number": "+14155559876"
  },
  "message": "Call initiated successfully"
}