Prerequisites
- An HTTPS endpoint that can receive POST JSON
- Optional: bearer token, custom headers, or an HMAC signing secret, depending on how you authenticate
- Permission to add integrations on the project
Connect
1
Open Add Integration
In the project sidebar, select Integrations, then Add Integration. Select Connect on the Custom Webhook card.
2
Enter endpoint and auth
On Connect webhook, fill in:
- Webhook URL — HTTPS URL, for example
https://example.com/hooks/botcadence - Authentication — None, Bearer token, Custom headers, or HMAC signature
- Bearer token — if you chose bearer
- Custom headers — if you chose headers (JSON object of header names and values)
- Signing secret — if you chose HMAC
3
Wait for validation
The wizard checks that the URL is reachable. When it succeeds, you see Webhook Connected!
Verify
On Integrations, the row shows Connected.Attach this connection on a test campaign, inbound, or channel, complete a conversation, and confirm your endpoint received a POST.
Use it
Open the campaign, inbound, or channel Integrations tab. Set Destination to this webhook connection. The success screen in the wizard also tells you to attach the connection on a campaign, inbound, or channel export. Events do not fire from the Integrations page alone.Limits
- URL must be HTTPS.
- Custom headers must be valid JSON when that auth type is selected.
- This destination competes with Google Sheets, Zapier, and CRM on the same source: one extra destination at a time.
Troubleshooting
Validation fails
Validation fails
Confirm the URL is HTTPS, publicly reachable, and returns a success response to the check. Firewalls that block Botcadence will fail validation.
No POSTs arrive
No POSTs arrive
Attach this connection as Destination on the source that actually handled the conversation.
Your server rejects the request
Your server rejects the request
Match Authentication to what your endpoint expects. For HMAC, use the same signing secret on both sides.

