Tenant API access
Per-tenant API key. Push leads, fetch transcripts, query usage. Rate-limited 120 req/min.
01
Generate an API key
- Settings → API → Generate. Tenant-scoped (no cross-tenant access).
- Save it now — only shown once.
02
Authentication
- HTTP header: Authorization: Bearer
- Or query param: ?api_key=… (deprecated, use header).
03
Endpoints
- POST /api/v1/leads — push a lead.
- GET /api/v1/leads — list leads.
- GET /api/v1/calls — list calls.
- GET /api/v1/calls/
— single call with transcript + recording URL. - GET /api/v1/usage — current period usage.
- Full schema: /api-docs (in-app).
04
Rate limits
- 120 req/min per tenant. 429 returned with Retry-After header on overload.
Related articles
Webhook subscriptions
Subscribe to events: call.ended, call.interested, call.opt_out, sms.received, lead.imported.
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