Documentation
  • Introduction
  • Tutorials
    • Getting started
    • Python SDK quickstart
    • Model-assisted labeling
  • How to annotate
    • Label images
      • View and navigate in the image interfaces
      • Image interface settings
      • Image segmentation interface
      • Image vector interface
    • Label 3D point clouds
      • View and navigate in the 3D interface
      • Upload, view, and overlay images
      • 3D interface settings
      • 3D point cloud cuboid interface
      • 3D point cloud vector interface
      • 3D point cloud segmentation interface
      • Merged point cloud view (for static objects)
      • Batch mode (for dynamic objects)
      • Smart cuboid propagation
      • 3D to 2D Projection
      • Tips for labeling cuboid sequences
    • Label sequences of data
      • Use track IDs in sequences
      • Use keyframe interpolation
    • Annotate object links (beta)
    • Customize hotkeys
  • How to manage
    • Add collaborators to a dataset
    • Create an organization
    • Configure the label editor
    • Customize label queue
    • Search within a dataset
    • Clone a dataset
    • Work with issues
    • Bulk change label status
    • Manage QA processes
  • How to integrate
    • Import data
      • Cloud integrations
    • Export data
      • Structure of the release file
      • Exporting image annotations to different formats
    • Integrations
      • Hugging Face
      • W&B
      • Databricks
      • SceneBox
    • Create an API key
    • Upload model predictions
    • Set up webhooks
  • Background
    • Main concepts
    • Sequences
    • Label queue mechanics
    • Labeling metrics
    • 3D Tiles
    • Security
  • Reference
    • Python SDK
    • Task types
    • Sample formats
      • Supported file formats
    • Label formats
    • Categories and attributes
    • API
Powered by GitBook
On this page
  • Setting up a Slack integration with webhooks
  • Create a Slack app, enable incoming webhooks and create an endpoint URL in Slack
  • Configure your webhooks in Segments.ai using the Slack endpoint URL

Was this helpful?

  1. How to integrate

Set up webhooks

Listen for events on your account so your integration can automatically trigger reactions.

PreviousUpload model predictionsNextMain concepts

Last updated 1 year ago

Was this helpful?

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 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 to verify and validate your incoming webhooks.

You can currently subscribe to following events:

Event type

Description

dataset.created

Occurs whenever a dataset is created.

dataset.updated

Occurs whenever a dataset property has changed.

dataset.deleted

Occurs whenever a dataset is deleted.

sample.created

Occurs whenever a sample is created.

sample.updated

Occurs whenever a sample property has changed.

sample.deleted

Occurs whenever a sample is deleted.

label.updated

Occurs whenever a label property has changed.

label.deleted

Occurs whenever a label is deleted.

issue.created

Occurs whenever an issue is created.

issue.updated

Occurs whenever an issue has received a reply or a property has changed.

release.created

Occurs whenever a new release is successfully created.

The webhook payload looks as follows:

{
  "event_type": "sample.created",
  "created_at": "2021-08-09T14:40:19.987691+00:00",
  "api_version": "2021-08-01",
  "dataset": "jane/flowers",
  "object": { ... }, // The dataset, sample, label or issue that was created or updated.
  "text": "Sample rose.png created in dataset jane/flowers." // Text summary, useful for Slack integration.
}

Setting up a Slack integration with webhooks

Create a Slack app, enable incoming webhooks and create an endpoint URL in Slack

  1. Create a Slack app, enable incoming webhooks and create an endpoint URL in Slack.

  2. You'll be redirected to its settings page. From here, select the Incoming Webhooks feature and toggle on the Activate Incoming Webhooks.

  3. Some extra options will now appear. In the bottom of the page, click the Add New Webhook to Workspace button and choose a channel.

  4. You'll be sent back to your app settings, and you should now see a new Webhook URL entry with an endpoint URL formatted likehttps://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

  1. Click the green "Manage webhooks" button and you'll be taken to the webhook configuration page.

  2. 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.

This is a guided tutorial on how to set up a Slack integration using webhooks with . For more information, please refer to .

Go to your and click the "Enable" button in the webhooks section.

your account page
these docs
Segments.ai
Slack's instructions
Segments.ai account page