missive_list_conversations
Retrieve conversations from your Missive team inbox filtered by mailbox, label, team, or contact. Results sorted by newest activity, with pagination support.
Instructions
Lists conversations visible to the API-token user (GET /conversations), newest activity first. REQUIRES at least one mailbox filter: a boolean (inbox, all, assigned, closed, snoozed, flagged, trashed, junked, drafts) or an ID filter (shared_label, team_inbox, team_closed, team_all). organization is an optional filter (falls back to MISSIVE_DEFAULT_ORGANIZATION, omitted otherwise). email/domain/contact_organization are mutually exclusive. Paginate with until = last_activity_at of the oldest conversation from the previous page. Read-only. Conversations where you are only a guest return just id and last_activity_at.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Pass true to list conversations in the All mailbox. | |
| No | Filter by a specific contact email address (e.g. user@example.com). Mutually exclusive with `domain` and `contact_organization` — pass at most one of the three. | ||
| inbox | No | Pass true to list conversations in the Inbox. | |
| limit | No | Number of conversations to return. Default 25, max 50. | |
| until | No | Unix timestamp used to paginate: the `last_activity_at` of the oldest conversation from the previous page. | |
| closed | No | Pass true to list conversations in Closed. | |
| domain | No | Filter by contacts from an email domain (e.g. example.com, no leading @). Mutually exclusive with `domain` and `contact_organization` — pass at most one of the three. | |
| drafts | No | Pass true to list conversations in Drafts. | |
| junked | No | Pass true to list conversations in Spam (a.k.a. Junk). | |
| flagged | No | Pass true to list conversations in Starred (flagged). | |
| snoozed | No | Pass true to list conversations in Snoozed. | |
| trashed | No | Pass true to list conversations in Trash. | |
| assigned | No | Pass true to list conversations assigned to the user. | |
| team_all | No | Team ID. List conversations in the team's All mailbox. | |
| team_inbox | No | Team ID. List conversations in the team's Inbox. | |
| team_closed | No | Team ID. List conversations in the team's Closed mailbox. | |
| organization | No | Optional organization ID filter. Falls back to MISSIVE_DEFAULT_ORGANIZATION; omitted entirely when neither is set. No effect when a shared_label or team_ filter is used. | |
| shared_label | No | Shared label ID. List conversations carrying this shared label. | |
| contact_organization | No | Contact organization/group UUID to filter by. Mutually exclusive with `domain` and `contact_organization` — pass at most one of the three. |