Reschedule an email

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

Move the send time of a future-dated, still-queued message. Only works for sends originally scheduled more than 15 minutes ahead (the ones that took the EventBridge branch); an immediate or ≤15-minute send cannot be rescheduled and returns 422. 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

toarray<string>required

fromstringrequired

created_atstring<date-time>required

subjectstring

htmlstring

textstring

ccarray<string>required

bccarray<string>required

reply_toarray<string>required

last_eventstringrequired

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_-]+`.