Setting up Webhooks

Turning On the Webhooks Integration

  1. Go to the Webhooks section in your workspace integrations page.

  2. If it's turned of, click the toggle to turn on the integration. Notice that Webhooks is available only as part of the developer pack on our premium plans.

Generating a Signing Key

Before you can start using Webhooks, you need to generate a signing key. This key is essential for ensuring the authenticity of incoming HTTP payloads and preventing malicious requests.

To generate a signing key:

  1. Click on the Generate key button under the Webhooks section in your workspace integrations page.

  2. Click Copy to copy it to your clipboard.

  3. Paste it somewhere safe and use it in your code to validate incoming events (see our code sample below).

  4. You can always refresh the signing key by clicking Refresh key. On refresh, the previous key will be valid for the next 24 hours.‍

Creating a Webhook

To start receiving webhook events, you need to create a webhook:

  1. Go to the Webhooks section in your workspace integrations page.

  2. Create a webhook by specifying a name, URL, and at least one trigger.

  3. Ensure that the URL you specify points to a secure endpoint using HTTPS.

Last updated