Register Webhook

POST {{baseUrl}}/webhooks/subscribe

This endpoint allows you to register a new webhook. The webhook used is to notify/update/delete an external service when an event has occurred.

To trigger your webhook to send data, You can choose one event from the list of events which You can get from the List Events Endpoint.

Read more on Webhooks here.

:::note • New subscriptions with the same URL will update events / restore old webhooks (if they exist). • The added URL must accept POST requests. • By default, all new webhooks are registered as version 2. To use version 1, specify it in your request parameters. :::

webhooks.read_write- Webhooks Read & Write

Request Body

{"event"=>"<string>", "url"=>"<string>", "name"=>"<string>", "version"=>2, "rule"=>"<string>", "headers"=>[{"key"=>"<string>", "value"=>"<string>"}, {"key"=>"<string>", "value"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;status&quot;:&quot;\u003cnumber\u003e&quot;,&quot;success&quot;:&quot;\u003cboolean\u003e&quot;,&quot;data&quot;:{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;event&quot;:&quot;\u003cstring\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;version&quot;:2,&quot;rule&quot;:&quot;\u003cstring\u003e&quot;,&quot;headers&quot;:{&quot;Authorization&quot;:&quot;\u003cstring\u003e&quot;,&quot;Accept-Language&quot;:&quot;\u003cstring\u003e&quot;}}}