Skip to main content
Missive logo
  • Category: email
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 40
  • Triggers: 0
  • Slug: MISSIVE
  • Version: 20261101_00

Tools

Slug: MISSIVE_CREATE_ANALYTICS_REPORTTool 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

object
required
Report specifications including organization, period, and optional filters

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_CONTACTSTool 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

array
required
Array of contact objects to create. Each contact must include contact_book UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_DRAFTCreate a Missive draft for email, SMS, WhatsApp, or Live Chat, for later editing or scheduling. The draft can also be sent immediately upon creation.

Input Parameters

string
required
HTML or text body of the draft. Use '
' for paragraphs.
boolean
Send the draft immediately upon creation
string
Team ID to link the draft’s conversation
boolean
Close the conversation after draft creation
string
Account ID for custom channels or live chat
integer
Unix timestamp to schedule sending (cannot combine with send)
string
Subject for email drafts
array
List of user IDs to grant access to the conversation (requires organization)
array
CC recipients for email drafts
array
required
List of recipients (one only for SMS/WhatsApp)
array
BCC recipients for email drafts
boolean
Force association to the specified team even if already linked
string
required
Sender information (email, phone, or custom channel)
array
Message-ID references for threading into existing conversations
array
List of file attachments (up to 25, total payload <=10MB)
boolean
Move the draft’s conversation to everyone’s inbox
string
Conversation ID to append the draft to
string
Organization ID to scope or link the conversation
array
List of user IDs to assign to the conversation (requires organization)
boolean
Auto-cancel scheduled draft if a reply arrives (requires send_at)
array
Shared label IDs to add to the conversation
boolean
Move the draft’s conversation to team inbox (requires team)
string
HEX color code or ‘good’/‘warning’/‘danger’ for the conversation
string
Subject for new conversation when using references
string
WhatsApp template ID when initiating new WhatsApp conversation
array
Shared label IDs to remove from the conversation
boolean
Include quoted text of the last message in an existing conversation
object
Variables for WhatsApp template interpolation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_POSTCreate a post in an existing Missive conversation, optionally closing it, assigning users, applying labels, or moving it to the inbox. Posts provide a visible trace for integration and automation actions.

Input Parameters

string
Plain text content of the post
boolean
Close the conversation after creating the post
boolean
Reopen the conversation if it was previously closed
integer
Unix timestamp to snooze the conversation until
string
Markdown-formatted content of the post
boolean
Move the conversation to inbox
string
required
Conversation ID to create the post in
object
required
Notification settings with title and body (both required)
string
Organization ID - required when using add_assignees parameter
array
User IDs to assign to the conversation
array
User IDs to unassign from the conversation
array
Shared label IDs to add to the conversation
array
Shared label IDs to remove from the conversation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_RESPONSETool 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

array
required
Array of response objects to create

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_SHARED_LABELTool 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

array
required
Array of shared label objects to create (at least one required)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_TASKTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_TEAMCreate a team in an organization with active members and optional observers. The API token must belong to an organization admin or owner.

Input Parameters

array
required
Array of team objects to create (typically one team per request)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_CREATE_WEBHOOKTool to create a webhook subscription. Use after choosing event type and target URL.

Input Parameters

string
required
The webhook URL to receive event notifications.
string ("incoming_email" | "incoming_sms_message" | "incoming_facebook_message" | "incoming_whatsapp_message" | "incoming_twilio_chat_message" | "new_comment")
required
Event type to subscribe to.
string
(new_comment only) Only trigger for comments by this user ID.
string
(incoming_email only) Only trigger for messages from this exact address.
boolean
(new_comment only) Only trigger for comments on tasks.
string
(new_comment only) Only trigger when this user ID is mentioned.
string
Organization ID to scope the subscription. Omit for personal webhooks.
string
Only trigger when content contains this substring.
string
(incoming_email only) Only trigger when email subject contains this text.
string
Only trigger when content ends with this substring.
string
Only trigger when content starts with this substring.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_DELETE_DRAFTTool to delete a draft from a conversation by draft ID. Use after confirming the draft ID; this operation cannot be undone.

Input Parameters

string
required
Unique identifier of the draft to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_DELETE_POSTDelete a post from a conversation by post ID. For conversations shared with an organization, the API token must belong to an organization owner or admin.

Input Parameters

string
required
Unique identifier of the post to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_DELETE_RESPONSESDelete one or more saved responses by ID; responses created by external integrations cannot be deleted through this endpoint. For organizations with restricted response management enabled, only owners and admins can delete organization responses.

Input Parameters

string
required
Response ID to delete. To delete multiple responses, provide comma-separated IDs (e.g., ‘id1,id2,id3’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_DELETE_WEBHOOKTool to delete a webhook subscription by webhook ID. Use after confirming the webhook ID; this operation cannot be undone.

Input Parameters

string
required
Unique identifier of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_ANALYTICS_REPORTFetch a completed analytics report by ID. Reports typically complete within 2–3 seconds but may take 30 seconds or more, expire 60 seconds after completion, and return 404 when incomplete, expired, or nonexistent.

Input Parameters

string
required
Report ID returned by Create Analytics Report request (UUID format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_CONTACTTool 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

string
required
The unique identifier of the contact to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_CONVERSATIONFetch conversation metadata by ID, including assignees, users, labels, team and organization. Guest-only conversation data may not satisfy the tool’s required response fields; merged conversations may return a different ID.

Input Parameters

string
required
The ID of the conversation to retrieve. Note: Missive may return a different conversation ID if conversations were merged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_CONVERSATION_MESSAGESTool 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

string
required
The conversation identifier
integer
Number of messages returned. Default: 10. Min: 2. Max: 10
integer
Timestamp value in Unix time used to paginate. Use the delivered_at of the oldest message from previous page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_MESSAGEFetch message details by ID, including headers, HTML body and attachment download URLs when available. Sensitive fields may be redacted when the token user is not related to the message.

Input Parameters

string
required
Message ID (can pass multiple comma-separated IDs to retrieve multiple messages)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_RESPONSETool 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

string
required
Response ID (UUID format) to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_GET_TASKTool 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

string
required
Task ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONTACT_BOOKSTool to list contact books the authenticated user has access to. Use when you need contact book IDs for creating contacts programmatically.

Input Parameters

integer
Number of contact books to return. Min: 1. Max: 200. Default: 50.
integer
Offset for pagination. Default: 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONTACT_GROUPSTool 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

string ("group" | "organization")
required
Type of contact group to list: group for contact labels or organization for business entities.
integer
Number of contact groups to return. Max: 200. Default: 50.
integer
Offset for pagination. Use to fetch subsequent pages of results.
string
required
Contact book ID to list groups from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONTACTSTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONVERSATION_COMMENTSTool 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

string
required
The conversation identifier
integer
Number of comments returned. Default: 10. Max: 10
integer
Unix timestamp for pagination. Use created_at of the oldest comment from previous page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONVERSATION_DRAFTSTool 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

string
required
The conversation identifier
integer
Number of drafts returned. Default: 10. Max: 10
integer
Unix timestamp for pagination. Use delivered_at of the oldest draft from previous page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONVERSATION_POSTSList posts in a Missive conversation, newest first. The returned post objects omit the main text and markdown fields.

Input Parameters

string
required
The conversation identifier
integer
Number of posts returned
integer
Unix timestamp for pagination. Use created_at from the oldest post of previous page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_CONVERSATIONSList conversations visible to the authenticated user, ordered by newest activity first, using a required mailbox, shared label, or team filter. Responses containing guest conversations with limited data may fail validation.

Input Parameters

boolean
Pass true to list conversations in the All mailbox.
string
Filter conversations by email address. Returns conversations where this email appears as sender or recipient.
boolean
Pass true to list conversations in the Inbox.
integer
Number of conversations to return. Min: 2. Max: 50. Default: 25.
integer
Unix timestamp for pagination. Use last_activity_at from the oldest conversation of previous page.
boolean
Pass true to list conversations in Closed.
string
Filter conversations by domain. Returns conversations where any sender/recipient email belongs to this domain.
boolean
Pass true to list conversations in Drafts.
boolean
Pass true to list conversations in Spam.
boolean
Pass true to list conversations in Starred.
boolean
Pass true to list conversations in Snoozed.
boolean
Pass true to list conversations in Trash.
boolean
Pass true to list conversations assigned to the user.
string
Team ID to list conversations in team’s All mailbox.
string
Team ID to list conversations in team’s Inbox.
string
Team ID to list conversations in team’s Closed mailbox.
string
Organization ID. Filter conversations to only those shared with the organization.
string
Shared label ID to list conversations in that label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_MESSAGESTool 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

string
required
Email Message-ID header value to search for. Most of the time, only one message matches a given Message-ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_ORGANIZATIONSTool to list organizations the authenticated user is part of. Use when you need to retrieve all organizations accessible to the current user.

Input Parameters

integer
Number of organizations to return. Max: 200. Default: 50.
integer
Offset for pagination. Default: 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_RESPONSESTool 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

integer
Number of responses to return. Use for pagination.
integer
Number of responses to skip. Use for pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_SHARED_LABELSList shared labels accessible to the authenticated user, optionally filtered by organization. Use limit and offset to paginate results when finding labels for conversations or exploring their hierarchy; the default page size is 50 and the maximum is 200.

Input Parameters

integer
Number of labels to return. Use for pagination.
integer
Offset for pagination. Number of labels to skip before returning results.
string
Organization ID to filter labels. If not specified, returns labels from all organizations the user is part of.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_TASKSTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_TEAMSList teams accessible to the authenticated user in their organizations. Use limit and offset to paginate; the default page size is 50 and the maximum is 200. An empty list is a valid result when no teams are available.

Input Parameters

integer
Number of teams to return. Max: 200. Default: 50.
integer
Offset for pagination. Default: 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_LIST_USERSList users in organizations the authenticated user belongs to. Use limit and offset to paginate; the default page size is 50 and the maximum is 200.

Input Parameters

integer
Number of users to return. Max: 200. Default: 50.
integer
Offset for pagination. Default: 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_MERGE_CONVERSATIONSMerge a source Missive conversation into a target, combining their messages, posts, and other entries. The returned conversation ID may differ from the requested target if Missive swaps the conversations during the merge.

Input Parameters

string
required
Source conversation ID to merge from. This conversation will be merged into the target conversation.
string
required
Target conversation ID to merge into. The source conversation will be merged into this conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_UPDATE_CONTACTTool 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

array
required
Array of contact objects with id and attributes to update. Only include fields you want to change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_UPDATE_RESPONSEUpdate one or more saved response templates, including their title, body, subject, and other attributes; externally integrated responses cannot be updated. When attachments are supplied, omitted existing attachments are removed.

Input Parameters

string
required
Response ID to update. Can pass multiple comma-separated IDs for bulk update
array
required
Array of response objects to update. Each must include the ‘id’ field and the attributes to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_UPDATE_SHARED_LABELSUpdate the names and colors of one or more Missive shared labels and return the updated labels. Each label update requires both a name and a color.

Input Parameters

string
required
Shared label ID in the path. Can pass multiple comma-separated IDs to update multiple labels.
array
required
Array of shared label objects with id and attributes to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_UPDATE_TASKUpdate an existing Missive task by ID. Change its description, state, due date, or assignees, and receive the updated task details.

Input Parameters

string
required
The ID of the task to update
object
required
Task attributes to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MISSIVE_UPDATE_TEAMTool 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

string
required
Team ID or comma-separated list of team IDs to update
array
required
Array of team objects with id and attributes to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not