{
  "emailId": "email_abc123",
  "threadId": "thread_xyz789",
  "messageId": "DRAFT-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
Need a human to eyeball every outbound email before it leaves your system? Draft Mode lets you create emails and replies that stay safely in AI Inbx until someone approves them. E-mails created in Draft Mode:
  • Appear in the dashboard with the status DRAFT.
  • Can be edited and finally Send (or deleted) by any team member with access.
  • Never hit the recipient’s inbox until you manually Send.
Drafts are great for:
  • Early-stage agents that still hallucinate.
  • Sensitive communication that always needs human approval.

1. Draft a single email

Add "is_draft": true to the request body of either /emails/send or /emails/{emailId}/reply.
curl -X POST "https://aiinbx.com/api/v1/emails/send" \
  -H "Authorization: Bearer $AI_INBX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "customer@example.com",
    "from": "hello@yourdomain.com",
    "subject": "Quote for your request",
    "html": "<p>Here is the draft of your quote…</p>",
    "is_draft": true
}'

Response

The JSON response structure is the same, but messageId will be "DRAFT-{uuid}" instead of a real message ID:
{
  "emailId": "email_abc123",
  "threadId": "thread_xyz789",
  "messageId": "DRAFT-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

2. Draft Mode for an entire API key

Toggling Forced Draft Mode on an API key forces every send or reply made with that key to be saved as a draft—no (and not sent) regardless of the is_draft field of the api call.
1

Open your API key details

Go to API Keys and click the three dots on the API key you want to edit. This opens a dropdown menu.
2

Enable Draft Mode

Toggle between the modes. When the draft override is ON, every email created with this API key will be stored as a draft for manual review, even if your request sets is_draft to false. Disable it to allow normal sending.
3

Review & send drafts

Drafts appear in your Threads. Open a thread, see the draft, make adjustments if needed, and hit Send when you’re ready.

API reference additions

status
'DRAFT' | ...
Returns DRAFT when the email is created in Draft Mode.