Webhook Integration
Configure a webhook to receive call events from Minari in real time.
Webhooks allow Minari to send call data directly to your own systems when a call is completed. You can use them to build automations, sync data to your CRM, trigger workflows in tools like Zapier, n8n or Make, or integrate with your own backend.
Setup
Go to Settings → API & webhook
In the Webhook section, click Add
Enter your webhook endpoint URL
Click Save
Once configured, Minari generates a unique webhook secret. You can reveal it by clicking Show Secret.
This secret is used to verify webhook signatures and ensure requests are genuinely sent by Minari.
Test your webhook
After setup, click Send test event to send a sample payload to your endpoint and verify your integration is working correctly.
Developer documentation
Full webhook documentation, payload examples, signature verification, retry behavior and API reference are available here:
API documentation: api.minari.ai/docs
Webhook documentation: api.minari.ai/docs#tag/webhooks
Troubleshooting
Webhook not receiving events
Verify your endpoint is publicly accessible
Make sure your endpoint returns a
2xxstatus codeCheck the delivery logs in your webhook settings
Invalid signature errors
Verify you are using the correct webhook secret
Make sure the signature is computed from the raw request body
Recording or transcript URLs return 403
Signed asset URLs expire automatically after 24 hours.