This article describes how to set up the SendGrid connector.

In this article:

Connector Actions

Action Name AudienceStream EventStream
Upsert Contact
Remove Contact
Send Email

Configure Settings

Go to the Connector Marketplace and add a new connector. See the Connector Overview for general instructions on how to add a connector.

After adding the connector, configure the following settings:

  • API Key
    API Key for SendGrid Connector to use. This connector requires Marketing Campaigns 'Full Access', Mail Send 'Full Access', and Template Engine 'Read Access' for the API Key. For more information on SendGrid API Keys please view the following documentation: SendGrid API Keys.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Upsert Contact


Parameter Description
Address Line 1  
Address Line 2  
Alternate Emails  
Email (Required)
First Name  
Last Name  
Postal Code  
State Province Region  
Contact List Ids Optional: List Ids. An array of List ID strings that this contact will be added to.

Action - Remove Contact


Parameter Description
Contact Id  

Action - Send Email


Parameter Description
Name (Required)
Send At  
Send To All  
Custom Unsubscribe Url  
Generate Plain Content  
HTML Content  
Ip Pool  
Plain Content  
Categories Optional: Categories. The categories to associate with this Single Send. Max items 10.
Contact List Ids Optional: Contact List Ids. The recipient List IDs that will receive the Single Send. Max items 10.
Segments Optional: Segments. The recipient Segment IDs that will receive the Single Send. Max items 10.
Design Id Optional: Design Id. A Design Id can be used in place of Html Content, Plain Content, and/or subject.
Sender Id Optional: Sender Id. The ID of the verified Sender.
Suppression Group Id Optional: Suppression Group Id. The ID of the Suppression Group to allow recipients to unsubscribe — you must provide this or the Custom Unsubscribe Url.