Create Single Send

Create a new Single Send in SendGrid.

Options

Field Definition Type Required
Send to All? Set to True to send to All Contacts. If set to False, at least one list ID or segment ID value must be provided before the Single Send is scheduled to be sent to recipients. Dropdown TRUE

Input

Field Definition Type Required
Single Send
Name Name of the Single Send. String TRUE
Categories Categories to associate with this Single Send. List of Text FALSE
Send At ISO 8601 time at which to send the Single Send. For example, 2021-03-15T13:18:57.985Z.

Optionally, enter now to send the single send immediately.

Time & Date FALSE
Email Config
Subject Subject line of the Single Send. Do not include this field when using a Design ID. String FALSE
HTML Content HTML content of the Single Send. Do not include this field when using a Design ID. String FALSE
Plain Content Plain text content of the Single Send. Do not include this field when using a Design ID. String FALSE
Generate Plain Content If set to True, plain content is always generated from the HTML Content field. If set to False, plain content is not altered. Boolean FALSE
Design ID A Design ID value can be used in place of content from the HTML Content, Plain Content, and/or Subject fields. You can retrieve a design's ID from the or by pulling it from the design's detail page URL in the Marketing Campaigns App. String FALSE
Editor The editor used to modify the Single Send's design in the Marketing Campaigns App. Options are design or code. Dropdown FALSE
Suppression Group ID ID of the Suppression Group to allow recipients to unsubscribe. String FALSE
Custom Unsubscribe URL URL allowing recipients to unsubscribe. String FALSE
Sender ID ID of the verified Sender. You can retrieve a verified Sender's ID from the Get Verified Senders endpoint or by pulling it from the Sender's detail page URL in the SendGrid App. String FALSE
IP Pool Name of the IP Pool from which the Single Send emails are sent. String FALSE

Output

Field Definition Type
Single Send
ID Unique identifier of the Single Send in SendGrid. For example, XBg2anf2TqCy6WXKQFhieQ.filter0905p1mdw1-4434-59E0C6FF-3.0. String
Name Name of the Single Send. String
Status Current status of the Single Send. String
Categories Categories to associate with this Single Send. List of Text
Send At ISO 8601 time at which to send the Single Send. Date & Time
Send To
List IDs Recipient List IDs that will receive the Single Send. List of Text
Segment IDs Recipient Segment IDs that will receive the Single Send. List of Text
All? Set to True to send to All Contacts. If set to False, at least one list ID or segment ID value must be provided before the Single Send is scheduled to be sent to recipients. Boolean
Created At ISO 8601 time at which the Single Send was created. Date & Time
Email Config
Subject Subject line of the Single Send. String
HTML Content HTML content of the Single Send. String
Plain Content Plain text content of the Single Send. String
Generate Plain Content If set to True, plain content is always generated from the HTML Content field. If set to False, plain content is not altered. Boolean
Editor The editor used to modify the Single Send's design in the Marketing Campaigns App. Options are Design or Code. String
Suppression Group ID ID of the Suppression Group to allow recipients to unsubscribe. String
Custom Unsubscribe URL URL allowing recipients to unsubscribe. String
Sender ID ID of the verified Sender. You can retrieve a verified Sender's ID from the Get Verified Senders endpoint or by pulling it from the Sender's detail page URL in the SendGrid App. String
IP Pool Name of the IP Pool from which the Single Send emails are sent. String
Warnings
Message Warning message for a single send. String
Field Field to which a warning message pertains. String
Warning ID ID of the warning. String

Related topics

SendGrid connector

Workflow elements

SendGrid API Reference