POST
/
webhooks
curl --request POST \
  --url https://api.cal.com/v1/webhooks \
  --header 'Content-Type: application/json' \
  --data '{
  "subscriberUrl": "<string>",
  "eventTriggers": "BOOKING_CREATED",
  "active": true,
  "payloadTemplate": "<string>",
  "eventTypeId": 123,
  "secret": "<string>"
}'

Authorizations

​
apiKey
string
query
required

Query Parameters

​
apiKey
string
required

Your API key

Body

application/json
Create a new webhook
​
subscriberUrl
string
required

The URL to subscribe to this webhook

​
eventTriggers
enum<string>
required

The events which should trigger this webhook call

Available options:
BOOKING_CREATED,
BOOKING_RESCHEDULED,
BOOKING_CANCELLED,
MEETING_ENDED
​
active
boolean
required

Whether the webhook is active and should trigger on associated trigger events

​
payloadTemplate
string

The template of the webhook's payload

​
eventTypeId
number

The event type ID if this webhook should be associated with only that event type

​
secret
string

The secret to verify the authenticity of the received payload

Response

201
_mintlify/placeholder

OK, webhook created

Was this page helpful?

Suggest editsRaise issue