### Answer --- There are two levels of webhook registration in Retell AI: [(1) ]() 1. Account level webhook — Set up through the system settings' webhooks tab for events related to any agent under your account 2. Agent level webhook — Set up through the dashboard's agent detail page Important behavior: If an agent-level webhook is set, account-level webhooks will not be triggered for that agent. For your use case (separate webhook per agent for real calls) : - Set the

webhook_url

directly on each agent via the dashboard or API , [(2) ]() - You can set this via API using the

webhook_url

parameter when creating or updating an agent [(1) ]()

javascript
webhook_url: "<https://your-webhook-url.com/webhook%22>

Troubleshooting why agent-level webhooks may not fire for real calls: - Verify the webhook URL is correctly saved on the agent (check via Get Voice Agent API or dashboard) [(2) ]() - Ensure your webhook endpoint returns a successful status code (2xx) within the timeout period [(3) ]() - Test by starting a web call in the dashboard to verify the webhook triggers correctly [(1) ]() If agent-level webhooks work for test calls but not real phone calls, double-check that the phone number is correctly linked to that specific agent and that no account-level webhook is overriding behavior.

​ To learn more, see the sources I considered: [[1] Discord message from @tomjennings25 on 2025-12-14](https://discord.com/channels/1186424376300679209/1294891368505937952/1449715238411698266) [[2] Get Voice Agent](https://docs.retellai.com/api-references/get-agent) [[3] Inbound webhook](https://docs.retellai.com/features/inbound-call-webhook) ​

Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.

### Answer --- Based on community reports, this appears to be a known issue where agent-level webhooks work for web calls but not for real phone calls. [(1) ]() [(2) ]() Possible causes: 1. Webhook URL not staying saved — There have been reports of the webhook URL being removed from the phone number configuration when saving the conversation agent. [(2) ]() 2. Compatibility issue — The phone number level webhook and agent level webhook may have conflicts when used together. Recommended steps: 1. Verify the webhook is still saved — Go back to your agent settings and confirm the webhook URL is still present after saving. 2. Check phone number configuration — Ensure the phone number is correctly linked to your agent with the proper

outbound_agent_id

or

inbound_agent_id

. [(3) ]() 3. Test endpoint accessibility — Make sure your webhook endpoint returns a 2xx status code. [(4) ]() 4. Try account-level webhook temporarily — As a workaround, you could use the account-level webhook to confirm data is being sent, then troubleshoot from there. This issue has been reported and resolved for other users previously. [(2) ]() If the problem persists, I'd recommend reaching out to support directly: - Visit [Contact Sales]() - Check [)

​ To learn more, see the sources I considered: [[1] Agent Level Webhook not receiving data](https://discord.com/channels/1186424376300679209/1412776467112263750) [[2] inbound webhook URL failing to save (or stay saved) and wont work together with conversation agaent](https://discord.com/channels/1186424376300679209/1398428473781125314) [[3] Here is how that can be fixed](https://retell.discourse.group/t/here-is-how-that-can-be-fixed/23) [[4] Setup guide](https://docs.retellai.com/features/register-webhook) ​

Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.