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, 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

TRUE

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

TRUE

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.

Dropdown

TRUE

Input

Field Definition Type Required
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.

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

FALSE

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

FALSE

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

FALSE

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

FALSE

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

FALSE

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

FALSE

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

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 to 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 are returned.

String

FALSE

Attachments

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

List of Objects

FALSE

  • content: File to be attached.

File

TRUE

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

    For example: text/plain or text/html.

String

FALSE

  • filename: Attachment's filename.

String

TRUE

  • 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

FALSE

  • 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

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 the content of your email.

  • type

  • value

Object

TRUE

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.

Dropdown

FALSE

Post to URL

Inbound parse URL where spam messages are sent for inspection.

String

TRUE

Footer

Enable?

If set to True, a default footer is 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 is shown only 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 that contains the unsubscribe groups 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, 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

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, it 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, it allows you to track if a recipient clicked a link in your email.

Boolean

FALSE

Enable Text?

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

Boolean

FALSE

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.

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

String

FALSE

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.

Boolean

FALSE

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

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, it 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:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Related topics

SendGrid connector

Workflow elements

SendGrid API Reference