You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-sendgrid/index.md
+16-9Lines changed: 16 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,19 +21,22 @@ id: 631a6f32946dd8197e9cab66
21
21
22
22
{% include components/actions-fields.html %}
23
23
24
-
## Using the 'Send email with Dynamic Template' Action
24
+
## Additional details for the 'Send email with Dynamic Template' Action
25
25
26
-
### Capabilities
27
-
This Action can be used to send emails to Contacts in Sendgrid using [Sendgrid Dynamic Templates](https://www.twilio.com/docs/sendgrid/ui/sending-email/how-to-send-an-email-with-dynamic-templates). The Dynamic Template being used must already exist in Sendgrid. Use the Action field named 'Dynamic Template Data' to populate values in the Dynamic Template.
26
+
### Usage
27
+
The 'Send email with Dynamic Template' Action can be used to send emails via Sendgrid using [Sendgrid Dynamic Templates](https://www.twilio.com/docs/sendgrid/ui/sending-email/how-to-send-an-email-with-dynamic-templates). The Dynamic Template being used must already exist in Sendgrid. Use the Action field named 'Dynamic Template Data' to populate values in the Dynamic Template.
28
28
29
-
### Contacts are not required
30
-
Emails will be sent to the specified email address even if it is not listed as a Contact in SendGrid Marketing Campaigns.
29
+
### Contacts
30
+
Emails will be sent to the specified email addresses, even if they are not listed as Contacts in SendGrid Marketing Campaigns.
31
31
32
-
### Sendgrid API Key permissions
32
+
### Sendgrid API Key
33
+
Segment and SendGrid recommend defining the SendGrid API key within a subuser account and ensuring the domain being used is authenticated under that same subuser account. The 'Send email with Dynamic Template' Action requires the Sendgrid API Key to have the following scopes assigned:
34
+
1. Category Management: full
35
+
2. IP Management: full
36
+
3. IP Management: full
37
+
4. Template Engine: full
33
38
34
-
TODO - Dustin to explain what types of permissions the API Key needs here
35
-
36
-
## Using the 'Upsert Contact' Action
39
+
## Additional details for the 'Upsert Contact' Action
37
40
38
41
### Recording Custom User Traits
39
42
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.
@@ -45,3 +48,7 @@ For any other custom traits just add a Custom Field inside of SendGrid Marketing
45
48
46
49
### Recording userId
47
50
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.
51
+
52
+
### Sendgrid API Key
53
+
The 'Upsert Contact' Action requires the Sendgrid API Key to have the following scopes assigned:
0 commit comments