Skip to main content
webhooks.retell() verifies the HMAC-SHA256 signature Retell AI sends in x-retell-signature on every request.
/trigger/retell.ts
To run a subscriber only for some events, add a filter on event.event.

Set up Retell AI

  1. Start trigger dev or deploy, then copy the endpoint’s Webhook URL from the Webhooks page.
  2. In Retell AI, set the webhook URL as the account-level webhook in the system settings’ Webhooks tab, or as an agent’s Agent Level Webhook URL under Webhook settings in the agent editor. An agent-level URL replaces the account-level one for that agent.
  3. Retell AI signs with an API key, not a per-webhook secret. Copy the API key that has the webhook badge next to it, then choose Set signing secret on the Trigger.dev endpoint and paste it.
  4. Send a test event from Retell AI, or use the endpoint’s Test tab, and check the endpoint’s Deliveries tab. See Verify the connection if nothing arrives.