Set up webhooks
Listen for events on your account so your integration can automatically trigger reactions.
Webhooks are automated messages sent to your server when something happens. You can use webhooks to subscribe to certain events on your account and automatically trigger reactions.
To enable webhooks for the datasets under your account, go to your account page and click the "Enable" button in the webhooks section. Then click the "Manage webhooks" button to add endpoints, subscribe to events, view and replay webhooks.
Every webhook is signed with a unique key for increased security. Please refer to these docs to verify and validate your incoming webhooks.
You can currently subscribe to following events:
Event type | Description |
| Occurs whenever a dataset is created. |
| Occurs whenever a dataset property has changed. |
| Occurs whenever a dataset is deleted. |
| Occurs whenever a sample is created. |
| Occurs whenever a sample property has changed. |
| Occurs whenever a sample is deleted. |
| Occurs whenever a label property has changed. |
| Occurs whenever a label is deleted. |
| Occurs whenever an issue is created. |
| Occurs whenever an issue has received a reply or a property has changed. |
| Occurs whenever a new release is successfully created. |
The webhook payload looks as follows:
Setting up a Slack integration with webhooks
This is a guided tutorial on how to set up a Slack integration using webhooks with Segments.ai. For more information, please refer to Slack's instructions.
Create a Slack app, enable incoming webhooks and create an endpoint URL in Slack
Create a Slack app, enable incoming webhooks and create an endpoint URL in Slack.
You'll be redirected to its settings page. From here, select the Incoming Webhooks feature and toggle on the Activate Incoming Webhooks.
Some extra options will now appear. In the bottom of the page, click the Add New Webhook to Workspace button and choose a channel.
You'll be sent back to your app settings, and you should now see a new Webhook URL entry with an endpoint URL formatted like
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
You've now created an endpoint URL for the incoming webhook, specific to a single user and a single channel.
Configure your webhooks in Segments.ai using the Slack endpoint URL
Go to your Segments.ai account page and click the "Enable" button in the webhooks section.
Click the green "Manage webhooks" button and you'll be taken to the webhook configuration page.
Add an endpoint and provide the following items in the configuration window:
The endpoint URL that you just created in the Slack settings
An optional version number and description
Which events to send notifications about to the Slack channel
The webhook integration is now set up.
You will start to receive notifications, but only for those events within datasets of which you're an owner.
Last updated