Create a webhook

Creates a webhook given a URL and one or more events.

Registering a webhook is non-idempotent, i.e. you are responsible for not registering the same webhook multiple times.

The timeout for webhook requests is 60 seconds. Successful receipt requires a 2xx response code. Webhook delivery is retried up to 10 times if the request fails.

Use the returned webhook secret to verify the authenticity of received webhook events using HMAC-SHA256.

Body Params
events
array of objects
required
length ≥ 1

The webhook events to subscribe to. At least one event must be specified.

events*
uri
required
length between 1 and 2083

The URL to send webhook event notifications to.

Responses

422

invalid request

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json