Quickstart — Get a Token & Send Leads

Use the API to send leads, fetch reports, and receive webhooks.

Authentication

Use your API key or exchange it for a short token.

POST /api/v1/auth/token

curl -X POST https://api.orifox.com/api/v1/auth/token \
 -H "Content-Type: application/json" \
 -d '{"api_key":"YOUR_API_KEY"}'

Leads API

POST /api/v1/leads

curl -X POST https://api.orifox.com/api/v1/leads \
 -H "Authorization: Bearer YOUR_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"name":"Raj","phone":"+919876543210"}'

Webhooks

{
  "event": "lead.created",
  "data": { "id": "lead_123" }
}

Error Codes

400 — Invalid Input
401 — Unauthorized
429 — Rate Limited

Rate Limits

Default: 120 requests / minute.

SDKs

npm install orifox-sdk

Changelog

2025-11-15 — Added leads.batch