# Integrate with Segment

> Kustomer provides features that allow you to dynamically add tracking events from Segment into customer timelines in real-time.

Source: https://help.kustomer.com/en_us/integrate-with-segment-SJIFqNHU

Last updated: 2024-10-21T14:13:40.383Z

Kustomer provides features that allow you to dynamically add tracking events from [Segment](https://segment.com/) into customer timelines in real-time.

**Who can access this feature?**

**User types**

Admins can set up this integration.

  

### In this article

*   [Prerequisites](#Prerequisites)
*   [Install the Segment app in Kustomer](#Install)
*   [Configure Kustomer in Segment](#Configure)
*   [Traits](#Traits)
*   [Track customer events](#Track)
*   [Beyond tracking events](#Beyond)

### Prerequisites

Before connecting Segment to Kustomer, you must have a Segment account and the desired sources configured and collecting data.

### Install the Segment app in Kustomer

To integrate Segment with Kustomer, install the Segment app from within the Kustomer App Directory.

1.  Go to **Apps**![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/c45966c96500a307a6e30471cc7262e9.png)and select **Explore Directory**.
2.  Search for **Segment** in the App Directory, and then select **Install**.

### Configure Kustomer in Segment

Once the app is installed, you need to configure your Kustomer organization in Segment. Once configured, your data will automatically be sent to your Kustomer organization. Customer records and tracking events will automatically be created in your count as data is sent to this new destination.

1.  Go to **Apps**![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/c45966c96500a307a6e30471cc7262e9.png)and select **Segment** in the sidebar.
2.  Copy the **Segment API key**.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/5d42287e72babbc853dff35f85953236.png)
3.  In another browser tab, sign in to your Segment account.
4.  Select **Catalog** in the left navigation bar and then select the **Destinations** tab.
5.  Search for Kustomer in the field provided.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/2870cddda093a8a8568f85fdde24d9b7.png)
6.  Select the **Kustomer** card and then select **Configure Kustomer**.
7.  Select a source from the list and then select **Confirm Source**.
8.  Select **API Key** in Connection Settings to edit it.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/7dea91f41ca691643cbdf2c0117db775.png)
9.  Paste the Kustomer Segment API key into the text field, then select **Save**.
10.  Leave the Segment site open. Return to Kustomer in your other browser tab, and in the Segment App Settings copy the **Org Pod** to your clipboard.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/6fe5cf27922a62008660d40c1e3543dd.png)
11.  Back on the Segment site, select **Org Pod** in the Connection Settings.
12.  Paste the Org Pod from the Kustomer settings into the text field, then select **Save**.

### Traits

Most traits are mapped to an appropriate customer Standard Object (KObject) attribute in Kustomer. For more details, see [Segment’s Traits](https://segment.com/docs/spec/identify/#traits) documentation. 

In addition to the Segment traits, the following properties are automatically mapped together:

*   Segment userId -> **Kustomer externalId**
*   Segment context.locale -> **Kustomer locale**

### Track customer events

The `kustomer_session_id` is an optional string that identifies a session within your application. Kustomer groups tracking events within a single session as one item within a customer’s timeline. If a `kustomer_session_id` is not supplied, Kustomer will automatically generate session ids based on time between tracking events. [Learn more about why Segment doesn't offer session tracking.](https://segment.com/blog/facts-vs-stories-why-segment-has-no-sessions-api/)

### Beyond tracking events

If basic tracking events do not satisfy your needs, it’s possible to create a custom [webhook](https://help.kustomer.com/understanding-hooks-Bkqc1z3fM) in Kustomer and use Workflows to create custom objects (KObjects), publish events, create or update customers, and more.