POST
the payload to your endpoint. The webhook has a timeout of 10 seconds. If within 10 seconds no success status (2xx) is received, the webhook will be retried, up to 3 times.
The webhook can be verified using your Retell API Key to make sure it comes from Retell AI. Read more at Secure the webhook.
agent_id
: if the number has inbound agent id set, you will see it in payloadfrom_number
: this will always show up in payload, helps you identify the caller and process the call accordinglyto_number
: this will always show up in payload, helps you identify the receiver and process the call accordinglycall_inbound
. Here’re the allowed fields (all of them are optional):
override_agent_id
: if you want to override the agent id, you can set it hereoverride_agent_version
: if you want to override the agent version, you can set it heredynamic_variables
: if you want to set dynamic variables for this inbound call, you can set it heremetadata
: if you want to set metadata for this inbound call, you can set it hereWhat would happen to the call when the webhook response is not received yet?
What would happen if webhook was not successful?
Can I use this webhook to decline inbound calls based on caller number?
Inbound Call Agent
in the phone number settingInbound Webhook