> 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/6/1/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Conversations API channel filtering for the handoff-ended event webhooks

The `v1.conversation.handoff.ended` webhook now carries the Conversations API custom channel ID, extending channel filtering to handoff-ended events.

## What's new

This change brings handoff-ended events in line with the other Conversations API webhook events that already support channel filtering.

* **Channel ID on handoff-ended events.** When a handoff ends on a Conversations API custom channel, the `v1.conversation.handoff.ended` event is now tagged with both the custom channel's ID and the handoff integration name. Previously it carried only the handoff integration name.
* **Filter handoff traffic by channel.** An endpoint scoped to a custom channel ID now receives that channel's `handoff.ended` events. Conversations API handoff traffic can be isolated by channel even when other channels hand off to the same integration.

Native Chat, Voice, and Email handoff-ended events are unchanged.

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