Skip to content
Merged
Changes from 11 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 23 additions & 4 deletions src/connections/destinations/catalog/actions-sendgrid/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,34 @@ id: 631a6f32946dd8197e9cab66

{% include components/actions-fields.html %}

## Additional details for the Send Email With Dynamic Template Action

## Recording Custom User Traits
### Usage
The [Send Email With Dynamic Template](#send-email-with-dynamic-template) Action can be used to send emails through SendGrid using [SendGrid Dynamic Templates](https://www.twilio.com/docs/sendgrid/ui/sending-email/how-to-send-an-email-with-dynamic-templates){:target="_blank”}. The Dynamic Template you use must already exist in SendGrid. Use the Action field [Dynamic Template Data](#dynamic-template-data) to populate values in the Dynamic Template.

### Contacts
SendGrid sends emails to the email addresses you specify, even if they are not listed as Contacts in SendGrid Marketing Campaigns.

### Sendgrid API Key
Segment and SendGrid recommend that you define the SendGrid API key within a subuser account and the domain is authenticated under that same subuser account. The Send Email With Dynamic Template Action requires that the SendGrid API Key has the following scopes assigned:
- Category Management: full
- IP Management: full
- IP Management: full
- Template Engine: full

## Additional details for the Upsert Contact Action

### 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](https://docs.sendgrid.com/ui/managing-contacts/custom-fields#creating-custom-fields){:target="_blank"} 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
### 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
### 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.

### SendGrid API Key
The Upsert Contact Action requires the SendGrid API Key to have the following scopes:
- Marketing: full