Drafts

Create a draft

POST https://getinboxtriage.com/api/inboxes/{id}/draft

Writes a draft into the mailbox. It never sends.

The REST API has no send endpoint. Sending goes through MCP with the person's approval in chat.

Headers

Name	Type	Required	Description
`Authorization`	string	Required	Bearer followed by your API key.
`Content-Type`	string	Required	application/json

Path parameters

Name	Type	Required	Description
`id`	string	Required	Inbox id from List inboxes, like inbox_lx2k9a1b.

Request body

Name	Type	Required	Description
`to`	string	Required	Recipient address or addresses.
`subject`	string	Required	Subject line.
`text`	string	Required	Plain text body.
`threadId`	string	Optional	Thread to reply in, from Get a message.

Response

201 Created.

Name	Type	Description
`id`	string	Draft id.
`to`	string	Recipients.
`subject`	string	Subject line.
`text`	string	Body.
`provider`	string	The inbox provider.
`providerDraftId`	string \| null	The draft's id in the mailbox.
`threadId`	string \| null	Thread it replies in.
`isDemo`	boolean	true for sample data. Nothing was written to the mailbox.
`createdAt`	string	ISO time.

Errors

Status	Error	Meaning
400	`invalid_request`	to, subject, or text is missing.
400	`draft_failed`	The draft was refused, for example a line break in To or Subject. error_description has the reason.
404	`inbox_not_found`	The inbox id is wrong or the inbox was removed.
409	`inbox_paused`	The person paused this inbox. They resume it on the Inboxes page.
409	`not_connected`	The inbox has no working credential. The person connects it first.

Any route can also return 401 for a bad key, 402 when the trial ended or payment failed, and 429 when you send too many requests. See Errors.

Request

curl -X POST "https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b/draft" \
  -H "Authorization: Bearer $INBOX_TRIAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"sam@example.com","subject":"Re: Friday?","text":"Friday at 2 works for me."}'

const res = await fetch("https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b/draft", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INBOX_TRIAGE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "to": "sam@example.com",
    "subject": "Re: Friday?",
    "text": "Friday at 2 works for me."
  }),
});
const data = await res.json();

import os
import requests

res = requests.post(
    "https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b/draft",
    headers={"Authorization": f"Bearer {os.environ['INBOX_TRIAGE_KEY']}"},
    json={
        "to": "sam@example.com",
        "subject": "Re: Friday?",
        "text": "Friday at 2 works for me.",
    },
)
print(res.json())

Response201

{
  "id": "draft_1758182400000",
  "to": "sam@example.com",
  "subject": "Re: Friday?",
  "text": "Friday at 2 works for me.",
  "createdAt": "2026-09-18T08:40:00.000Z",
  "provider": "google",
  "providerDraftId": "r-4839201938475",
  "threadId": null,
  "isDemo": false
}