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.

Dropdown

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.

Dropdown

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.

String

From

The From email address used to deliver the message.

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

String

To

Intended recipient's email address.

String

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.

List of Text

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.

List of Text

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

Object

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".

Object

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".

Object

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.

Object

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.

Number

Categories

Categories to associate with this email.

List of Text

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.

String

Reply To

Email address where any replies or bounces are returned.

String

Attachments

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

List of Objects

• content: File to be attached.

File

• type: MIME type of the content you're attaching.

  For example: text/plain or text/html.

String

• filename: Attachment's filename.

String

• 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.

String

• 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.

String

Subject

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

String

Content

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

• type

• value

Object

Threshold

Assigned SpamAssassin value that indicates the level of filtering.

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

Dropdown

Post to URL

Inbound parse URL where spam messages are sent for inspection.

String

Enable?

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

Boolean

Type

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

Dropdown

Content

Content of the footer.

String

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

IP Pool Name

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

String

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.

Boolean

Bypass Spam Management

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

Boolean

Bypass Bounce Management

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

Boolean

Bypass Unsubscribe Management

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

Boolean

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.

Boolean

Enable?

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

Boolean

Enable Text?

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

Boolean

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.

Boolean

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.

String

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.

Boolean

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.

String

Type

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

Dropdown

Content

Content of the substitution tag.

String

Enable?

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

Boolean

UTM Source

Name of the referrer source.

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

String

UTM Medium

Name of the marketing medium.

For example, Email.

String

UTM Term

Used to identify any paid keywords.

String

UTM Content

Used to differentiate your campaign from advertisements.

String