> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/release-notes/2026/4/29/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Channel filtering for Conversations API webhooks

Webhook endpoints can now be filtered by Conversations API custom channel ID. Events from a specific custom channel can be routed to a dedicated endpoint without application-side filtering.

## What's new

* **Channel ID tagging.** `v1.conversation.created`, `v1.conversation.message`, and `v1.conversation.ended` events from a Conversations API custom channel are now tagged with the channel's ID.
* **Endpoint-level filtering.** Add a custom channel ID to an endpoint's **Channels** field to scope delivery to that channel. Unmatched events are filtered before delivery.
* **Combined with handoff filtering.** When a Conversations API conversation is in an active handoff, events carry both the channel ID and the handoff integration name, so subscribers using either tag continue to receive matching events.

For details, see [Webhook channel filtering](../reference/webhooks/overview#channel-filtering).