> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/missive.md).

# Missive

Connect to Missive to access and manage your team's unified inbox, conversations, and collaboration features.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Missive   | API Key        |

#### Missive

Connect to Missive API to access and manage your team's unified inbox, conversations, and collaboration features.

**Set up in Missive**

1. Sign in to Missive and open Settings.
2. Go to the API section and create a new API token.
3. Copy the generated token and treat it like a password.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Missive**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                 |
| ------------- | -------- | --------------------------------------------- |
| API Key       | Yes      | Get your Missive API key from Settings > API. |

**Provider documentation:** [Setup reference](https://learn.missiveapp.com/api-documentation/getting-started).

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Missive** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### List Conversations

List conversations from Missive with filtering support. Retrieves all conversations from current time until the specified 'until' timestamp (up to 500 max).

**Inputs**

| Field                  | Type    | Required | Description                                                                                                                               |
| ---------------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Until (Unix Timestamp) | string  | Yes      | Unix timestamp (as string). Returns all conversations from current time until this timestamp. Maximum 500 conversations will be returned. |
| Inbox                  | boolean | No       | Filter to conversations in Inbox.                                                                                                         |
| All Mailbox            | boolean | No       | Filter to conversations in All mailbox.                                                                                                   |
| Assigned               | boolean | No       | Filter to conversations assigned to the user.                                                                                             |
| Closed                 | boolean | No       | Filter to closed conversations.                                                                                                           |
| Snoozed                | boolean | No       | Filter to snoozed conversations.                                                                                                          |
| Starred                | boolean | No       | Filter to starred conversations.                                                                                                          |
| Trash                  | boolean | No       | Filter to conversations in Trash.                                                                                                         |
| Spam                   | boolean | No       | Filter to conversations in Spam.                                                                                                          |
| Drafts                 | boolean | No       | Filter to draft conversations.                                                                                                            |
| Shared Label ID        | string  | No       | Filter to conversations in a shared label (provide label ID).                                                                             |
| Team ID (Inbox)        | string  | No       | Filter to team's Inbox (provide team ID).                                                                                                 |
| Team ID (Closed)       | string  | No       | Filter to team's Closed mailbox (provide team ID).                                                                                        |
| Team ID (All)          | string  | No       | Filter to team's All mailbox (provide team ID).                                                                                           |
| Organization ID        | string  | No       | Filter to conversations shared with an organization.                                                                                      |
| Email Address          | string  | No       | Filter by email address (sender or recipient).                                                                                            |
| Email Domain           | string  | No       | Filter by email domain (sender or recipient).                                                                                             |

**Outputs**

| Field         | Type          | Description                                                                     |
| ------------- | ------------- | ------------------------------------------------------------------------------- |
| Conversations | object\_array | List of conversation objects from Missive.                                      |
| Count         | integer       | Number of conversations returned in this page.                                  |
| Has More      | boolean       | Whether there are more conversations available (true if 500 limit was reached). |

#### Get Conversation

Get a specific conversation from Missive by ID

**Inputs**

| Field        | Type            | Required | Description                                                                                  |
| ------------ | --------------- | -------- | -------------------------------------------------------------------------------------------- |
| Conversation | select (string) | Yes      | Select a conversation or enter a conversation ID. Options load from the selected connection. |

**Outputs**

| Field        | Type   | Description                           |
| ------------ | ------ | ------------------------------------- |
| Conversation | object | The conversation object from Missive. |

#### Get Message(s) by ID

Get one or more messages from Missive by their IDs

**Inputs**

| Field       | Type   | Required | Description                                      |
| ----------- | ------ | -------- | ------------------------------------------------ |
| Message IDs | string | Yes      | Comma-separated list of message IDs to retrieve. |

**Outputs**

| Field    | Type          | Description                           |
| -------- | ------------- | ------------------------------------- |
| Messages | object\_array | List of message objects from Missive. |

#### List Conversation Messages

List messages in a conversation from Missive. Retrieves all messages from current time until the specified 'until' timestamp (up to 100 max).

**Inputs**

| Field                  | Type            | Required | Description                                                                                                                     |
| ---------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Conversation           | select (string) | Yes      | Select a conversation or enter a conversation ID. Options load from the selected connection.                                    |
| Until (Unix Timestamp) | string          | Yes      | Unix timestamp (as string). Returns all messages from current time until this timestamp. Maximum 100 messages will be returned. |

**Outputs**

| Field    | Type          | Description                                                                |
| -------- | ------------- | -------------------------------------------------------------------------- |
| Messages | object\_array | List of message objects from Missive.                                      |
| Count    | integer       | Number of messages returned.                                               |
| Has More | boolean       | Whether there are more messages available (true if 100 limit was reached). |

#### List Conversation Comments

List comments in a conversation from Missive. Retrieves all comments from current time until the specified 'until' timestamp (up to 100 max).

**Inputs**

| Field                  | Type            | Required | Description                                                                                                                     |
| ---------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Conversation           | select (string) | Yes      | Select a conversation or enter a conversation ID. Options load from the selected connection.                                    |
| Until (Unix Timestamp) | string          | Yes      | Unix timestamp (as string). Returns all comments from current time until this timestamp. Maximum 100 comments will be returned. |

**Outputs**

| Field    | Type          | Description                                                                |
| -------- | ------------- | -------------------------------------------------------------------------- |
| Comments | object\_array | List of comment objects from Missive.                                      |
| Count    | integer       | Number of comments returned.                                               |
| Has More | boolean       | Whether there are more comments available (true if 100 limit was reached). |

#### List Conversation Posts

List posts in a conversation from Missive. Retrieves all posts from current time until the specified 'until' timestamp (up to 100 max).

**Inputs**

| Field                  | Type            | Required | Description                                                                                                               |
| ---------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| Conversation           | select (string) | Yes      | Select a conversation or enter a conversation ID. Options load from the selected connection.                              |
| Until (Unix Timestamp) | string          | Yes      | Unix timestamp (as string). Returns all posts from current time until this timestamp. Maximum 100 posts will be returned. |

**Outputs**

| Field    | Type          | Description                                                             |
| -------- | ------------- | ----------------------------------------------------------------------- |
| Posts    | object\_array | List of post objects from Missive.                                      |
| Count    | integer       | Number of posts returned.                                               |
| Has More | boolean       | Whether there are more posts available (true if 100 limit was reached). |

#### Create Post

Create a post in a Missive conversation

**Inputs**

| Field                             | Type            | Required | Description                                                                                                       |
| --------------------------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| Notification Title                | string          | Yes      | Title for the notification (required).                                                                            |
| Notification Body                 | string          | Yes      | Body text for the notification (required).                                                                        |
| Text                              | textarea        | No       | Main post message as plain text.                                                                                  |
| Markdown                          | textarea        | No       | Main post message as markdown.                                                                                    |
| Attachments (JSON)                | string          | No       | Array of attachment objects as JSON string.                                                                       |
| Username                          | string          | No       | Override author name (instead of token owner).                                                                    |
| Username Icon URL                 | string          | No       | Override author avatar (URL).                                                                                     |
| Conversation                      | select (string) | No       | Select or enter an existing conversation to append post to (optional). Options load from the selected connection. |
| References (JSON Array)           | string          | No       | Array of Message-ID strings to append to existing conversation.                                                   |
| Conversation Icon URL             | string          | No       | Icon URL for how conversation appears in list.                                                                    |
| Conversation Subject              | string          | No       | Subject for how conversation appears in list.                                                                     |
| Conversation Color                | string          | No       | Color for how conversation appears in list.                                                                       |
| Organization ID                   | string          | No       | Organization ID (needed for add\_users/add\_assignees).                                                           |
| Team ID                           | string          | No       | Team ID to link conversation to (ignored if already linked).                                                      |
| Force Team                        | boolean         | No       | Force new team even if conversation already linked elsewhere.                                                     |
| Add Users (JSON Array)            | string          | No       | Array of user IDs to grant conversation access (requires organization).                                           |
| Add Assignees (JSON Array)        | string          | No       | Array of user IDs to assign (requires organization).                                                              |
| Add Shared Labels (JSON Array)    | string          | No       | Array of shared label IDs to add to conversation.                                                                 |
| Remove Shared Labels (JSON Array) | string          | No       | Array of shared label IDs to remove from conversation.                                                            |
| Add to Inbox                      | boolean         | No       | Add conversation to Inbox mailbox.                                                                                |
| Add to Team Inbox                 | boolean         | No       | Add conversation to team inbox.                                                                                   |
| Close                             | boolean         | No       | Close the conversation.                                                                                           |
| Reopen                            | boolean         | No       | Prevent closed conversations from reopening when creating post.                                                   |

**Outputs**

| Field           | Type   | Description                                         |
| --------------- | ------ | --------------------------------------------------- |
| Conversation ID | string | The ID of the conversation the post was created in. |
| Post ID         | string | The ID of the created post.                         |

#### Create Draft

Create a draft message in Missive (email, SMS, or WhatsApp)

**Inputs**

| Field                             | Type            | Required | Description                                                                                                                                                                                                                                                                                                                  |
| --------------------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Subject                           | string          | No       | Subject line for the draft.                                                                                                                                                                                                                                                                                                  |
| Body                              | textarea        | No       | Message body content (plain text or HTML).                                                                                                                                                                                                                                                                                   |
| Quote Previous Message            | boolean         | No       | Include a quoted version of the last message in the conversation.                                                                                                                                                                                                                                                            |
| From Type                         | select (string) | Yes      | Type of sender: Email or SMS & WhatsApp. Options load from the selected connection.                                                                                                                                                                                                                                          |
| From Field (JSON Object)          | string          | Yes      | For Email: JSON object with 'address' and optional 'name' keys. For SMS & WhatsApp: JSON object with 'phone\_number' key (required) and optional 'type' key. Example Email: {"address": "<philippe@missiveapp.com>", "name": "Philippe Lehoux"} Example SMS/WhatsApp: {"phone\_number": "+18005550199", "type": "whatsapp"}. |
| To Fields (JSON Array)            | string          | Yes      | For Email: Array of objects with 'address' and optional 'name' keys. For SMS & WhatsApp: Array with exactly one object with 'phone\_number' key. Example Email: \[{"address": "<philippe@missiveapp.com>", "name": "Philippe Lehoux"}] Example SMS/WhatsApp: \[{"phone\_number": "+18005550199"}].                           |
| CC Fields (JSON Array)            | string          | No       | Array of objects with 'address' and optional 'name' keys for CC recipients.                                                                                                                                                                                                                                                  |
| BCC Fields (JSON Array)           | string          | No       | Array of objects with 'address' and optional 'name' keys for BCC recipients.                                                                                                                                                                                                                                                 |
| Attachments (JSON Array)          | string          | No       | Array of attachment objects with 'base64\_data' and 'filename' keys (max 25 files, 10 MB total).                                                                                                                                                                                                                             |
| References (JSON Array)           | string          | No       | Array of Message-ID strings for appending to an existing conversation.                                                                                                                                                                                                                                                       |
| Conversation ID                   | select (string) | No       | Conversation ID string for appending to an existing conversation. Options load from the selected connection.                                                                                                                                                                                                                 |
| Team ID                           | string          | No       | Team ID string.                                                                                                                                                                                                                                                                                                              |
| Organization ID                   | string          | No       | Organization ID string.                                                                                                                                                                                                                                                                                                      |
| Add Users (JSON Array)            | string          | No       | Array of user ID strings.                                                                                                                                                                                                                                                                                                    |
| Add Assignees (JSON Array)        | string          | No       | Array of user ID strings.                                                                                                                                                                                                                                                                                                    |
| Conversation Subject              | string          | No       | Subject for the conversation.                                                                                                                                                                                                                                                                                                |
| Add Shared Labels (JSON Array)    | string          | No       | Array of shared label ID strings.                                                                                                                                                                                                                                                                                            |
| Remove Shared Labels (JSON Array) | string          | No       | Array of shared label ID strings.                                                                                                                                                                                                                                                                                            |
| Add to Inbox                      | boolean         | No       | Add conversation to Inbox mailbox.                                                                                                                                                                                                                                                                                           |
| Add to Team Inbox                 | boolean         | No       | Add conversation to team inbox.                                                                                                                                                                                                                                                                                              |
| Close                             | boolean         | No       | Close the conversation.                                                                                                                                                                                                                                                                                                      |
| Send At                           | datetime        | No       | Timestamp value in Unix time for scheduled sending.                                                                                                                                                                                                                                                                          |

**Outputs**

| Field           | Type   | Description                                                   |
| --------------- | ------ | ------------------------------------------------------------- |
| Draft ID        | string | The ID of the created draft.                                  |
| Conversation ID | string | The ID of the conversation the draft was created in (if any). |

#### Send Message

Send a message in Missive (email, SMS, or WhatsApp)

**Inputs**

| Field                             | Type            | Required | Description                                                                                                                                                                                                                                                                                                                  |
| --------------------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Subject                           | string          | No       | Subject line for the message.                                                                                                                                                                                                                                                                                                |
| Body                              | textarea        | No       | Message body content (plain text or HTML).                                                                                                                                                                                                                                                                                   |
| Quote Previous Message            | boolean         | No       | Include a quoted version of the last message in the conversation.                                                                                                                                                                                                                                                            |
| From Type                         | select (string) | Yes      | Type of sender: Email or SMS & WhatsApp. Options load from the selected connection.                                                                                                                                                                                                                                          |
| From Field (JSON Object)          | string          | Yes      | For Email: JSON object with 'address' and optional 'name' keys. For SMS & WhatsApp: JSON object with 'phone\_number' key (required) and optional 'type' key. Example Email: {"address": "<philippe@missiveapp.com>", "name": "Philippe Lehoux"} Example SMS/WhatsApp: {"phone\_number": "+18005550199", "type": "whatsapp"}. |
| To Fields (JSON Array)            | string          | Yes      | For Email: Array of objects with 'address' and optional 'name' keys. For SMS & WhatsApp: Array with exactly one object with 'phone\_number' key. Example Email: \[{"address": "<philippe@missiveapp.com>", "name": "Philippe Lehoux"}] Example SMS/WhatsApp: \[{"phone\_number": "+18005550199"}].                           |
| CC Fields (JSON Array)            | string          | No       | Array of objects with 'address' and optional 'name' keys for CC recipients.                                                                                                                                                                                                                                                  |
| BCC Fields (JSON Array)           | string          | No       | Array of objects with 'address' and optional 'name' keys for BCC recipients.                                                                                                                                                                                                                                                 |
| Attachments (JSON Array)          | string          | No       | Array of attachment objects with 'base64\_data' and 'filename' keys (max 25 files, 10 MB total).                                                                                                                                                                                                                             |
| References (JSON Array)           | string          | No       | Array of Message-ID strings for appending to an existing conversation.                                                                                                                                                                                                                                                       |
| Conversation ID                   | select (string) | No       | Conversation ID string for appending to an existing conversation. Options load from the selected connection.                                                                                                                                                                                                                 |
| Team ID                           | string          | No       | Team ID string.                                                                                                                                                                                                                                                                                                              |
| Organization ID                   | string          | No       | Organization ID string.                                                                                                                                                                                                                                                                                                      |
| Add Users (JSON Array)            | string          | No       | Array of user ID strings.                                                                                                                                                                                                                                                                                                    |
| Add Assignees (JSON Array)        | string          | No       | Array of user ID strings.                                                                                                                                                                                                                                                                                                    |
| Conversation Subject              | string          | No       | Subject for the conversation.                                                                                                                                                                                                                                                                                                |
| Add Shared Labels (JSON Array)    | string          | No       | Array of shared label ID strings.                                                                                                                                                                                                                                                                                            |
| Remove Shared Labels (JSON Array) | string          | No       | Array of shared label ID strings.                                                                                                                                                                                                                                                                                            |
| Add to Inbox                      | boolean         | No       | Add conversation to Inbox mailbox.                                                                                                                                                                                                                                                                                           |
| Add to Team Inbox                 | boolean         | No       | Add conversation to team inbox.                                                                                                                                                                                                                                                                                              |
| Close                             | boolean         | No       | Close the conversation.                                                                                                                                                                                                                                                                                                      |

**Outputs**

| Field           | Type   | Description                                                  |
| --------------- | ------ | ------------------------------------------------------------ |
| Message ID      | string | The ID of the sent message.                                  |
| Conversation ID | string | The ID of the conversation the message was sent in (if any). |

### Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

#### On Email Received

Trigger a workflow execution when a new email is received in Missive.

**Configuration**

| Field               | Type   | Required | Description                                                                                              |
| ------------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------- |
| Organization ID     | string | No       | The ID of the organization to monitor. If not provided, creates a personal webhook subscription.         |
| From Email          | string | No       | Only trigger for messages from this exact email address. Leave empty to receive emails from all senders. |
| Subject Contains    | string | No       | Only trigger for messages with this text in the subject. Leave empty to receive emails with any subject. |
| Content Contains    | string | No       | Only trigger when email content contains this text. Leave empty to receive all emails.                   |
| Content Starts With | string | No       | Only trigger when email content starts with this text. Leave empty to receive all emails.                |
| Content Ends With   | string | No       | Only trigger when email content ends with this text. Leave empty to receive all emails.                  |

**Event inputs**

| Field           | Type     | Required | Description                                                                |
| --------------- | -------- | -------- | -------------------------------------------------------------------------- |
| Message ID      | string   | No       | The ID of the email message in Missive.                                    |
| Conversation ID | string   | No       | The ID of the conversation in Missive.                                     |
| From Email      | string   | No       | The email address of the sender.                                           |
| From Name       | string   | No       | The display name of the sender (if available).                             |
| Subject         | string   | No       | The subject of the email.                                                  |
| Body            | string   | No       | The preview/body content of the email (preview text from webhook payload). |
| Received At     | datetime | No       | The timestamp when the email was received.                                 |

**Outputs**

| Field           | Type     | Description                                    |
| --------------- | -------- | ---------------------------------------------- |
| Message ID      | string   | The ID of the email message in Missive.        |
| Conversation ID | string   | The ID of the conversation in Missive.         |
| From Email      | string   | The email address of the sender.               |
| From Name       | string   | The display name of the sender (if available). |
| Subject         | string   | The subject of the email.                      |
| Body            | string   | The body/content of the email.                 |
| Received At     | datetime | The timestamp when the email was received.     |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/missive.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
