Actions134
- Account Actions
- Agent Actions
- Contact Actions
- Conversation Actions
- Create
- Get
- List
- Send Message
- Send File
- Send with Template
- List Messages
- Delete Message
- List Attachments
- Download Attachment
- Assign Agent
- Assign Team
- Add Labels
- Remove Labels
- Update Labels
- List Labels
- Toggle Status
- Set Priority
- Add Custom Attributes
- Remove Custom Attributes
- Set Custom Attributes
- Update Last Seen
- Update Presence
- Mark Unread
- Update Attachment Metadata
- Custom Attribute Actions
- Inbox Actions
- Internal Chat Category Actions
- Internal Chat Channel Actions
- Internal Chat Member Actions
- Internal Chat Message Actions
- Kanban Board Actions
- Kanban Product Actions
- Kanban Step Actions
- Kanban Task Actions
- Kanban Task Product Actions
- Label Actions
- Profile Actions
- Scheduled Message Actions
- Team Actions
Conversation → List
AI-generatedSummary
List conversations for a selected account and inbox, optionally filtered by status, labels, or search term.
Inputs
- accountId (required) — Identifier of the Chatwoot account to query conversations from.
- inboxId (required) — Identifier of the inbox to query conversations from.
- filters — Arbitrary filter collection (e.g., labels, status, assignee_type) applied to the query.
- page — Page number for pagination (default is 1).
- q — Search term that filters conversations by message content.
- status — Conversation status filter (e.g., open, pending, resolved).
- team_id — Filter conversations by team ID.
Output shape
array of conversation objects (paginated)
The response is a paginated list; pagination metadata includes self and next links and may omit page details on the final page. Individual conversation objects contain fields such as id, subject, assignee_type, labels, and priority.
Examples
Example 1: Retrieve the first page of open conversations from a specific account and inbox, optionally filtered by labels.
accountId: "123"; inboxId: "456"; filters: {"status":"open"}; page: 1