missive_create_draft
Create a draft message (email, SMS, WhatsApp, or custom channel) saved in Missive for manual review and sending. Appends to existing conversations or starts new ones.
Instructions
Creates a draft saved in Missive for manual review/sending — it does NOT send. Builds a draft email/SMS/WhatsApp/custom-channel message (in a new conversation, or appended to an existing one via conversation or references) that a human reviews and sends from the Missive app. The send-related parameters (send, send_at, auto_followup) are intentionally NOT available, so this tool can never transmit a message.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | HTML or text body of the message. Note: for paragraph spacing in Missive use <div>…</div> blocks separated by <div><br></div> rather than <p> tags. | |
| team | No | Team ID to link the draft's conversation to. Ignored if the conversation is already linked to a team. | |
| close | No | Close the draft's conversation for everyone. | |
| account | No | Account ID for custom channel, Missive Live Chat, Messenger or Instagram drafts (Settings > API > Resource IDs). | |
| subject | No | Email subject, passed verbatim to the outgoing email. When replying, set to 'Re: [original subject]' so recipient clients thread it correctly. | |
| add_users | No | User IDs to grant access. Requires `organization` (explicit or MISSIVE_DEFAULT_ORGANIZATION). | |
| cc_fields | No | CC recipients (email only). Array of {address, name?} objects. | |
| to_fields | No | Primary recipients. Array of recipient objects (shape depends on channel). | |
| bcc_fields | No | BCC recipients (email only). Array of {address, name?} objects. | |
| force_team | No | When true, force the `team` even if the conversation is already in another team. | |
| from_field | No | ||
| references | No | Message-ID/References header strings used to locate and append this draft to an existing conversation (chevrons optional). If none match, a new conversation is created. | |
| attachments | No | Files to attach (up to 25). Each: base64_data (base64-encoded contents) and filename. | |
| add_to_inbox | No | When true, move the draft's conversation to Inbox for everyone with access. | |
| conversation | No | ID of an existing Missive conversation to append this draft to (alternative to `references`). | |
| organization | No | Organization UUID. Scopes the conversation search and links new conversations to that organization. Defaults to MISSIVE_DEFAULT_ORGANIZATION. REQUIRED when `add_shared_labels` is used. | |
| add_assignees | No | User IDs to assign. Requires `organization` (explicit or MISSIVE_DEFAULT_ORGANIZATION). | |
| remove_assignees | No | User IDs to unassign. Requires `organization` (explicit or MISSIVE_DEFAULT_ORGANIZATION). | |
| add_shared_labels | No | Shared label IDs to apply to the draft's conversation. Requires `organization` (explicit or MISSIVE_DEFAULT_ORGANIZATION). | |
| add_to_team_inbox | No | When true, move the conversation to a team inbox. Requires `team`. | |
| conversation_color | No | Conversation color: a HEX code (e.g. '#000') or one of 'good', 'warning', 'danger'. | |
| conversation_subject | No | Subject for the conversation in Missive (the internal conversation title). | |
| remove_shared_labels | No | Shared label IDs to remove from the draft's conversation. | |
| quote_previous_message | No | When true, include a quoted copy of the conversation's last message in the draft. DANGER: when appending to an existing conversation (via `conversation`/`references`) this embeds the previous message's body and can leak sensitive content. Leave false unless you fully control and have visibility into the conversation. Defaults to false. |