missive_create_message
Creates a simulated inbound message in a Missive custom channel to import or test message workflows without external delivery.
Instructions
ADVANCED — custom channels only. Creates an INCOMING message record (a simulated inbound message) inside a Missive custom channel; it NEVER transmits anything externally and is NOT an email send. To actually send an email, use the Drafts endpoint with send (not exposed by this server). from_field is required; account (the custom-channel account ID) falls back to MISSIVE_DEFAULT_ACCOUNT.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Message body — HTML or plain text depending on the channel message type. | |
| team | No | Team ID to link the conversation to (ignored if the conversation already has a team). | |
| close | No | Close the message's conversation for everyone with access. | |
| account | No | Custom-channel account ID (found in the custom channel settings). Falls back to MISSIVE_DEFAULT_ACCOUNT. | |
| subject | No | Email-channel only: message subject. | |
| add_users | No | User IDs to grant access to the conversation. Requires `organization`. | |
| cc_fields | No | Email-channel only: CC recipients ([{ address, name }]). | |
| to_fields | No | Recipients. Email channel: [{ address, name }]. Text/HTML channel: [{ id, username, name }]. | |
| bcc_fields | No | Email-channel only: BCC recipients ([{ address, name }]). | |
| force_team | No | Force a new team even if the conversation is already in another team. | |
| from_field | Yes | Required. The message sender. Email channel: { address, name }. Text/HTML channel: { id, username, name }. | |
| references | No | Reference strings used to append this message to an existing conversation (matched against prior external_id/references). If none match, a new conversation is created. | |
| attachments | No | Files to attach. Total request payload must not exceed 10 MB. | |
| external_id | No | Unique ID identifying non-email messages (SMS, Instagram DMs, etc.). | |
| add_to_inbox | No | Move the conversation to Inbox for everyone with access. | |
| conversation | No | ID of an existing conversation to append this message to (alternative to references). | |
| delivered_at | No | Delivery timestamp (Unix seconds). If omitted, delivered-at is set to request time. | |
| organization | No | Organization ID. Scopes the conversation search and links a newly created conversation. REQUIRED when using add_users / add_assignees / remove_assignees. | |
| add_assignees | No | User IDs to assign to the conversation (existing assignees remain). Requires `organization`. | |
| remove_assignees | No | User IDs to unassign from the conversation. Requires `organization`. | |
| add_shared_labels | No | Shared-label IDs to apply to the message's conversation. | |
| add_to_team_inbox | No | 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 to set on the conversation. | |
| remove_shared_labels | No | Shared-label IDs to remove from the message's conversation. |