Sign inGet Started
Aan de slag
Gidsen
API Reference
SDK's
CLI
Kennisbank
Changelog

Get a scheduled mailbox send

GET
/v1/email/mailboxes/{mailbox_id}/scheduled-messages/{scheduled_message_id}
bird email mailboxes scheduled-messages get <mailbox-id> <scheduled-message-id>
Reactie200
{
  "id": "msm_01krdgeqcxet5s7t44vh8rt9mg",
  "mailbox_id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
  "thread_id": "thr_01krdgeqcxet5s7t44vh8rt9mg",
  "status": "scheduled",
  "scheduled_at": "2026-05-20T10:00:00Z",
  "cancel_on_reply": false,
  "recipients": [
    "customer@example.com"
  ],
  "subject": "Your request",
  "snippet": "Here is the reply.",
  "created_by": {
    "id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
    "type": "user"
  },
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-20T09:14:52Z"
}

Read the scheduled send and its dispatch, failure or cancellation state. The actual message enters the conversation only at dispatch.

Parameters

mailbox_idstring

Mailbox that owns the scheduled send.

scheduled_message_idstring

Scheduled send identifier from scheduled_message_id in the acceptance response.

Response Payload

id
string
verplicht

Scheduled send identifier.

mailbox_id
string
verplicht

Mailbox that owns the send.

thread_id
string
verplicht

Reserved conversation identifier. A new compose does not create the conversation until dispatch.

message_id
string

Actual message identifier once handed to the send pipeline.

status
string
verplicht
  • scheduled: Waiting for its due time; cancellation is still possible.
  • sending: Dispatch has been claimed; cancellation is no longer possible.
  • sent: Handed to the ordinary send pipeline, not necessarily delivered. Follow message_id for delivery status.
  • failed: Terminal dispatch refusal or failure; see failure_reason. The schedule will not retry.
  • canceled: Terminal cancellation before dispatch; see cancellation_reason. The message will not send.

Possible values: scheduled, sending, sent, failed, canceled

scheduled_at
string
verplicht

Scheduled at.

cancel_on_reply
boolean
verplicht

Whether an inbound message cancels this send before dispatch is claimed.

failure_reason
string

Why dispatch failed.

cancellation_reason
string

Why canceled; replied means new inbound mail canceled an opted-in schedule.

subject
string
verplicht

Frozen subject.

snippet
string
verplicht

Plain-text preview of the frozen message.

recipients
array of string
verplicht

Visible recipients (To and Cc). Bcc addresses remain only in the frozen send payload.

created_by
object
verplicht

Authenticated caller that scheduled the send.

Onderliggende attributen tonen
created_at
string
verplicht
updated_at
string
verplicht

Gerelateerde bronnen

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.

Ontvang een implementatieoverzicht