--- title: "Segment integration: send Userflow events to Segment and receive data from it" slug: "segment" description: "Integrate Userflow with Segment to connect data sources and destinations, ensuring seamless event tracking and user attribute management across environments." tags: ["Third-Party Integrations", "Segment Data", "Userflow Integration", "Event Streaming"] updated: 2026-11-13T16:34:51Z published: 2026-11-13T16:34:51Z canonical: "help.userflow.com/segment" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://help.userflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Segment integration: send Userflow events to Segment and receive data from it The Segment integration lets Userflow work as both a Segment source and a Segment destination. As a source, Userflow streams its events into Segment so they can be forwarded to your other tools. As a destination, Segment sends user attributes and events from your other sources into Userflow. Setting up the Segment integration has three parts. Do them in this order: 1. [Set up the Segment integration in Userflow](/docs/segment#set-up-the-segment-integration-in-userflow) 2. [Add Userflow as a source in Segment](/docs/segment#add-userflow-as-a-source-in-segment) 3. [Add Userflow as a destination in Segment](/docs/segment#add-userflow-as-a-destination-in-segment) ## Why does the Segment integration use an HTTP API source and webhooks? Segment stopped accepting new web plugin integrations in late 2019, so Userflow can’t appear as a regular Segment integration. Instead, the Segment integration uses Segment’s standard **HTTP API** source and **Webhooks** destination. This also means you install [Userflow.js](https://help.userflow.com/docs/userflowjs-installation) in your front end yourself; Segment doesn’t load it for you. We recommend a dedicated HTTP API source for Userflow. Don’t reuse its Segment Write Key for anything else. ## Do I need a separate Segment integration for Staging and Production? Yes. Each Segment integration connects one Userflow environment to one Segment source and destination. Use separate Segment sources and destinations for each of your [Userflow environments](https://help.userflow.com/docs/environments-and-versions), such as Production and Staging, so Staging data doesn’t mix with Production data. If you have both, complete all three parts once for each. **We strongly recommend** connecting Staging first and checking that it works before you connect Production. ## Use the same user ID in Segment and Userflow The Segment integration matches users by user ID. Identify each user with the same ID in Segment and in Userflow, or the data won’t line up. ## Set up the Segment integration in Userflow 1. [Sign in to Userflow](https://userflow.com/app) and switch to the environment you want to connect to Segment. ![Environment picker in Userflow](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-go-to-env(2).png) 2. Go to **Settings → Integrations** and click **Add integration**. ![Add integration button in Userflow Settings → Integrations](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-add-integration(2).png) 3. Find and click **Segment** in the list. ![Segment in the Userflow integrations list](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-find-segment.png) 4. Click **Add Segment**. ![Add Segment button](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-add-segment.png) If you don’t see **Add Segment**, the integration may not be included in your plan. Check your [billing settings](https://app.userflow.com/app/_/settings/billing). When this is done, continue with [Add Userflow as a source in Segment](/docs/segment#add-userflow-as-a-source-in-segment). ## Add Userflow as a source in Segment Adding Userflow as a Segment source streams [Userflow-generated events](https://help.userflow.com/docs/userflow-generated-events), such as **Flow Started** and **Checklist Task Completed**, into Segment. [Set up the Segment integration in Userflow](/docs/segment#set-up-the-segment-integration-in-userflow) first. 1. [Sign in to Segment](https://app.segment.com/login/) and click **Add Source**. ![Add Source in Segment](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-go-to-sources.png) 2. Search for and click **HTTP API**. ![HTTP API source in the Segment catalog](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-select-http-api.png) 3. Click **Add Source**. ![Add Source button for the HTTP API source](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-add-source.png) 4. Give the source a name, such as “Userflow”, and click **Add Source**. ![Naming the HTTP API source](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-setup.png) 5. Copy the **Write Key**. ![Write Key for the HTTP API source](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-copy-key.png) 6. In Userflow, go to **Settings → Integrations → Segment**. Paste the Write Key into the **Segment Write Key** field and click **Save**. ![Segment Write Key field in Userflow](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-paste-key.png) 7. Click the **Stream events from Userflow to Segment** switch and confirm in the dialog. ![Stream events from Userflow to Segment switch](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-enable-streaming(2).png) 8. Streaming starts immediately. ![Event streaming turned on for Segment](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-done(2).png) 9. In Segment, open the **Debugger** tab and check that Userflow events are coming in. They usually appear within a few seconds. ![Userflow events in the Segment Debugger](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-source-debugger.png) When this is done, continue with [Add Userflow as a destination in Segment](/docs/segment#add-userflow-as-a-destination-in-segment). ## How do I stop streaming Userflow events to Segment? 1. In Userflow, go to **Settings → Integrations** and open **Segment**. 2. Check the **Stream events from Userflow to Segment** switch. Gray means streaming is already off. Green means it’s on. 3. Click the switch and confirm in the dialog. Event streaming to Segment stops immediately. ## Add Userflow as a destination in Segment Adding Userflow as a Segment destination sends user attributes and events from your other Segment sources into Userflow. [Set up the Segment integration in Userflow](/docs/segment#set-up-the-segment-integration-in-userflow) first. 1. [Sign in to Userflow](https://userflow.com/app), go to **Settings → Integrations → Segment**, and copy the **Webhook URL**. ![Webhook URL in Userflow’s Segment settings](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-copy-webhook-url.png) 2. [Sign in to Segment](https://app.segment.com/login/) and click **Add Destination**. ![Add Destination in Segment](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-go-to-destinations.png) 3. Search for and click **Webhooks**. ![Webhooks destination in the Segment catalog](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-find-webhooks.png) 4. Click **Configure Webhooks**. ![Configure Webhooks button](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-configure-webhooks.png) 5. Select the sources you want to send to Userflow. Usually this is a separate source for your back end. ![Selecting sources for the Webhooks destination](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-select-source.png) 6. Click **Confirm Source**. ![Confirm Source button](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-confirm-source.png) 7. Click **Webhooks**. ![Webhooks settings for the destination](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-go-to-webhooks.png) 8. Paste the Webhook URL from Userflow into the **Webhook URL** field and click **Save**. ![Webhook URL field in the Segment Webhooks destination](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-paste-url.png) 9. Click the toggle to turn on the destination. ![Turning on the Webhooks destination](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/segment-destination-enable.png) 10. In Userflow, go to **Users** and check that users and events from Segment are coming in. ## Send company events from Segment to Userflow This only applies if you use [companies](https://help.userflow.com/docs/companies) in Userflow. Segment doesn’t link events to companies directly. A common workaround is an event property that names the company, such as `company_id` or `workspace_id`. Userflow can read that property and attach each event to the right company. 1. [Sign in to Userflow](https://userflow.com/app) and go to **Settings → Integrations → Segment**. 2. Enter the name of your company event property and click **Save**. ![Company event property field in Userflow’s Segment settings](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/userflow-group-event-attribute-name.png) ## Related articles - [Rudderstack integration](https://help.userflow.com/docs/rudderstack): uses this same setup with a custom API URL - [Userflow-generated events](https://help.userflow.com/docs/userflow-generated-events) - [Configuring companies](https://help.userflow.com/docs/companies) - [Userflow.js Installation](https://help.userflow.com/docs/userflowjs-installation) - [Integrations](https://help.userflow.com/docs/integration-old) A persistent list of tasks or items that users can follow to ensure completion of techniques, often used for onboarding, setup, or feature adoption.