Drafts

Send a draft

Sends the draft as it stands now and removes it from Drafts. Goes through the same checks as sending directly, and counts against the monthly send limit. A draft with no recipient is a 422. Send { "sendAt": "..." } to schedule it instead: the draft stays in Drafts and is sent at that time, as it stands then. Scheduling a draft that is already scheduled moves its time. Requires scope mail:send.

post/mailboxes/{address}/drafts/{uid}/send

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/mailboxes/{address}/drafts/{uid}/send
  • Auth: HTTP bearer

Path parameters

addressstring required

Full mailbox address, e.g. user@yourdomain.com

uidinteger required

The draft's UID in the Drafts folder, as returned when it was created or listed.

Headers

Idempotency-Keystring

A unique value you choose (a UUID works), up to 256 characters. Repeating a request with the same key within 24 hours returns the first result instead of doing the work twice. The same key with a different body is a 422; a repeat while the first request is still running is a 409.

Request body

sendAtstring date-time

Send later instead of now: ISO 8601 with a timezone, at least one minute and at most 30 days ahead. The message waits in the mailbox's Drafts folder until then.

Example request

{
  "sendAt": "2026-10-05T09:00:00Z"
}

Response

Draft sent, or scheduled when sendAt was given

successboolean

Example response

{
  "success": true,
  "data": {
    "sent": true,
    "scheduled": {
      "uid": 42
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.