Sign in
Email Messages

Reschedule a scheduled email message

Moves an existing scheduled email to a new future send time. Only the delivery time (scheduled_at) changes; the message ID, content, recipients, tags, and metadata remain unchanged. Returns 409 Conflict if the message is no longer scheduled or its scheduled-send worker has already started processing it. This route emits no dedicated rescheduled event.

patch/email_messages/{email_id}/schedule

Path parameters

email_idstring uuid required

Email message UUID.

Request body

scheduled_atstring date-time required

New ISO 8601 delivery time. Must be strictly in the future.

Response

Scheduled email rescheduled. The response matches the single-message GET representation.

Example response

{
  "data": {
    "recipient_statuses": {
      "delivered": 998,
      "bounced": 2
    }
  }
}

Changes