baadshah2
12/04/2025, 7:44 PMVapi Support Bot
12/04/2025, 7:45 PMholdAudioUrl in the TransferPlan (using the warm-transfer-experimental mode). While this is designed for transfers, it demonstrates how hold music can be configured.
Example snippet for a transfer with hold music:
json
{
"type": "transfer",
"destination": {
"transferPlan": {
"mode": "warm-transfer-experimental",
"holdAudioUrl": "https://your-hold-music-url.com/hold.mp3"
}
}
}
For playing hold music specifically while waiting for a tool to return data (outside of transfers), there is no direct method documented yet.
See the [changelog for details](https://docs.vapi.ai/changelog/2025/5/6).
Source:
- [Changelog May 6, 2025](https://docs.vapi.ai/changelog/2025/5/6)baadshah2
12/05/2025, 5:22 PMChiranjeet Mishra
12/07/2025, 4:37 PMwarm-transfer-experimental mode, you can play hold music using the holdAudioUrl as shown in the example you provided.
If you want to implement this in a context other than call transfers, you would need to explore other creative solutions, such as briefly transferring the call to a hold state with background music. For direct support in environments other than transfers, you may want to refer to future updates in the [Vapi changelog](https://docs.vapi.ai/changelog/2025/5/6) for new features.
Feel free to ask if you need further guidance on implementing these steps or anything else!