Actions117
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Profile Actions
- N 8 N Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
Custom Filters → Create A Custom Filter
AI-generatedSummary
Create a new custom filter in a specified ChatWoot account by providing the account ID, filter name, type, and query definition.
Inputs
- Account Id (required) — Numeric ID of the ChatWoot account where the custom filter will be created.
- Filter Type — Type of custom filter to create; options are conversation, contact, or report (sent as query parameter). Defaults to conversation.
- Name — The name to assign to the new custom filter.
- Type — The category type of the custom filter; options are conversation, contact, or report. Defaults to conversation.
- Query — JSON object that defines the query conditions for the custom filter.
- Request Options — Optional settings to adjust request behavior, including batching, SSL validation, proxy, and timeout.
Output shape
a single JSON response object representing the created custom filter
The output is the API response for the newly created custom filter. The shape of the response depends on ChatWoot API. No pagination applies since this is a create action.
Examples
Example 1: Creating a conversation-type custom filter with a specific query in account 12345
Set Account Id to 12345; set Filter Type and Type to 'conversation'; provide a filter Name and a JSON query string.