Webhooks
These routes allow you to CRUD webhooks within Cal.com.
Find all webhooks
Finds all webhooks
GET
http://localhost:3002/v1/hooks
Create a new webhook
Creates a new webhook
POST
http://localhost:3002/v1/hooks
Request Body
Name | Type | Description |
---|---|---|
id* | String | UUID v4, identifies the webhook |
eventTriggers* | ENUM | ["BOOKING_CREATED", "BOOKING_RESCHEDULED", "BOOKING_CANCELLED"'] |
subscriberUrl* | String | A valid webhook subscriber URL |
active* | Boolean | The state of the webhook being created |
eventTypeId | Number | Event type ID to associate the webhook with |
appId | Number | App ID to associate the webhook with |
payloadTemplate | String | A template to customize the webhook payload |
Find a webhook
Find a webhook from id
GET
http://localhost:3002/v1/hooks/{id}
Path Parameters
Name | Type | Description |
---|---|---|
id* | String | ID of the webhook to find |
Edit an existing webhook
Edit an existing webhook identified by id
PATCH
http://localhost:3002/v1/hooks/{id}
Path Parameters
Name | Type | Description |
---|---|---|
id* | String | ID of the webhook to edit |
Request Body
Name | Type | Description |
---|---|---|
eventTrigger | ENUM | ["BOOKING_CREATED", "BOOKING_RESCHEDULED", "BOOKING_CANCELLED"'] |
payloadTemplate | String | A template to customize the webhook payload |
subscriberUrl | String | A valid webhook subscriber URL |
Delete a webhook
Deletes a webhook identified by id
DELETE
http://localhost:3002/v1/hooks/{id}
Path Parameters
Name | Type | Description |
---|---|---|
id* | String | Id of the webhook to delete |
Last updated