Only Admin-level workspace users (Owner, Admin, Non-Signing Admin) can access and configure these settings.

Overview

Webhooks let you listen to a specified URL for workspace events. You can learn more about webhook event types in our Developer Portal's API Documentation.

Webhook notification IP addresses

Whitelist the following IP addresses to receive webhook notifications about workspace events:

Webhooks sent via the notification center may not have fixed IPs. Please test webhook notifications to confirm IP addresses.

There are two options available to configure URLs for webhook notifications:

Select Settings > General, then scroll down to the Configure Webhook URL heading and select Manage URLs.
On the Configure Webhook URL window, enter a URL to define the HTTPS endpoint, then press Enter. You can enter up to 20 webhook URLs.
Select Save.

Select Settings > Notifications, then select Webhooks from the Channel column. Select the Add new hook button.
In the Add new hook window:
- Under General settings, provide a name and summary for the new webhook notification, and a URL to define the HTTPS endpoint and enter the webhook secret key.
- For Event settings, select the events you want to trigger the new webhook notification. You can only enter 1 webhook URL per each notification.
Select CREATE HOOK when finished.

Each webhook URL must be a legal, globally available HTTPS address (e.g. https://example.com).
Webhook URLs cannot exceed 255 characters.
If you want to configure more than 20 webhook URLs, deploy a server that receives webhooks at one of the URLs entered. You can then distribute webhook events to multiple destinations from your server.
You must provide your secret key to use the Notifications settings setup method.