Skip to main content
While some emails need to be delivered as soon as possible, like password resets or magic links, others can be scheduled for a specific time. Here are some examples of when you might want to schedule an email:
  • Send welcome email 5 minutes after signup
  • Trigger a reminder email 24 hours before an event
  • Schedule a weekly digest email for the next day at 9am PST
Before, you had to use external services to handle the scheduling logic, but now you can use the new Resend API to schedule emails.
Emails can be scheduled up to 30 days in advance.
There are two ways to schedule an email:
  1. Using natural language
  2. Using date format

​
1. Schedule using natural language

You can use the various Resend SDKs to schedule emails. The date can be defined using natural language, such as "in 1 hour", "tomorrow at 9am", or "Friday at 3pm ET". 
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

await resend.emails.send({
  from: 'Acme <[email protected]>',
  to: ['[email protected]'],
  subject: 'hello world',
  html: '<p>it works!</p>',
  scheduledAt: 'in 1 min',
});

​
2. Schedule using date format

You can also use a date in ISO 8601 format (e.g: 2024-08-05T11:52:01.858Z). 
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const oneMinuteFromNow = new Date(Date.now() + 1000 * 60).toISOString();

await resend.emails.send({
  from: 'Acme <[email protected]>',
  to: ['[email protected]'],
  subject: 'hello world',
  html: '<p>it works!</p>',
  scheduledAt: oneMinuteFromNow,
});

​
View a scheduled email

Once you schedule an email, you can see the scheduled time in the Resend dashboard.

​
Reschedule an email

After scheduling an email, you might need to update the scheduled time. You can do so with the following method: 
resend.emails.update({
  id: '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794',
  scheduledAt: 'in 1 min',
});
You can also reschedule an email directly in the Resend dashboard.

​
Cancel a scheduled email

Once an email is canceled, it cannot be rescheduled.
If you need to cancel a scheduled email, you can do so with the following code: 
resend.emails.cancel('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
You can also cancel a scheduled email in the Resend dashboard.

​
Scheduled email failures

Scheduled emails may fail to send for several reasons. When this happens, you’ll see a failure notification in the email details screen with specific information about why the email couldn’t be sent. Common failure reasons include:
  • API key is no longer active - The API key used to schedule the email has been deleted, expired, or suspended. The email cannot be sent.
  • Account under review - Your account has been flagged for review and sending has been temporarily suspended. Contact [email protected] if you believe this is an error.
You can view the failure reason and details in the Resend dashboard by clicking on the failed email.

​
Limitations

  • Emails sent via SMTP cannot be scheduled