Reschedule an email

PATCHhttps://api.mailfully.com/v1/emails/{id}

Move the send time of a future-dated, still-queued message. Only a message that was scheduled more than 15 minutes ahead when you sent it can be rescheduled; others return 422. A message that is no longer queued returns 409. The new scheduled_at must be strictly in the future and no more than 90 days out. Requires the send scope.

Loading code example

Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

The message id (a bare 26-character ULID, no prefix).

Body

scheduled_atstring<date-time>required

New send time; must be strictly in the future and no more than 90 days out.

Response

application/json

The updated email detail with its new schedule.

object"email"required

Allowed values: "email"

idstringrequired

type"transactional" | "marketing"required

The kind of mail, as the sender declares it. Omitting the field means transactional. A marketing send is subject to extra compliance rules — it accepts exactly one recipient across to/cc/bcc, the organization must have a postal address on file, and it draws on a separate monthly marketing allowance.

Allowed values: "transactional" | "marketing"

Default: "transactional"

toarray<string>required

fromstringrequired

created_atstring<date-time>required

subjectstring

htmlstring

textstring

ccarray<string>required

bccarray<string>required

reply_toarray<string>required

last_eventstringrequired

The message's latest state in status words (delivered, bounced, complained), not the event type names used by /events. Falls back to status.

scheduled_atstring<date-time>

tagsarray<object>required

tags.namestringrequired

Tag name; must match [A-Za-z0-9_-]+.

tags.valuestringrequired

Tag value; must match [A-Za-z0-9_-]+.