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 |