Email Messages

Reschedule a scheduled email message

Changed on

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

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/email_messages/{email_id}/schedule
  • Auth
    HTTP bearer

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