React to call events

Get notified the moment a call ends, instead of polling for it. Time required: ~15 minutes You will need: an API key, and an HTTPS endpoint you control that can receive a POST

Steps

Stand up an endpoint

Your endpoint needs to accept a POST with a JSON body and respond 2xx within 10 seconds. Respond immediately and do any slow work afterward — see Webhook retries and replay.

Subscribe to call.hangup

curl -X POST "https://api.get2dial.com/api/v1/webhooks" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Call ended notifier",
    "url": "https://example.com/webhooks/get2dial",
    "event_types": ["call.hangup"]
  }'

The response includes a secret — save it now. It’s shown exactly once.

Verify the signature on every delivery

See Verify webhook signatures — implement this before you trust any payload.

Handle the event

A call.hangup payload looks like this — see the event catalog for the full shape:

{
  "tenant_id": "...",
  "call_id": "...",
  "trace_id": "...",
  "hangup_cause": "NORMAL_CLEARING",
  "duration_ms": 125000,
  "timestamp": "2026-08-05T14:32:11Z"
}

Use call_id to look up the full record via Search call detail records if you need more than the event carries.

What you accomplished

Your system now reacts to calls ending in real time, instead of polling CDRs on a schedule.

Next steps

Webhook event catalog

Webhook delivery failures

⌘I

Getting started

API basics

Webhooks

Realtime and CTI

Recipes

Integrations

Going to production

React to call events

Steps

What you accomplished

Next steps

Webhook event catalog

Webhook delivery failures

​Steps

​What you accomplished

​Next steps

Webhook event catalog

Webhook delivery failures

Steps

What you accomplished

Next steps