SendGrid Connector Setup Guide

This article describes how to set up the SendGrid connector.

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 the following permissions for the API Key:

    • Marketing Campaigns: Full Access
    • Mail Send: Full Access
    • Template Engine: Read Access

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.

Was this page helpful?

This page was last updated: November 10, 2021