Status Change Webhooks: Setup & Verification
Start receiving and verifying bot status change webhook events.
https://docs.recall.ai/update/docs/verify-events#/## Setup
Webhook endpoints are configured in the Recall dashboard in the "Webhooks" tab.
Click the "Add Endpoint" button on the right.
Enter a URL from your application that Recall will call for event notifications, then click "Create".
Recall will submit a POST request to the configured URL, which your application can treat the same as any other route.
Setting up a Test Endpoint
You can click the "Svix Play" button to generate a testing endpoint URL that will display all webhooks received.
After clicking the "Create" button, you can view the webhooks sent to that URL by clicking "View in Svix Play".
You will be taken to a page where you can view incoming webhook messages.
Verification
Legacy secretsWorkspaces created before 11/10/2025 have a unique secret for all endpoints. Bot status webhooks will contain headers with the prefix
svix-*Workspaces created on or after 11/11/2025 have a single secret for all endpoints. This secret can be seen and rotated in the Developer page. Bot status webhooks with have a
webhook-*headerThe Svix libraries support both, and can be validated in the same way regardless of which workspace version you are using
The bot status webhooks (configured on the Recall webhooks dashboard) are sent by Svix, and you can verify them as follows: https://docs.svix.com/receiving/verifying-payloads/how-manual
View the webhooks dashboard
Updated about 5 hours ago