Skip to main content
Drafts let an agent compose a reply and save it without sending — a team member can then review and send it directly from the dashboard. This is especially useful for supervised workflows where the agent handles triage and drafting, but a human approves anything that touches billing, account access, or sensitive topics. Saved drafts retain their uploaded file attachments; unused uploads that are not attached to any draft expire automatically after 24 hours.

​
List drafts

Returns cursor-paginated saved drafts for the specified inbox. GET /api/v1/inboxes/:id/drafts Requires: email:read

​
Query parameters

​
integer
Number of drafts to return. Range: 1–100. Defaults to 20.
​
string
Opaque pagination cursor returned as next_cursor in the previous response.
List saved drafts

​
Create a draft

Saves a new draft without sending it. Attach existing upload IDs for file attachments, and set reply_to_message_id to keep the draft linked to the correct conversation. POST /api/v1/inboxes/:id/drafts Requires: email:send
Save a draft reply

​
Request parameters

​
string[]
One or more recipient addresses for the draft. Accepts plain addresses or RFC 5322 "Name <addr>" format.
​
string
Subject line of the draft message.
​
string
Plain-text draft body. Provide at least one of text or html.
​
string
HTML draft body displayed in email clients that support it.
​
string[]
IDs of previously uploaded files to attach to this draft. Upload files first via POST /api/v1/inboxes/:id/uploads. Maximum 10 attachments and 10 MB total.
​
string
ID of the message this draft is a reply to. Links the draft to the correct thread in the dashboard so a team member can send it with proper threading headers.
Always set reply_to_message_id when drafting a reply. This ensures the dashboard shows the draft in context alongside the customer’s original message, making it easy for a team member to review and send.

​
Delete a draft

Permanently removes a saved draft. Attached files are released and may expire if not referenced elsewhere. DELETE /api/v1/drafts/:id Requires: email:send
Delete a draft

​
Sending a draft

To promote a draft to a sent message, pass its draft_id in the body of the send endpoint. The draft is removed atomically when the message is queued — even if the send is deduplicated by an idempotency_key.
Send a saved draft
Sending requires the email:send scope. On the Free Sandbox, sends are limited to verified recipients (25 per month, 5 per day). A paid plan is required for production support workflows.

​
Attachment lifecycle

Uploads (unsaved)

Files uploaded via POST /api/v1/inboxes/:id/uploads but not yet attached to a draft or message expire after 24 hours.

Draft attachments

Files referenced in a saved draft are retained as long as the draft exists. Deleting the draft releases the files.