How to set up a webhook and approve integration actions
Get Cognizy events in your system in real time, and approve the actions that AI and integrations request before they run.
1 min readBasicUpdated on November 12, 2026
Changed on 11/12/2026: New developers area with the complete API reference
Where to find it in Cognizy
Video lesson coming soon. For now, follow the steps below.
A webhook sends every event you choose (new conversation, contact created, deal won…) to your system's address, signed with HMAC-SHA256. Under AI Approvals, you'll find actions requested by the API, by MCP, and by agents that only run with your OK.
Where to find it in Cognizy
Before you start
- Have the URL of your system that will receive the events.
- Only the owner and administrators can set up webhooks.
Step by step
- Step 1:
Open , tab Webhooks, and click New webhook.
- Step 2:
Enter the Destination URL and a Description. Under Events, check the ones your system wants to receive, like contact created and deal won.
- Step 3:
Click New webhook, at the bottom of the window. Deliveries are signed with HMAC-SHA256: in your system, always check the signature before using the event.
- Step 4:
On the AI Approvals tab, under Pending, you'll find actions requested by the API, by MCP, and by agents that only run with approval. Open each one, review it, and approve or decline.
How to know it worked
The webhook appears in the list and starts receiving the chosen events. Approved actions run right away; declined ones don't happen.
If something goes wrong
My system isn't receiving the events.
Check that the URL is public (https) and responds with success. Check the webhook deliveries for the error code.
Next step
Create an API key to call Cognizy.
For developers
Sign in with your Cognizy account to save your progress.
Sign in