Quickstart

You need two things from the Contour dashboard:

An API key. Create one under Settings → Developers → API keys. It is shown once.
An agent ID. Open Agents, pick an outbound agent, and copy the ID shown under its name. The quick-start card under Settings → Developers can also fill it into a ready-to-run command for you.

Export both:

export CONTOUR_API_KEY=sk_cont_...
export AGENT_ID=3f1c1b2e-...

Save the secret from the response. It is shown once.

curl -X POST https://api.contourvoice.com/v1/webhook-endpoints \
  -H "Authorization: Bearer $CONTOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/webhooks/contour","events":["call.started","call.ended","call.analyzed"]}'

Don’t have a receiver yet? Create a URL at webhook.site and use it here to see exactly what we send. See Testing your endpoint.

Confirm your handler accepts a signed event

No call is placed. The response tells you whether your server answered 2xx.

curl -X POST https://api.contourvoice.com/v1/webhook-endpoints/$ENDPOINT_ID/test \
  -H "Authorization: Bearer $CONTOUR_API_KEY"

Place a call

curl -X POST https://api.contourvoice.com/v1/calls \
  -H "Authorization: Bearer $CONTOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"'$AGENT_ID'","to_number":"+15555550100","variables":{"patient_name":"Jane Doe"},"metadata":{"your_order_id":"ORD-8812"}}'

The response is a 201 with a call_id. call.started, call.ended, and call.analyzed events follow at your endpoint.

Read the call back any time

curl https://api.contourvoice.com/v1/calls/$CALL_ID \
  -H "Authorization: Bearer $CONTOUR_API_KEY"

Creating calls for every request field and error code.
Verifying signatures to confirm events really came from Contour.
The API reference for schemas and an interactive playground.

Get started

Calls

Webhooks

Next

​Next

Next