Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

Schedule Single Send


Twilio calls a one-time, non-automated email message delivered to a list or segment of your audience a Single Send. You can send such messages immediately or scheduled for future delivery. Single Sends can deliver promotional offers, engagement campaigns, newsletters, announcements, legal notices, or policy updates. The Single Sends API lets you create, retrieve, update, delete, schedule, and search for Single Sends. Another API endpoint provides campaign statistics. The SendGrid Knowledge Center explains the latest updates to the Single Sends API.


Operation overview

operation-overview page anchor

PUT/v3/marketing/singlesends/{id}/schedule

Base url: https://api.sendgrid.com (The Twilio SendGrid v3 API)

This endpoint allows you to send a Single Send immediately or schedule it to be sent at a later time.

To send your message immediately, set the send_at property value to the string now. To schedule the Single Send for future delivery, set the send_at value to your desired send time in ISO 8601 date time format(link takes you to an external page) (yyyy-MM-ddTHH:mm:ssZ).


Authentication

authentication page anchor
Property nameTypeRequiredDescription
Authorizationstring
required
Default: Bearer <<YOUR_API_KEY_HERE>>
Property nameTypeRequiredDescription
idstring
required
Encoding type:application/json
SchemaExample
Property nameTypeRequiredDescriptionChild properties
send_atstring<date-time>
required

The ISO 8601 time at which to send the Single Send. This must be in future or the string now. SendGrid Mail Send emails can be scheduled up to 72 hours in advance. However, this scheduling constraint does not apply to emails sent via Marketing Campaigns.

201404500
SchemaExample
Property nameTypeRequiredDescriptionChild properties
send_atstring<date-time>

Optional

The ISO 8601 time at which to send the Single Send. This must be in future or the string now. SendGrid Mail Send emails can be scheduled up to 72 hours in advance. However, this scheduling constraint does not apply to emails sent via Marketing Campaigns.


statusenum<string>

Optional

Possible values:
scheduled
Schedule Single SendLink to code sample: Schedule Single Send
1
const client = require("@sendgrid/client");
2
client.setApiKey(process.env.SENDGRID_API_KEY);
3
4
const id = "id";
5
const data = {
6
send_at: "3752-01-28T23:21:52.575Z",
7
};
8
9
const request = {
10
url: `/v3/marketing/singlesends/${id}/schedule`,
11
method: "PUT",
12
body: data,
13
};
14
15
client
16
.request(request)
17
.then(([response, body]) => {
18
console.log(response.statusCode);
19
console.log(response.body);
20
})
21
.catch((error) => {
22
console.error(error);
23
});