ChatWoot Application icon

ChatWoot Application

Interact with ChatWoot Application APIs

Actions112

Custom Filter → Create a Custom Filter

AI-generated

Summary

Create a new custom filter for a specified ChatWoot account by providing the account ID and optional details such as name, query, and type.

Inputs

  • Account ID (required) — The numeric ID of the ChatWoot account for which the custom filter will be created.
  • Name — The name of the custom filter to identify it.
  • Query — A JSON query defining the filter criteria to be saved.
  • Type — The category of the custom filter, which can be 'conversation', 'contact', or 'report'.

Output shape

a single JSON object representing the newly created custom filter

The output contains the created custom filter's data as returned by the ChatWoot API. Optional request parameters like batching, proxy, timeout, and SSL allowance can affect the request behavior but not the output shape.

Examples

Example 1: Create a filter named 'Urgent Conversations' for account ID 123 with a query targeting urgent messages and type set to 'conversation'.

Set Account ID to 123, Name to 'Urgent Conversations', Query as appropriate JSON, and Type to 'conversation'.

Links

Discussion