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