Webhook subscriptions
Subscribe to events: call.ended, call.interested, call.opt_out, sms.received, lead.imported.
01
Add a subscription
- Integrations → Webhooks → Add.
- URL: your endpoint (must be HTTPS).
- Events: tick the ones you want.
- Optional: shared secret for HMAC verification.
02
Event types
- call.ended — every call, regardless of outcome.
- call.interested — only when outcome includes 'interested'.
- call.opt_out — only when caller opted out.
- sms.received — every inbound SMS.
- lead.imported — when a CSV upload finishes.
03
Payload format
- JSON body. Includes call_id, customer_number, outcome, ended_reason, summary, transcript, recording_url.
- Sample payload: /api-docs → Webhook payloads.
04
Signature verification
- Header: X-VoxReach-Signature: hmac_sha256(secret, body).
- Compute the same on your side. Reject if mismatch.
05
Retries
- We retry up to 5 times with exponential backoff if your endpoint returns non-2xx.
- After 5 failures we mark the subscription degraded + email you.
Related articles
Tenant API access
Per-tenant API key. Push leads, fetch transcripts, query usage. Rate-limited 120 req/min.
Trigger an outbound call via API (for IT teams)
POST a call from your stack — webhook + SDK + curl examples.
Verify webhook signatures (HMAC-SHA256)
Cryptographically verify that an incoming webhook came from VoxReach.
API rate limits + retry behaviour
What our limits are, how you'll know when you hit them, how to back off properly.
Still stuck?
Email hello@voxreach.com.au — we reply within 2 business hours during AEST hours.
Open a ticket