# SendGrid Marketing Campaigns Destination

## About this integration

Twilio SendGrid provides email marketing automation for businesses. This integration helps you add contacts and lists to SendGrid Marketing Campaigns based on the people you identify and the events they perform in your sources.

[Mode How we forward source data to the destination: through Customer.io's servers or directly from our JavaScript client.](/cdp/destinations/getting-started/#connection-mode)

[Web sources Indicates whether or not this integration supports our the JavaScript client.](/cdp/sources/getting-started/#types-of-sources)

[API sources Indicates whether or not this integration supports our server libraries (Go, NodeJS, Python), API, Mobile SDK, and other data sources.](/cdp/sources/getting-started/#types-of-sources)

[Supported calls The API methods this integration supports.](/cdp/sources/source-spec/source-events/)

[Integration name The name of this integration if you want to enable or disable it in the `integrations` object.](/cdp/sources/source-spec/common-fields/#the-integrations-object)

Standard

N/A

SendGrid Marketing Campaigns

## Getting started[](#getting-started)

1.  Go to **[Data & Integrations > Integrations](https://fly.customer.io/workspaces/last/journeys/integrations/all/directory)** and select the **SendGrid Marketing Campaigns** entry in the *Directory* tab.
    
2.  (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We’ll only show you data sources that work with your integration.
    
3.  Configure your integration.
    
    1.  **Send Grid Api Key**: The Api key for your SendGrid account.
4.  Click **Enable Destination**.
    

## Actions[](#actions)

When you’re done setting things up, you can go to the *Actions* tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our [actions](/integrations/data-out/actions/) page for help setting up actions.

Action

Default Trigger

Description

Upsert Contact

Add or update a Contact in SendGrid.

## Recording Custom User Traits[](#recording-custom-user-traits)

If you want to see custom user traits in the SendGrid Marketing Campaigns dashboard, you’ll need to create [Custom Fields inside the Marketing Campaigns’s UI](https://www.twilio.com/docs/sendgrid/ui/managing-contacts/custom-fields). You don’t need to map all traits this way; you only need to create *Custom Fields* for traits that you want to see in your SendGrid list view.

## Custom Fields[](#custom-fields)

You need to create fields in SendGrid Marketing Campaigns for each trait you want to send from your source data. If you map individual keys in your actions to Sendgrid, the *key* must match the field name in SendGrid Marketing Campaigns. If you send all `$.traits` to SendGrid Marketing Campaigns, you must create a matching field in SendGrid for each trait.

## Recording userId[](#recording-userid)

To record a `userId` in SendGrid Marketing Campaigns, you must pass the `userID` as a trait on your identify() calls. SendGrid does not automatically map the `userID` to Marketing Campaigns properties.