# Missive

Missive is a collaborative email and chat application designed to streamline team communication and task management.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 41
- **Triggers:** 0
- **Slug:** `MISSIVE`
- **Version:** 20260316_00

## Tools

### Create Analytics Report

**Slug:** `MISSIVE_CREATE_ANALYTICS_REPORT`

Tool to create an analytics report. Use when you need to generate a report over a specific time range with optional filters. Returns a report ID for later retrieval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reports` | object | Yes | Report specifications including organization, period, and optional filters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Missive Contacts

**Slug:** `MISSIVE_CREATE_CONTACTS`

Tool to create one or more contacts in a Missive contact book. Use when you need to add new contacts with detailed information including name, email, phone, addresses, and organization memberships.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contacts` | array | Yes | Array of contact objects to create. Each contact must include contact_book UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Draft

**Slug:** `MISSIVE_CREATE_DRAFT`

Tool to create a new draft in Missive. Use after preparing message details to save a draft (email, SMS, WhatsApp, or Live Chat) for later editing or scheduling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | HTML or text body of the draft. Use '<br>' for paragraphs. |
| `send` | boolean | No | Send the draft immediately upon creation |
| `team` | string | No | Team ID to link the draft's conversation |
| `close` | boolean | No | Close the conversation after draft creation |
| `account` | string | No | Account ID for custom channels or live chat |
| `send_at` | integer | No | Unix timestamp to schedule sending (cannot combine with send) |
| `subject` | string | No | Subject for email drafts |
| `add_users` | array | No | List of user IDs to grant access to the conversation (requires organization) |
| `cc_fields` | array | No | CC recipients for email drafts |
| `to_fields` | array | Yes | List of recipients (one only for SMS/WhatsApp) |
| `bcc_fields` | array | No | BCC recipients for email drafts |
| `force_team` | boolean | No | Force association to the specified team even if already linked |
| `from_field` | string | Yes | Sender information (email, phone, or custom channel) |
| `references` | array | No | Message-ID references for threading into existing conversations |
| `attachments` | array | No | List of file attachments (up to 25, total payload <=10MB) |
| `add_to_inbox` | boolean | No | Move the draft's conversation to everyone's inbox |
| `conversation` | string | No | Conversation ID to append the draft to |
| `organization` | string | No | Organization ID to scope or link the conversation |
| `add_assignees` | array | No | List of user IDs to assign to the conversation (requires organization) |
| `auto_followup` | boolean | No | Auto-cancel scheduled draft if a reply arrives (requires send_at) |
| `add_shared_labels` | array | No | Shared label IDs to add to the conversation |
| `add_to_team_inbox` | boolean | No | Move the draft's conversation to team inbox (requires team) |
| `conversation_color` | string | No | HEX color code or 'good'/'warning'/'danger' for the conversation |
| `conversation_subject` | string | No | Subject for new conversation when using references |
| `external_response_id` | string | No | WhatsApp template ID when initiating new WhatsApp conversation |
| `remove_shared_labels` | array | No | Shared label IDs to remove from the conversation |
| `quote_previous_message` | boolean | No | Include quoted text of the last message in an existing conversation |
| `external_response_variables` | object | No | Variables for WhatsApp template interpolation |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Missive Post

**Slug:** `MISSIVE_CREATE_POST`

Tool to create a post in a Missive conversation. Posts can add comments, close conversations, assign users, apply labels, and trigger other actions. Recommended approach for managing conversations from integrations and automations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Plain text content of the post |
| `close` | boolean | No | Close the conversation after creating the post |
| `reopen` | boolean | No | Reopen the conversation if it was previously closed |
| `snooze` | integer | No | Unix timestamp to snooze the conversation until |
| `markdown` | string | No | Markdown-formatted content of the post |
| `add_to_inbox` | boolean | No | Move the conversation to inbox |
| `conversation` | string | Yes | Conversation ID to create the post in |
| `notification` | object | Yes | Notification settings with title and body (both required) |
| `organization` | string | No | Organization ID - required when using add_assignees parameter |
| `add_assignees` | array | No | User IDs to assign to the conversation |
| `remove_assignees` | array | No | User IDs to unassign from the conversation |
| `add_shared_labels` | array | No | Shared label IDs to add to the conversation |
| `remove_shared_labels` | array | No | Shared label IDs to remove from the conversation |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Canned Response

**Slug:** `MISSIVE_CREATE_RESPONSE`

Tool to create one or more canned responses (templates) in Missive. Use when you need to save reusable message templates for the organization or user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `responses` | array | Yes | Array of response objects to create |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Shared Label

**Slug:** `MISSIVE_CREATE_SHARED_LABEL`

Tool to create one or more shared labels at the organization level. Use when you need to create new labels that can be shared across the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shared_labels` | array | Yes | Array of shared label objects to create (at least one required) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Missive Task

**Slug:** `MISSIVE_CREATE_TASK`

Tool to create a task in Missive. Use when you need to create standalone tasks, conversation-linked subtasks, or team tasks. You can find or create parent conversations using message references (like email Message-IDs).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | Team ID (required for standalone tasks unless assignees specified) |
| `state` | string ("todo" | "in_progress" | "closed") | No | Task state enum. |
| `title` | string | Yes | Task title (max 1000 chars) |
| `due_at` | integer | No | Unix timestamp for due date |
| `subject` | string | No | Subject for new conversation when using references |
| `subtask` | boolean | No | Whether this is a subtask within a conversation |
| `add_users` | array | No | User IDs to add to parent conversation for subtasks |
| `assignees` | array | No | Array of user IDs (required for standalone tasks unless team specified) |
| `references` | array | No | Message references (like email Message-IDs) to find/create parent conversation |
| `description` | string | No | Task description (max 10000 chars) |
| `conversation` | string | No | Conversation ID for subtasks |
| `organization` | string | Yes | Organization ID where the task will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Team

**Slug:** `MISSIVE_CREATE_TEAM`

Tool to create a new team in an organization. Use when you need to set up a new team with active members and optional observers. The API token must belong to an organization admin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `teams` | array | Yes | Array of team objects to create (typically one team per request) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `MISSIVE_CREATE_WEBHOOK`

Tool to create a webhook subscription. Use after choosing event type and target URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The webhook URL to receive event notifications. |
| `type` | string ("incoming_email" | "incoming_sms_message" | "incoming_facebook_message" | "incoming_whatsapp_message" | "incoming_twilio_chat_message" | "new_comment") | Yes | Event type to subscribe to. |
| `author` | string | No | (new_comment only) Only trigger for comments by this user ID. |
| `from_eq` | string | No | (incoming_email only) Only trigger for messages from this exact address. |
| `is_task` | boolean | No | (new_comment only) Only trigger for comments on tasks. |
| `mention` | string | No | (new_comment only) Only trigger when this user ID is mentioned. |
| `organization` | string | No | Organization ID to scope the subscription. Omit for personal webhooks. |
| `content_contains` | string | No | Only trigger when content contains this substring. |
| `subject_contains` | string | No | (incoming_email only) Only trigger when email subject contains this text. |
| `content_ends_with` | string | No | Only trigger when content ends with this substring. |
| `content_starts_with` | string | No | Only trigger when content starts with this substring. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Draft

**Slug:** `MISSIVE_DELETE_DRAFT`

Tool to delete a draft from a conversation by draft ID. Use after confirming the draft ID; this operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the draft to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Post

**Slug:** `MISSIVE_DELETE_POST`

Tool to delete a post from a conversation by post ID. Use when you need to remove a specific post; this operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the post to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Saved Responses

**Slug:** `MISSIVE_DELETE_RESPONSES`

Tool to delete one or more saved responses by ID. For organization responses, the API token must belong to an admin. Use after confirming the response ID(s); this operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Response ID to delete. To delete multiple responses, provide comma-separated IDs (e.g., 'id1,id2,id3'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `MISSIVE_DELETE_WEBHOOK`

Tool to delete a webhook subscription by webhook ID. Use after confirming the webhook ID; this operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Analytics Report

**Slug:** `MISSIVE_GET_ANALYTICS_REPORT`

Tool to fetch a completed analytics report using its ID. Use when you need to retrieve analytics data after creating a report. Reports typically complete within 2-3 seconds but may take up to 30 seconds. Reports expire 60 seconds after completion and return 404 if incomplete, expired, or non-existent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Report ID returned by Create Analytics Report request (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Missive Contact

**Slug:** `MISSIVE_GET_CONTACT`

Tool to fetch a specific contact using the contact ID. Use when you need detailed contact information including names, contact info, and organizational memberships. Returns 404 for deleted contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the contact to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Missive Conversation

**Slug:** `MISSIVE_GET_CONVERSATION`

Tool to fetch full conversation metadata (assignees/users/labels/team/org) for a specific conversation ID. Use when you need conversation-level details for assignment, labeling, or workflow purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the conversation to retrieve. Note: Missive may return a different conversation ID if conversations were merged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Conversation Messages

**Slug:** `MISSIVE_GET_CONVERSATION_MESSAGES`

Tool to list messages belonging to a Missive conversation (newest first). Use when you need to retrieve message metadata including participants and attachments references for a specific conversation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The conversation identifier |
| `limit` | integer | No | Number of messages returned. Default: 10. Min: 2. Max: 10 |
| `until` | integer | No | Timestamp value in Unix time used to paginate. Use the delivered_at of the oldest message from previous page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Missive Message

**Slug:** `MISSIVE_GET_MESSAGE`

Tool to fetch full message details including headers, HTML body, and attachments. Use when you need complete message content with download URLs for attachments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Message ID (can pass multiple comma-separated IDs to retrieve multiple messages) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Missive Response

**Slug:** `MISSIVE_GET_RESPONSE`

Tool to fetch a specific saved response using the response ID. Use when you need to retrieve the full content and metadata of a saved response template.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Response ID (UUID format) to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Missive Task

**Slug:** `MISSIVE_GET_TASK`

Tool to get a single task by ID with full details including assignees, team, and conversation info. Use when you need to retrieve complete information about a specific task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Contact Books

**Slug:** `MISSIVE_LIST_CONTACT_BOOKS`

Tool to list contact books the authenticated user has access to. Use when you need contact book IDs for creating contacts programmatically.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of contact books to return. Min: 1. Max: 200. Default: 50. |
| `offset` | integer | No | Offset for pagination. Default: 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Contact Groups

**Slug:** `MISSIVE_LIST_CONTACT_GROUPS`

Tool to list contact groups or organizations linked to a contact book. Use when you need to retrieve groups for organizing contacts or organizations for linking contacts to businesses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("group" | "organization") | Yes | Type of contact group to list: group for contact labels or organization for business entities. |
| `limit` | integer | No | Number of contact groups to return. Max: 200. Default: 50. |
| `offset` | integer | No | Offset for pagination. Use to fetch subsequent pages of results. |
| `contact_book` | string | Yes | Contact book ID to list groups from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Contacts

**Slug:** `MISSIVE_LIST_CONTACTS`

Tool to list contacts from a contact book. Use when syncing Missive contacts to another service or finding contacts based on search terms. Supports pagination via offset and filtering by modification date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of contacts returned. Default 50, Max 200. |
| `order` | string ("last_name" | "last_modified") | No | Order by field for listing contacts. |
| `offset` | integer | No | Offset for pagination. Use to skip N contacts. |
| `search` | string | No | Search term to filter contacts by name, email, or other fields. |
| `contact_book` | string | Yes | Contact book ID to list contacts from. Required. |
| `modified_since` | integer | No | Unix timestamp to filter contacts modified since this time. |
| `include_deleted` | boolean | No | Include deleted contacts when using modified_since. Only works with modified_since parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Conversation Comments

**Slug:** `MISSIVE_LIST_CONVERSATION_COMMENTS`

Tool to list comments in a Missive conversation ordered from newest to oldest. Use when you need to retrieve comments with author info, attachments, and task data for a specific conversation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The conversation identifier |
| `limit` | integer | No | Number of comments returned. Default: 10. Max: 10 |
| `until` | integer | No | Unix timestamp for pagination. Use created_at of the oldest comment from previous page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Conversation Drafts

**Slug:** `MISSIVE_LIST_CONVERSATION_DRAFTS`

Tool to list draft messages in a Missive conversation (newest first). Use when you need to retrieve unsent drafts for a specific conversation including author and recipient details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The conversation identifier |
| `limit` | integer | No | Number of drafts returned. Default: 10. Max: 10 |
| `until` | integer | No | Unix timestamp for pagination. Use delivered_at of the oldest draft from previous page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Conversation Posts

**Slug:** `MISSIVE_LIST_CONVERSATION_POSTS`

Tool to list posts in a Missive conversation ordered by newest first. Use when you need to view automation traces or post history for a specific conversation. Posts are the recommended approach for automations as they leave a visible trace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The conversation identifier |
| `limit` | integer | No | Number of posts returned |
| `until` | integer | No | Unix timestamp for pagination. Use created_at from the oldest post of previous page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Conversations

**Slug:** `MISSIVE_LIST_CONVERSATIONS`

Tool to list conversations visible to the authenticated user ordered by newest activity first. Use when you need to retrieve inbox, all, assigned, closed, or other mailbox conversations. Must filter by at least one of: mailbox flag, shared label, or team parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `all` | boolean | No | Pass true to list conversations in the All mailbox. |
| `email` | string | No | Filter conversations by email address. Returns conversations where this email appears as sender or recipient. |
| `inbox` | boolean | No | Pass true to list conversations in the Inbox. |
| `limit` | integer | No | Number of conversations to return. Min: 2. Max: 50. Default: 25. |
| `until` | integer | No | Unix timestamp for pagination. Use last_activity_at from the oldest conversation of previous page. |
| `closed` | boolean | No | Pass true to list conversations in Closed. |
| `domain` | string | No | Filter conversations by domain. Returns conversations where any sender/recipient email belongs to this domain. |
| `drafts` | boolean | No | Pass true to list conversations in Drafts. |
| `junked` | boolean | No | Pass true to list conversations in Spam. |
| `flagged` | boolean | No | Pass true to list conversations in Starred. |
| `snoozed` | boolean | No | Pass true to list conversations in Snoozed. |
| `trashed` | boolean | No | Pass true to list conversations in Trash. |
| `assigned` | boolean | No | Pass true to list conversations assigned to the user. |
| `team_all` | string | No | Team ID to list conversations in team's All mailbox. |
| `team_inbox` | string | No | Team ID to list conversations in team's Inbox. |
| `team_closed` | string | No | Team ID to list conversations in team's Closed mailbox. |
| `organization` | string | No | Organization ID. Filter conversations to only those shared with the organization. |
| `shared_label` | string | No | Shared label ID to list conversations in that label. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Messages by Message-ID

**Slug:** `MISSIVE_LIST_MESSAGES`

Tool to fetch messages matching an email Message-ID header. Use when you need to find a specific message by its Message-ID. Most of the time, only one message matches a given Message-ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_message_id` | string | Yes | Email Message-ID header value to search for. Most of the time, only one message matches a given Message-ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Organizations

**Slug:** `MISSIVE_LIST_ORGANIZATIONS`

Tool to list organizations the authenticated user is part of. Use when you need to retrieve all organizations accessible to the current user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of organizations to return. Max: 200. Default: 50. |
| `offset` | integer | No | Offset for pagination. Default: 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Saved Responses

**Slug:** `MISSIVE_LIST_RESPONSES`

Tool to list saved responses (canned responses/templates) for the authenticated user. Use when you need to retrieve available response templates for composing messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of responses to return. Use for pagination. |
| `offset` | integer | No | Number of responses to skip. Use for pagination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Shared Labels

**Slug:** `MISSIVE_LIST_SHARED_LABELS`

Tool to list shared labels (organization-level labels) available to the authenticated user. Use when you need to retrieve labels for filtering conversations or understanding label structure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of labels to return. Use for pagination. |
| `offset` | integer | No | Offset for pagination. Number of labels to skip before returning results. |
| `organization` | string | No | Organization ID to filter labels. If not specified, returns labels from all organizations the user is part of. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Tasks

**Slug:** `MISSIVE_LIST_TASKS`

Tool to list tasks accessible to the authenticated user. Use when you need to retrieve tasks by state, organization, or team. Tasks can be standalone, conversation-linked, or team tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | Team ID to filter tasks by team. |
| `limit` | integer | No | Number of tasks to return. Must be between 1 and 100. |
| `state` | string ("todo" | "in_progress" | "closed") | No | Task state values. |
| `offset` | integer | No | Offset for pagination. Use to skip a number of tasks. |
| `organization` | string | No | Organization ID to filter tasks by organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Teams

**Slug:** `MISSIVE_LIST_TEAMS`

Tool to list all teams. Use when you need to retrieve and enumerate all teams available in Missive. Returns an empty array for accounts with no teams configured; this is a valid response, not an error.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Missive Users

**Slug:** `MISSIVE_LIST_USERS`

Tool to list all users. Use after authentication when you need to retrieve all users in the organization.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Merge Missive Conversations

**Slug:** `MISSIVE_MERGE_CONVERSATIONS`

Tool to merge multiple conversations into one. Combines messages, posts, and other content from the source conversation into the target conversation. Use when you need to consolidate related conversations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Source conversation ID to merge from. This conversation will be merged into the target conversation. |
| `target` | string | Yes | Target conversation ID to merge into. The source conversation will be merged into this conversation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Missive Contact

**Slug:** `MISSIVE_UPDATE_CONTACT`

Tool to update one or more contacts in Missive. Use when you need to modify contact attributes. Only pass fields you want to update. CRITICAL: infos and memberships arrays must include ALL items when passed - omitted entries will be permanently deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contacts` | array | Yes | Array of contact objects with id and attributes to update. Only include fields you want to change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Saved Response

**Slug:** `MISSIVE_UPDATE_RESPONSE`

Tool to update one or more saved responses in Missive. Use when you need to modify existing response templates by changing title, body, subject, or other attributes. Returns the updated responses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Response ID to update. Can pass multiple comma-separated IDs for bulk update |
| `responses` | array | Yes | Array of response objects to update. Each must include the 'id' field and the attributes to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Shared Labels

**Slug:** `MISSIVE_UPDATE_SHARED_LABELS`

Tool to update one or more shared labels in Missive. Use when you need to modify label names or colors. Returns the updated shared labels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Shared label ID in the path. Can pass multiple comma-separated IDs to update multiple labels. |
| `shared_labels` | array | Yes | Array of shared label objects with id and attributes to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Missive Task

**Slug:** `MISSIVE_UPDATE_TASK`

Tool to update an existing task's attributes in Missive. Use when you need to modify a task's description, change its state, update the due date, or reassign it to different users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the task to update |
| `tasks` | object | Yes | Task attributes to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Missive Team

**Slug:** `MISSIVE_UPDATE_TEAM`

Tool to update one or more teams in Missive. Use when you need to modify team attributes like name, color, or initials. The API token must belong to an organization admin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Team ID or comma-separated list of team IDs to update |
| `teams` | array | Yes | Array of team objects with id and attributes to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |