Skip to main content

Segment integration

You can set up Dopt as a destination for Segment identify and group calls by using WebHooks as a destination.

Setting up the integration​

Step 1: Add webhook destination​

Log in to your Segment account, open workspace, and select source. Click on Add Destination and search and select Webhooks.

Step 2: Edit settings​

Enter Dopt details under the Settings tabs in your newly created destination, then modify the connection setting and other settings as shown.

Step 3a: Edit connection settings​

In Connection Settings:

Enter Webhook URL as: https://users.dopt.com/identify/segment

In Headers, specify the header key as: x-api-key

In the value field, paste the API key you received from https://app.dopt.com/

Step 3b: Edit other settings​

In the Other Settings → Webhook URL specify the same Dopt Webhook URL: https://users.dopt.com/identify/segment

Step 4: Enable the destination​

Enable the destination on Segment and monitor the events being sent from Segment to Dopt.

Once successfully sent you can also verify identified users in Dopt on the users page.

Dopt destination event format expectations​

Here’s what Dopt expects from Segment and how we handle exceptions:

Event types​

We currently support receiving identify and group events. If you have other types of events (like track) you can filter the events Segment sends us (requires Segment Business). If you send us other types of events you’ll get a server error back. We use userId and groupId from Segment's identify and group specs to map to user identifier and group identifier respectively in Dopt.

Nested traits​

Traits can have string, integer, boolean, or null values. Dopt doesn’t accept traits with nested objects as values.

Dopt Users API docs​

You can see Dopt's users API docs here: https://dopt.readme.io/

References​

https://segment.com/docs/connections/destinations/catalog/webhooks/.