SendGrid Marketing Campaigns Destination
SendGrid Marketing Campaigns provides email marketing automation for businesses. With Segment you can add contacts and lists to SendGrid Marketing Campaigns.
Getting started
- From the Segment web app, click Catalog, then click Destinations.
- Find the Destinations Actions item in the left navigation, and click it.
- Click Configure SendGrid Marketing Campaigns.
- Select an existing Source to connect to SendGrid Marketing Campaigns (Actions).
- In the destination settings, enter your SendGrid Marketing Campaigns “API key” into the connection settings. You should create a new API key for the Segment destination. You can read more about API keys on Marketing Campaigns’s docs.
Destination Settings
| Setting | Description |
|---|---|
| API Key | Required. The Api key for your SendGrid account. |
Available Actions
Build your own Mappings. Combine supported triggers with the following SendGrid Marketing Campaigns-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Upsert Contact
Add or update a Contact in SendGrid.
Upsert Contact is a Cloud action.
| Field | Description |
|---|---|
| Batch Data to SendGrid Contacts PUT API | Type: BOOLEANWhen enabled, the action will use the SendGrid Contacts PUT API to perform the batch operation. Batches can contain up to 30k records in a request. |
| First Name | Type: STRINGThe contact’s first name. |
| Last Name | Type: STRINGThe contact’s last name. |
| Country | Type: STRINGThe contact’s country. |
| Postal Code | Type: STRINGThe contact’s postal code. |
| City | Type: STRINGThe contact’s city. |
| State | Type: STRINGThe contact’s state. |
| Address Line 1 | Type: STRINGThe contact’s address line 1. |
| Address Line 2 | Type: STRINGThe contact’s address line 2. |
| Phone Number | Type: STRINGThe contact’s phone number. Note: This is different from the Phone Number ID field, but the same value can be stored in both fields. |
Type: STRINGThe contact’s WhatsApp. |
|
| Line | Type: STRINGThe contact’s landline. |
Type: STRINGThe contact’s Facebook identifier. |
|
| Unique Name | Type: STRINGThe contact’s unique name. |
| Email Address | Type: STRINGThe contact’s email address. |
| Phone Number ID | Type: STRINGPrimary Phone Number used to identify a Contact. This must be a valid phone number. |
| External ID | Type: STRINGThe contact’s External ID. |
| Anonymous ID | Type: STRINGThe contact’s Anonymous ID. |
| Other Fields | Type: OBJECTAdditional fields to send to SendGrid. On the left-hand side, input the SendGrid Custom Fields Id. On the right-hand side, map the Segment field that contains the value. Custom Fields must be predefined in your SendGrid account and you can retrieve corresponding Id using get all field definitions endpoint. Reference: Get All field definitions — |
Recording Custom User Traits
If you want to view any other custom user traits in the Marketing Campaigns list dashboard, you must create a Custom Field inside Marketing Campaigns’s UI of the traits in your identify calls. Note that you do not need to map all user.traits you are sending inside Marketing Campaigns. You only need to create Custom Fields of the traits you want to see in your list view.
Custom Fields
To send custom fields/user traits to Marketing Campaigns you need to create the field first in Marketing Campaigns for each trait you want sent to Marketing Campaigns. Then when you call identify with keys that match those traits they will appear in your Marketing Campaigns list.
For any other custom traits just add a Custom Field inside of SendGrid Marketing Campaigns with a tag that matches the key you are using in your identify call.
Recording userId
To record a Segment userId in SendGrid Marketing Campaigns, you must pass the userID as a trait on your identify() calls. SendGrid does not automatically map the Segment userID to any Marketing Campaigns properties.
This page was last modified: 06 Dec 2023
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!