> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://poly-ai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server.

# Handoff integration

> Set up handoff destinations with Twilio

Configure handoff destinations so your agent can transfer calls to live agents or specific departments through your Twilio-connected number. When a handoff triggers, the call routes to the destination number you specify.

## Prerequisites

* Your agent must be [integrated with a Twilio phone number](/agent-studio/voice/numbers/twilio/phone-number-integration).
* You need the phone number or extension for each transfer destination.

## Setup

#### Open Call Handoffs

Click **Call Handoffs** under **Build** in the sidebar.

#### Add a destination

Click **Add Handoff** and fill in:

* **Handoff destination name** – A descriptive label (e.g., "Billing support", "Front desk").
* **Extension/Number** – The phone number to transfer to, in [E.164 format](https://www.twilio.com/docs/glossary/what-e164) (must start with `+`, e.g., `+14155551234`).
* **Description** – When this handoff should be used (e.g., "When the caller requests to speak with billing").

#### Save

Click **Add**. The destination is now available for use in [FAQs actions](/agent-studio/knowledge/fa-qs/actions/handoff) and [functions](/agent-studio/tools/return-values).

## Test your handoff

1. Add the handoff as an [action on a Managed Topic](/agent-studio/knowledge/fa-qs/actions/handoff).
2. Test in **Sandbox** by triggering the topic that should initiate the transfer.
3. Verify the call routes to the correct destination.

## Next steps

#### [Call Handoffs overview](/agent-studio/voice/handoffs)

Configure SIP methods and headers for transfers

#### [Handoff API](/api-reference/runtime-data/handoff-api/overview)

Retrieve handoff context programmatically

#### [Twilio Flex integration](/integrations/telephony/twilio)

Advanced contact center routing

#### [Phone number integration](/agent-studio/voice/numbers/twilio/phone-number-integration)

Set up your Twilio number with PolyAI