Cancel a scheduled email

Cancel a still-queued send. Only a queued message is cancellable; a canceled send is never sent and never billed.

POSThttps://api.mailfully.com/v1/emails/{id}/cancel

Cancel a still-queued send. Only a queued message is cancellable; a canceled send is never sent and never billed. Cancel is idempotent — an already-canceled message returns 200 again. Any other status returns 409. Requires the send scope. Takes no request body.

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).

Response

application/json

The canceled email detail.

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