Build a Source

Sources send data into Segment, and serve as the origin for your data. Segment empowers companies of all sizes to use their customer data to grow their business. When you create a Segment source for your organization, you enable customers to use data from your tool wherever it’s most useful to them.

Get access and log in

Before you begin, you need access to the Developer Portal. To access the Developer portal:

1. Apply to become a Segment Select Partner.
2. Once approved, you’ll receive an invitation to join the Segment Developer Portal.
3. Log in to Segment, navigate to the User dropdown in the top right of the screen, and click Developer Portal.

Build the Source

1. Once in the Developer Portal, navigate to Integrations and click Build integration > Build a source

2. On the Source setup screen, enter a name and slug for your source, and click Create source.

3. From the Integrations screen, click on the source you just created. You should see your source in Private building status.

4. Select the Catalog info tab and add relevant metadata and catalog information for your source.

The code for your source should follow the format of Segment’s HTTP API.

Test your Source

1. From your source’s page in the Developer Portal, navigate to Settings > Add to workspace. From the dropdown, select the Segment workspace you’ll use to test your source, and click Add to workspace. The selected workspace will open in a new tab.

When the selected workspace opens in a new tab, with your source’s configuration page visible, copy the workspace ID, and add it to your source.

Use the Source Debugger to observe inbound data when you generate events in your source. For example, if your source sends email data to Segment, you should:

• Create an email campaign that includes one hyperlink and an unsubscribe option
• Send the email to yourself
• When you receive the email
  • Open it
  • Click the link
  • Unsubscribe

Check the Source Debugger to verify that the events arrive and are formatted according to the Segment Spec.

Launch your source

When you’ve verified that your source sends the correct information, submit it for review. The Segment team will review your source’s functionality, catalog metadata, and documentation. If your source is approved, it will appear in the Segment catalog, marked with a “beta” badge for a period of two weeks. After this period, the source is considered generally available.