> ## Documentation Index
> Fetch the complete documentation index at: https://docs.persistence.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound webhooks

> Provide call-specific variables or reject an inbound call before the agent starts.

An inbound webhook lets your application make a decision when a configured phone number receives a call. The runtime invokes the endpoint before the agent conversation starts.

Use the webhook to return dynamic variables needed by the greeting, prompt, flow, or actions. Your endpoint can also reject the call when your application decides it should not proceed.

## Configure the endpoint

Open a phone number's inbound configuration, enter an HTTPS webhook URL, and use **Test** to inspect the response before enabling live traffic.

Design the endpoint to:

* Respond within the configured timeout
* Return dynamic variables as string-compatible values
* Avoid returning credentials or unnecessary personal data
* Handle retries without causing duplicate side effects
* Fail safely when the caller or account cannot be resolved

Keep authorization values in secrets or the supported phone configuration. Monitor webhook failures alongside the related conversation or observability session.