|
| 1 | +--- |
| 2 | +title: Segment Profiles Destination |
| 3 | +hide-boilerplate: true |
| 4 | +hide-dossier: false |
| 5 | +id: 639c2dbb1309fdcad13951b6 |
| 6 | +--- |
| 7 | +The Segment Profiles destination allows you to send your warehouse data back to Segment to create and update [Profiles](/docs/profiles/) that can then be accessed through [Profile API](/docs/profiles/profile-api/) and activated within [Twilio Engage](/docs/engage). |
| 8 | + |
| 9 | +> success "Source compatibility" |
| 10 | +> This destination supports connections from Reverse ETL warehouse sources, and is not compatible with other source types. |
| 11 | +
|
| 12 | +> info "" |
| 13 | +> The Segment Profiles destination is in beta and is in active development. Some functionality may change before it becomes generally available. |
| 14 | +
|
| 15 | +## Getting started |
| 16 | + |
| 17 | +### Create a Profile space |
| 18 | + |
| 19 | +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](/docs/profiles/quickstart/). |
| 20 | + |
| 21 | +### Create a Public API token |
| 22 | + |
| 23 | +To enable the Segment Profiles destination to send data to an existing Profile space, provide an authentication token for the Segment Public API. See [Segment's Public API documentation](https://docs.segmentapis.com/tag/Getting-Started#section/Get-an-API-token){:target="_blank"} for information on how to create a token. The token must include Source Admin permissions. You will need this token in the below steps. |
| 24 | + |
| 25 | +### Connect and configure the Segment Profiles destination |
| 26 | + |
| 27 | +1. From the Segment web app, navigate to **Reverse ETL > Destinations**. |
| 28 | +2. Click **Add Destination**. |
| 29 | +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](/docs/reverse-etl/#getting-started). |
| 30 | +4. On the **Settings** tab, name your destination, input the Public API token created above, select an endpoint region, and click **Save Changes**. It is recommended to configure and enable all mappings before enabling the Segment Profiles destination. |
| 31 | +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. |
| 32 | +6. Enable the configured mapping(s). |
| 33 | +7. On the **Settings** tab, click the **Enable Destination** toggle, and then click **Save Changes** to enable the Segment Profiles destination. |
| 34 | + |
| 35 | +{% include components/actions-fields.html settings="true"%} |
| 36 | + |
| 37 | +## FAQ & Troubleshooting |
| 38 | + |
| 39 | +### API Calls and MTUs |
| 40 | +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. |
0 commit comments