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.	Text	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.	Text	FALSE
HTML Content	HTML content of the Single Send. Do not include this field when using a Design ID.	Text	FALSE
Plain Content	Plain text content of the Single Send. Do not include this field when using a Design ID.	Text	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.	True/False	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.	Text	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.	Text	FALSE
Custom Unsubscribe URL	URL allowing recipients to unsubscribe.	Text	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.	Text	FALSE
IP Pool	Name of the IP Pool from which the Single Send emails are sent.	Text	FALSE

Output

Field	Definition	Type
Single Send
ID	Unique identifier of the Single Send in SendGrid. For example, `XBg2anf2TqCy6WXKQFhieQ.filter0905p1mdw1-4434-59E0C6FF-3.0`.	Text
Name	Name of the Single Send.	Text
Status	Current status of the Single Send.	Text
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.	True/False
Created At	ISO 8601 time at which the Single Send was created.	Date & Time
Email Config
Subject	Subject line of the Single Send.	Text
HTML Content	HTML content of the Single Send.	Text
Plain Content	Plain text content of the Single Send.	Text
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.	True/False
Editor	The editor used to modify the Single Send's design in the Marketing Campaigns App. Options are `Design` or `Code`.	Text
Suppression Group ID	ID of the Suppression Group to allow recipients to unsubscribe.	Text
Custom Unsubscribe URL	URL allowing recipients to unsubscribe.	Text
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.	Text
IP Pool	Name of the IP Pool from which the Single Send emails are sent.	Text
Warnings
Message	Warning message for a single send.	Text
Field	Field to which a warning message pertains.	Text
Warning ID	ID of the warning.	Text