Rate this page:

Scheduling Email

There are 3 easy ways to schedule your emails; use the Marketing Campaigns, use the SMTP API header, or use the API.

If you have the flexibility, it's better to schedule mail for off-peak times. Most emails are scheduled and sent at the top of the hour or half hour. Scheduling email to avoid those times (for example, scheduling at 10:53) can result in lower deferral rates because it won't be going through our servers at the same times as everyone else's mail.

1. Marketing Campaigns

If you are using Marketing Campaigns, you can schedule a time to send your campaign from the Settings tab by turning Off the option to Send Immediately. Next, verify that you are using the correct time zone, and then simply choose the date and time that you would like to send your campaign at.

You can also schedule your campaigns with the Marketing Campaigns API.

2. API

You can schedule a time to send your email by using the send_at object of the POST /mail/send method of the V3 API. For more information about scheduling and stopping scheduled sends with the API, see Can I Stop an in-progress send.

3. SMTP API

You can use the SMTP API header to schedule your emails when sending via SMTP or our mail.send API endpoint. SendGrid will allow you to queue batches of emails targeting individual recipients by using a UNIX time stamp parameter in your SMTP API header.

This parameter allows SendGrid to begin processing your email requests before sending. SendGrid will then queue those messages and release them when the specified time rolls around.

Here's an example of how this timestamp might look in your SMTP API JSON header:

{ "send_at": 1409348513 }

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.

      
      
      

      Thank you for your feedback!

      We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

      Sending your feedback...
      🎉 Thank you for your feedback!
      Something went wrong. Please try again.

      Thanks for your feedback!

      Refer us and get $10 in 3 simple steps!

      Step 1

      Get link

      Get a free personal referral link here

      Step 2

      Give $10

      Your user signs up and upgrade using link

      Step 3

      Get $10

      1,250 free SMSes
      OR 1,000 free voice mins
      OR 12,000 chats
      OR more