Skip to main content
POST
Create a call webhook

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
url
string<uri>
required

HTTPS endpoint that receives a POST for every call event

Maximum string length: 2048
events
enum<string>[]

Which events to send. Defaults to both call.started and call.ended.

Minimum array length: 1
Available options:
call.started,
call.ended
phone_number_id
integer

Only calls on this number (id from GET /v1/phone-numbers). Omit for all your numbers.

Required range: -9007199254740991 <= x <= 9007199254740991
description
string

A label for the webhook

Maximum string length: 100

Response

Success

data
object
required