mos
02/21/2026, 10:01 PMtransferPlan.mode = warm-transfer-say-summary
When attempting to configure a transferCall tool with:
"type": "transferCall",
"destinations": [
{ "type": "number", "number": "+15093061243" }
],
"transferPlan": {
"mode": "warm-transfer-say-summary",
"summaryPlan": {
"enabled": true
}
}
}
we receive the following API error:
property transferPlan should not exist
When creating a persistent transferCall tool
When embedding the tool inline under assistant.model.tools
When attempting partial_update on the assistant
It appears our organization schema does not currently expose transferPlan support on transferCall.
Could you please enable native warm transfer (warm-transfer-say-summary) for our organization?
This feature is required for a professional inbound call screening workflow where the sales representative receives a spoken summary before the caller is bridged.
Thank you.Chiranjeet Mishra
02/21/2026, 10:01 PMVapi Support Bot
02/21/2026, 10:01 PMtransferPlan inside the destination object and use the correct mode name.
Here’s an example configuration for a warm transfer with summary:
json
{
"type": "transferCall",
"destinations": [
{
"type": "number",
"number": "+15093061243",
"transferPlan": {
"mode": "warm-transfer-with-summary",
"summaryPlan": {
"enabled": true
}
}
}
]
}
This should enable the spoken summary before bridging the call, provided your account supports this feature.
For more details, see the [Vapi call forwarding documentation](https://docs.vapi.ai/call-forwarding).
Source:
- [Vapi Call Forwarding Documentation](https://docs.vapi.ai/call-forwarding)James Christopher
02/22/2026, 5:37 PMChiranjeet Mishra
03/04/2026, 10:01 AMjson
{
"type": "transferCall",
"destinations": [
{
"type": "number",
"number": "+15093061243",
"transferPlan": {
"mode": "warm-transfer-say-summary",
"summaryPlan": {
"enabled": true
}
}
}
]
}
The only change: move transferPlan inside the destination object, as a sibling of type and number. This makes sense architecturally; each destination can have its own transfer plan (e.g., you might warm-transfer to one number but blind-transfer to another).
available transfer modes for reference:
• blind-transfer (default)
• blind-transfer-add-summary-to-sip-header
• warm-transfer-say-message
• warm-transfer-say-summary ← what you want
• warm-transfer-twiml
• warm-transfer-wait-for-operator-to-speak-first-and-then-say-message
• warm-transfer-wait-for-operator-to-speak-first-and-then-say-summary