Segment Integration

Creating a SendGrid Marketing Campaigns Event Source in Segment allows you to automatically stream your email events directly into Segment to help you get a unified view of customer interactions. For example, you can associate email opens and link clicks with your customers in Segment.

To send SendGrid events to Segment, you first create a new Source in your Segment account, and then you create an Integration to Segment in your SendGrid account.

Learn more about email events and Segment Sources:

• SendGrid email events and what they indicate about users' engagement.
• Segment Sources.

First, in your Segment account, add Marketing Campaigns as a Source:

1. Navigate to the Sources page of your Segment workspace.
2. If you have no sources configured, click Add source. If you already have sources configured, click Add More.
3. Search for SendGrid Marketing Campaigns and click the SendGrid Marketing Campaigns tile.
4. Click Add source.
5. Give your Source a descriptive name to help you identify the Source in your workspace, such as "SendGrid Marketing Campaigns", and add any labels that may help you organize your workspace. Then, click Add source.
6. Copy the Write Key from the Overview tab of your new Source. You will use this when completing the Integration in your SendGrid Marketing Campaigns account in the next section.

Next, in your SendGrid account, add Segment as an Integration:

1. Navigate to the Integrations page of the Marketing Campaigns Console.
2. From the Explore Apps tab, find the Segment tile and click Connect.
3. Give your Integration a descriptive name, such as "Segment".
4. Paste the write key that you copied from your Segment Source in the section above.
5. Select the region you would like to sync your events to.
   • Ensure the region you select aligns with the region of the Segment workspace in which you configured the Source, otherwise your email events won't sync to Segment. Unless you have specifically requested a Segment workspace in the EU, the region is "US".
6. Select the email events you would like to sync to Segment and then click Add integration.

SendGrid Marketing Campaigns is also available as a Segment Action Destination. In this case, Segment acts as the Source that sends data downstream into Marketing Campaigns.

The Actions that are currently supported as part of this Action Destination are:

• Contact Upsert: Add or update a Contact in SendGrid

For more information about this Action Destination and the data available to send, see SendGrid Marketing Campaigns Destination.

Before you connect Segment to your SendGrid Marketing Campaigns as a Destination, you need:

• A Segment account.
• A SendGrid API Key.
  • The minimum access needed for the key is Restricted Access with Full Access granted for the permissions listed under "Marketing"
  • It will also work with Full Access, but a key with Full Access allows API access to all parts of your account except billing and email address validation.
  • Make sure to copy the API key to use in the following setup steps.

It is also recommended to have a SendGrid Marketing Campaigns Source in Segment.

When you have the above prerequisites, complete the following steps:

1. Navigate to the Destinations page of your Segment workspace.
2. If you have no Destinations configured, click Add destination. If you already have Destinations configured, click Add More.
3. Search for "SendGrid Marketing Campaigns" and click the SendGrid Marketing Campaigns (Actions) tile. (Be sure to click the tile that is under Destinations and that specifies Actions in the title.)
4. Click Add Destination.
5. Select the Source you would like to connect to this Destination and then click Next.
6. Give your Destination a descriptive name to help you identify what it is (for example, "SendGrid Marketing Campaigns Actions instance"), and select how you would like to set up the Destination, and then click Add destination.
7. In the Destination settings, paste the SendGrid API Key you created into the connection settings. Click Save Changes.