Create Webhook
Last updated
Last updated
POST /webhooks
Registers a new webhook. By default, organizations are limited to creating 5 webhooks.
Webhooks:Create
url
String - Required
The webhook endpoint url where events will be pushed. The url needs to be a valid http / https url.
description
String - Optional
Description of what the endpoint is for.
status
String - Optional
Possible values: Enabled
| Disabled
. If webhook status is Disabled
, no event will be pushed to the webhook endpoint. If status
is not specified, default status is Enabled
.
events
String List - Required
id
String
ID of the webhook
url
String
See above
description
String - Optional
See above
status
String
See above
events
String List
See above
dateCreated
String
ISO 8601 string representing date of creation of the webhook
dateUpdated
String
ISO 8601 string representing date of update of the webhook
secret
String
Secret which can be used to verify authenticity of the message received by the webhook (more details here). The secret
is only included in the "Create Webhook" response, we will never show it to you again, so you need to save it securely on your side upon webhook creation.
List of the webhook subscribes to (see full list here). You can also subscribe to all events by passing events: ["*"]
.