API Reference

Update an email

PATCH /emails/:id — reschedule a scheduled email.

PATCH/emails/:id

Reschedule a still-scheduled email by setting a new scheduled_at. Only emails in the scheduled state can be updated — once an email has been sent, its delivery time is fixed. See Schedule email.

Path parameters

idstringrequired

The id of the scheduled email to reschedule.

Body parameters

scheduled_atstringrequired

New ISO 8601 datetime to send the email.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.emails.update('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794', { "scheduled_at": "2026-06-25T09:00:00Z" });
console.log({ data, error });

Response

{
  "object": "email",
  "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
}

Errors

Returns not_found (404) if the email does not exist for your account; validation_error if the email is not in the scheduled state, or if scheduled_at is missing or not a valid ISO timestamp. See the error reference.