Skip to main content
The Contour API lets your backend place outbound calls, read their results, and receive signed webhooks when calls start, end, and are analyzed. Everything is plain HTTPS and JSON. The base URL is:

Quickstart

Register a webhook, send a test event, and place your first call in four requests.

Authentication

Send your organization’s API key as a bearer token.

Creating calls

Request fields, Retell-compatible aliases, and every error code.

Webhooks

Events, request format, retries, and signature verification.

​
How a call flows

  1. You POST /v1/calls with an agent id, a number to dial, and any per-call variables. The response is immediate and includes a call_id.
  2. We dial. A call.started webhook is sent as soon as the call is queued.
  3. The call ends. A call.ended webhook carries the disposition, duration, and a recording link.
  4. Analysis runs. A call.analyzed webhook carries the summary and the structured fields configured on your agent.
The same call object appears in every webhook and on GET /v1/calls/{call_id}, so you can poll instead of, or in addition to, receiving events.

​
What is never included

The transcript, per-turn messages, and the session report never appear in webhooks or API responses.