Send Email
Send an email using SendGrid.
Options
Field | Definition | Type | Required |
---|---|---|---|
Use Template? |
Indicates whether to use an email template. If set to Yes, the Template ID and Dynamic Template Data fields are added as inputs.
If set to No, the Subject, Substitutions and Content fields are added as inputs.
|
Dropdown | TRUE |
With Bypass List Management? |
If set to Yes, allows you to bypass the spam report list to ensure that the email is delivered to recipients. Bounce and unsubscribe lists will still be checked; addresses on these other lists will not receive the message. This filter cannot be combined with the bypass_list_management filter.
If set to Yes, adds the Bypass List Management input field. If set to No, adds Bypass Spam Management?, Bypass Bounce Management? and Bypass Unsubscribe Management? as inputs. Bypass List Management input fields cannot be combined with other Bypass fields. |
Dropdown | TRUE |
With Spam Check? |
If set to Yes, allows you to bypass the spam report list to ensure that the email is delivered to recipients. Bounce and unsubscribe lists will still be checked; addresses on these other lists will not receive the message.
If set to Yes, the Threshold and Post to URL required. If set to No, Span Check doesn't appear in the inputs. |
Dropdown | TRUE |
Input
Field | Definition | Type | Required |
---|---|---|---|
Template ID | An email template ID. A template that contains a subject and content (text or HTML) will override any subject and content values specified at the personalization or message level. | String | TRUE |
From | The From email address used to deliver the message. This address should be a verified sender in your Twilio SendGrid account. | String | TRUE |
To | Intended recipient's email address. | String | TRUE |
CC |
Array of recipients who will receive a copy of your email. Each object in this array must contain the recipient's email address.
An email may be sent to a maximum of 1000 CC recipients. |
List of Text | FALSE |
BCC |
Array of recipients who will receive a blind carbon copy of your email. Each object in this array must contain the recipient's email address.
An email may be sent to a maximum of 1000 BCC recipients. |
List of Text | FALSE |
Headers |
JSON key/value pairs allowing you to specify handling instructions for your email. You may not overwrite the following headers:
|
Object | FALSE |
Substitutions | Substitutions allow you to insert data without using Dynamic Transactional Templates. This field should not be used in combination with a Dynamic Transactional Template, which can be identified by a template_id starting with d-. This field is a collection of key/value pairs following the pattern "substitution_tag":"value to substitute". | Object | FALSE |
Dynamic Template Data | Dynamic template data is available using Handlebars syntax in Dynamic Transactional Templates. This field should be used in combination with a Dynamic Transactional Template, which can be identified by a template_id starting with d- . This field is a collection of key/value pairs following the pattern "variable_name":"value to insert". |
Object | FALSE |
Custom Arguments | Values that are specific to this personalization that will be carried along with the email and its activity data. Any string that is entered into this parameter will be assumed to be the custom argument that you would like to be used. This field may not exceed 10,000 bytes. | Object | FALSE |
Send At | Accepts a UNIX time stamp allowing you to specify when you want your email to be delivered. Delivery cannot be scheduled more than 72 hours in advance. It is recommended to schedule mail for off-peak times. Most emails are scheduled and sent at the top of the hour or half hour. Scheduling email to avoid peak times — for example, scheduling at 10:53 — can result in lower deferral rates due to the reduced traffic during off-peak times. | Number | FALSE |
Categories | Categories to associate with this email. | List of Text | FALSE |
Batch ID | An ID representing a batch of emails to be sent at the same time. Including a batch ID value in your request allows you include this email in that batch. It also enables you to cancel or pause the delivery of that batch. | String | FALSE |
Reply To | Email address where any replies or bounces will be returned. | String | FALSE |
Attachments | An array of objects where you can specify any attachments you want to include. | List of Objects | FALSE |
|
File | TRUE | |
|
String | FALSE | |
|
String | TRUE | |
|
String | FALSE | |
|
String | FALSE | |
Subject | Subject of your email. This may be overridden by subject lines set in personalization. | String | TRUE |
Content |
Array of objects where you can specify content of your email.
|
Object | TRUE |
Spam Check | |||
Threshold | Assigned SpamAssassin value that indicates the level of filtering. Range is between 1 and 10. The lower the number, the more strict the filtering. | Dropdown | FALSE |
Post to URL | Inbound parse URL to which to send spam messages for inspection. | String | TRUE |
Footer | |||
Enable? | If set to True, a default footer will be included on every email. | Boolean | FALSE |
Type | Indicates the type of footer. Options are Text and HTML. | Dropdown | FALSE |
Content |
Content of the footer.
![]() Footer content only displays when the footer is enabled and the type matches the email Content type. |
String | FALSE |
Unsubscribes | |||
Group ID | Unsubscribe group to associate with this email. | Number | FALSE |
Groups to Display | An array containing the unsubscribe groups that you would like to be displayed on the unsubscribe preferences page. | List of Numbers | FALSE |
Mail Settings | |||
IP Pool Name | Name of the IP Pool from which the email is sent. | String | FALSE |
Bypass List Management? | If set to True, allows you to bypass all unsubscribe groups and suppressions to ensure that the email is delivered to every single recipient. This should only be used in emergencies when it is absolutely necessary that every recipient receives your email. This filter cannot be combined with any other bypass filters. | Boolean | FALSE |
Bypass Spam Management | Allows you to bypass the spam report list to ensure that the email is delivered to recipients. | Boolean | FALSE |
Bypass Bounce Management | Allows you to bypass the bounce list to ensure that the email is delivered to recipients. | Boolean | FALSE |
Bypass Unsubscribe Management | Allows you to bypass the global unsubscribe list to ensure that the email is delivered to recipients. | Boolean | FALSE |
Sandbox Mode? | If set to True, allows you to send a test email to ensure that your request body is valid and formatted correctly. | Boolean | FALSE |
Click Tracking | |||
Enable? | If set to True, allows you to track if a recipient clicked a link in your email. | Boolean | FALSE |
Enable Text? | If set to True, indicates if this setting should be included in the text/plain portion of your email. | Boolean | FALSE |
Open Tracking | |||
Enable? | If set to True, allows you to track if the email was opened by including a single pixel image in the body of the content. When the pixel is loaded, Twilio SendGrid can log that the email was opened. | Boolean | FALSE |
Substitution Tag | Allows you to specify a substitution tag that you can insert in the body of your email at a location that you desire. This tag will be replaced by the open tracking pixel. | String | FALSE |
Subscription Tracking | |||
Enable? | If set to True, allows you to insert a subscription management link at the bottom of the text and HTML bodies of your email. | Boolean | FALSE |
Substitution Tag | A tag that will be replaced with the unsubscribe URL. For example: [unsubscribe_url] . If this parameter is used, it will override both the text and html parameters. The URL of the link will be placed at the substitution tag’s location with no additional formatting. |
String | FALSE |
Type | Indicates the type of substitution tag. Options are Text and HTML. | Dropdown | FALSE |
Content | Content of the substitution tag. | String | FALSE |
Google Analytics | |||
Enable? | If set to True, allows you to enable tracking provided by Google Analytics. | Boolean | FALSE |
UTM Source | Name of the referrer source. For example, Google , SomeDomain.com , or Marketing Email . |
String | FALSE |
UTM Medium | Name of the marketing medium. For example, Email . |
String | FALSE |
UTM Term | Used to identify any paid keywords. | String | FALSE |
UTM Content | Used to differentiate your campaign from advertisements. | String | FALSE |
UTM Campaign | Name of the campaign. | String | FALSE |
Output
Field | Definition | Type |
---|---|---|
Status Code | Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:
For a full list of possible status codes, see HTTP status codes. |
Number |