Send Email

Use Template?

Indicates whether to use an email template.

If set to Yes, then the Template ID and Dynamic Template Data fields are added as inputs.

If set to No, then the Subject, Substitutions, and Content fields are added as inputs.

With Bypass List Management?

If set to Yes, you can bypass the spam report list to ensure that the email is delivered to recipients. Bounce and unsubscribe lists are still checked. However, addresses on these other lists won't receive the message.

This filter can't 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 can't be combined with other Bypass fields.

With Spam Check?

If set to Yes, you can bypass the spam report list to ensure that the email is delivered to recipients. Bounce and unsubscribe lists are still checked. However, addresses on these other lists don't receive the message.

If set to Yes, then the Threshold and Post to URL fields are required.

If set to No, then Spam Check doesn't appear in the inputs.

Email

Template ID

Specifies an email template ID.

A template that contains a subject and content (text or HTML) overrides any subject and content values specified at the personalization or message level.

From

The From email address used to deliver the message.

This address should be a verified sender in your Twilio SendGrid account.

To

Intended recipient's email address.

CC

Array of recipients who receive a copy of your email. Each object in this array must contain the recipient's email address.

An email can be sent to a maximum of 1000 CC recipients.

BCC

Array of recipients who receive a blind carbon copy of your email. Each object in this array must contain the recipient's email address.

An email can be sent to a maximum of 1000 BCC recipients.

Headers

JSON key/value pairs allowing you to specify handling instructions for your email. You can't overwrite the following headers:

• x-sg-id

• x-sg-eid

• received

• dkim-signature

• Content-Type

• Content-Transfer-Encoding

• To

• From

• Subject

• Reply-To

• CC

• BCC

Substitutions

Substitutions allow you to insert data without using Dynamic Transactional Templates.

Don't use this field with a Dynamic Transactional Template, which is 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".

Dynamic Template Data

Dynamic template data is available using the Handlebars syntax in Dynamic Transactional Templates.

Use this field with a Dynamic Transactional Template, which is 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".

Custom Arguments

Values that are specific to this personalization, which are carried along with the email and its activity data.

Any string entered into this parameter is assumed to be the custom argument that you want to use.

This field may not exceed 10,000 bytes.

Send At

Accepts a UNIX time stamp to specify when you want your email to be delivered.

Delivery can't be scheduled more than 72 hours in advance. It's 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, at 10:53, for example, can result in lower deferral rates.

Categories

Categories to associate with this email.

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 to include this email in that batch. It also enables you to cancel or pause the delivery of that batch.

Reply To

Email address where any replies or bounces are returned.

Attachments

An array of objects where you can specify any included attachments.

content

File to be attached.

type

MIME type of the content you're attaching.

For example: text/plain or text/html.

filename

Attachment's filename

disposition

Attachment's content disposition, to specify how you want to display the attachment.

For example, specifying inline results in the attached file being displayed automatically within the message. Using attachment results in the attached file needing some action to be taken before it's displayed, such as opening or downloading the file.

content_id

An email template ID. A template that contains a subject and content (text or HTML) overrides any subject and content values specified at the personalization or message level.

Subject

Subject of your email. This may be overridden by subject lines set in personalization.

Content

Array of objects where you can specify the content of your email.

• type

• value

Spam Check

Threshold

Assigned SpamAssassin value that indicates the level of filtering.

The range is from 1 through 10 with lower numbers having stricter filtering.

Post to URL

Inbound parse URL where spam messages are sent for inspection.

Footer

Enable?

If set to True, a default footer is included on every email.

Type

Indicates the type of footer. Options are Text and HTML.

Content

Content of the footer.

Unsubscribes

Group ID

Unsubscribe group to associate with this email.

Groups to Display

An array that contains the unsubscribe groups to be displayed on the unsubscribe preferences page.

List of Numbers

Mail Settings

IP Pool Name

Name of the IP pool from which the email is sent.

Bypass List Management?

If set to True, it allows you to bypass all unsubscribe groups and suppressions to ensure that the email is delivered to every recipient.

Only use this field in emergencies when it's necessary that every recipient receives your email. This filter can't be combined with any other bypass filters.

Bypass Spam Management

Allows you to bypass the spam report list to ensure that the email is delivered to recipients.

Bypass Bounce Management

Allows you to bypass the bounce list to ensure that the email is delivered to recipients.

Bypass Unsubscribe Management

Allows you to bypass the global unsubscribe list to ensure that the email is delivered to recipients.

Sandbox Mode?

If set to True, it allows you to send a test email to ensure that your request body is valid and formatted correctly.

Click Tracking

Enable?

If set to True, it allows you to track if a recipient clicked a link in your email.

Enable Text?

If set to True, it indicates if this setting should be included in the text/plain portion of your email.

Open Tracking

Enable?

If set to True, it 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, SendGrid can log that the email was opened.

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 is replaced by the open tracking pixel.

Subscription Tracking

Enable?

If set to True, it allows you to insert a subscription management link at the bottom of the text and HTML bodies of your email.

Substitution Tag

A tag that is replaced with the unsubscribe URL. For example: [unsubscribe_url].

If this parameter is used, it overrides both the text and html parameters. The URL of the link is placed at the substitution tag's location with no additional formatting.

Type

Indicates the type of substitution tag. Options are Text and HTML.

Content

Content of the substitution tag.

Google Analytics

Enable?

If set to True, it allows you to enable tracking provided by Google Analytics.

UTM Source

Name of the referrer source.

For example, Google, SomeDomain.com, or Marketing Email.

UTM Medium

Name of the marketing medium.

For example, Email.

UTM Term

Used to identify any paid keywords.

UTM Content

Used to differentiate your campaign from advertisements.

UTM Campaign

Name of the campaign.

Status Code