Segment Profiles Destination

Destination Info

The Segment Profiles destination allows you to send your warehouse data back to Segment to create and update Profiles that can then be accessed through Profile API and activated within Twilio Engage.

This destination supports connections from Reverse ETL warehouse sources, and is not compatible with other source types.

Getting started

Create a Profile space

To use this destination, you must have an active Segment Profile space. If you have not yet created a Segment Profile space, please follow the steps in the Profiles Onboarding Guide.

Connect and configure the Segment Profiles destination

  1. From the Segment web app, navigate to Reverse ETL > Destinations.
  2. Click Add Destination.
  3. Select the Segment Profiles destination, click Next, and select the warehouse source that will send data to the Segment Profiles destination. If you have not set up a warehouse source, follow the steps in the Reverse ETL documentation on Getting started.
  4. On the Settings tab, name your destination, select an endpoint region, and click Save Changes. It is recommended to configure and enable all mappings before enabling the Segment Profiles destination.
  5. On the Mappings tab, click Add Mapping. Select a data model and the API call type you want to map. Identify calls will create and update user profiles and Group calls will create and update account profiles. Fill in the fields on screen to create the desired mappings, and click Create Mapping to complete the configuration. Repeat this step to configure multiple mappings.
  6. Enable the configured mapping(s).
  7. On the Settings tab, click the Enable Destination toggle, and then click Save Changes to enable the Segment Profiles destination.

Available Actions

Build your own Mappings. Combine supported triggers with the following Segment Profiles-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Send Group

Send a group call to Segment’s tracking API. This is used to associate an individual user with a group

Send Group is a Cloud action. The default Trigger is: type = "group"

Click to show / hide fields

Field Description
Profile Space* Type: STRING

The Profile Space to use for creating a record. Note: This field shows list of internal sources associated with the Profile Space. Changes made to the Profile Space name in Settings will not reflect in this list unless the source associated with the Profile Space is renamed explicitly.

User ID Type: STRING

Unique identifier for the user in your database. A userId or an anonymousId is required.

Anonymous ID Type: STRING

A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required.

Group ID* Type: STRING

The group or account ID a user is associated with.

Traits Type: OBJECT

Free-form dictionary of traits that describe the user or group of users.

Timestamp Type: DATETIME

The timestamp of the event.

MessageId Type: STRING

The Segment messageId.

Send Identify

Send an identify call to Segment’s tracking API. This is used to tie your users to their actions and record traits about them.

Send Identify is a Cloud action. The default Trigger is: type = "identify"

Click to show / hide fields

Field Description
Profile Space* Type: STRING

The Profile Space to use for creating a record. Note: This field shows list of internal sources associated with the Profile Space. Changes made to the Profile Space name in Settings will not reflect in this list unless the source associated with the Profile Space is renamed explicitly.

User ID Type: STRING

Unique identifier for the user in your database. A userId or an anonymousId is required.

Anonymous ID Type: STRING

A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required.

Group ID Type: STRING

The group or account ID a user is associated with.

Traits Type: OBJECT

Free-form dictionary of traits that describe the user or group of users.

Timestamp Type: DATETIME

The timestamp of the event.

MessageId Type: STRING

The Segment messageId.

Send Subscriptions

Send an identify call to Segment’s tracking API. This is used to get user channel subscription data into Engage.

Send Subscriptions is a Cloud action. The default Trigger is: type = "identify"

Click to show / hide fields

Field Description
Profile Space* Type: STRING

The Profile Space to use for creating a record. Note: This field shows list of internal sources associated with the Profile Space. Changes made to the Profile Space name in Settings will not reflect in this list unless the source associated with the Profile Space is renamed explicitly.

User ID Type: STRING

Unique identifier for the user in your database.

Anonymous ID Type: STRING

A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier.

Email Type: STRING

Email of the user

Email Subscription Status Type: STRING

Global status of the email subscription. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

Email Subscription Groups Type: OBJECT

Group Subscription statuses are supported for the email channel. This object contains group names as keys and statuses as values. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

Phone Type: STRING

Phone number of the user

SMS Subscription Status Type: STRING

Global status of the SMS subscription. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

WhatsApp Subscription Status Type: STRING

Global status of the WhatsApp subscription. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

Android Push Token Type: STRING

Android Push Token of the user

Android Push Subscription Status Type: STRING

Global status of the android push subscription. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

Ios Push Token Type: STRING

Ios Push Token of the user

Ios Push Subscription Status Type: STRING

Global status of the ios push subscription. True is subscribed, false is unsubscribed, and did_not_subscribe is did_not_subscribe.

Traits Type: OBJECT

Free-form dictionary of traits that describe the user or group of users.

Timestamp Type: DATETIME

The timestamp of the event.

MessageId Type: STRING

The Segment messageId.

Send Track

Send a track call to Segment’s tracking API. This is used to record actions your users perform.

Send Track is a Cloud action.

Click to show / hide fields

Field Description
Profile Space* Type: STRING

The Profile Space to use for creating a record. Note: This field shows list of internal sources associated with the Profile Space. Changes made to the Profile Space name in Settings will not reflect in this list unless the source associated with the Profile Space is renamed explicitly.

User ID Type: STRING

Unique identifier for the user in your database. A userId or an anonymousId is required.

Anonymous ID Type: STRING

A pseudo-unique substitute for a User ID, for cases when you don’t have an absolutely unique identifier. A userId or an anonymousId is required.

Timestamp Type: DATETIME

The timestamp of the event.

Event Name* Type: STRING

Name of the action that a user has performed.

Group ID Type: STRING

The group or account ID a user is associated with.

Properties Type: OBJECT

Free-form dictionary of properties that describe the event.

MessageId Type: STRING

The Segment messageId.

FAQ & Troubleshooting

API Calls and MTUs

The Segment Profiles destination is not subject to API call or MTU costs. Any users or accounts created and updated by the Segment Profiles destination will not count towards your API call or MTU usage.

Succesful syncs but no changes on profiles

Make sure that the Endpoint Region setting matches the region of your workspace. If the region is correct and you don’t see any profile changes, contact Segment.

Test Mapping

The Test Mapping feature on the Mapping page does not send events to Profiles. It will only validate the mappings and confirm that the event will be accepted by the Tracking API. To send and validate the event in profile, please run a RETL sync.

This page was last modified: 08 Feb 2024



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account