Skip to content

Commit 2a08f01

Browse files
Merge pull request #7307 from segmentio/sendgrid-send-email-action
[Sendgrid] - Doc update for new Sendgrid send email Action
2 parents 944c25b + 651a98a commit 2a08f01

File tree

1 file changed

+28
-10
lines changed
  • src/connections/destinations/catalog/actions-sendgrid

1 file changed

+28
-10
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: SendGrid Marketing Campaigns Destination
2+
title: SendGrid Destination
33
hide-boilerplate: true
44
hide-dossier: true
55
redirect_from:
@@ -11,28 +11,46 @@ hide_action:
1111
---
1212

1313

14-
[SendGrid Marketing Campaigns](https://sendgrid.com/solutions/email-marketing/){:target="_blank”} provides email marketing automation for businesses. With Segment you can add contacts and lists to SendGrid Marketing Campaigns.
14+
[SendGrid](https://sendgrid.com/solutions/email-marketing/){:target="_blank”} provides email marketing automation for businesses. With Segment you can add contacts and lists to SendGrid.
1515

1616
## Getting started
1717

1818
1. From the Segment web app, click **Catalog**, then click **Destinations**.
1919
2. Find the Destinations Actions item in the left navigation, and click it.
20-
3. Click **Configure SendGrid Marketing Campaigns**.
21-
4. Select an existing Source to connect to SendGrid Marketing Campaigns (Actions).
22-
5. 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.](https://docs.sendgrid.com/ui/account-and-settings/api-keys){:target="_blank"}
20+
3. Click **Configure SendGrid**.
21+
4. Select an existing Source to connect to SendGrid.
22+
5. In the destination settings, enter your SendGrid “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.](https://docs.sendgrid.com/ui/account-and-settings/api-keys){:target="_blank"}
2323

2424

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

27+
## Additional details for the Send Email With Dynamic Template Action
2728

28-
## Recording Custom User Traits
29+
### Usage
30+
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.
31+
32+
### Contacts
33+
SendGrid sends emails to the email addresses you specify, even if they are not listed as Contacts in SendGrid.
34+
35+
### SendGrid API Key
36+
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:
37+
- Category Management: full
38+
- IP Management: full
39+
- Template Engine: full
40+
41+
## Additional details for the Upsert Contact Action
42+
43+
### Recording Custom User Traits
2944
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.
3045

31-
## Custom Fields
46+
### Custom Fields
3247
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.
3348

34-
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.
49+
For any other custom traits just add a Custom Field inside of SendGrid with a tag that matches the key you are using in your identify call.
3550

51+
### Recording userId
52+
To record a Segment userId in SendGrid, 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.
3653

37-
## Recording userId
38-
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.
54+
### SendGrid API Key
55+
The Upsert Contact Action requires the SendGrid API Key to have the following scopes:
56+
- Marketing: full

0 commit comments

Comments
 (0)