[ REST API v1 ]

Every feature, also an API.

Scoped API keys, sandbox mode with wf_test_ prefixes, idempotency headers, and a cursor-based event stream. Build integrations that behave exactly like the dashboard.

[ ENDPOINT REFERENCE ]

All endpoints, at a glance.

MethodEndpointDescription
GET/api/v1/meOrg info for the authenticated key
POST/api/v1/messagesSend a message or template
POST/api/v1/contactsUpsert a contact by phone number
GET/api/v1/contactsPaginated contact list with filters
POST/api/v1/leadsCapture a lead and deliver its result over WhatsApp
GET/api/v1/templatesList Meta-approved templates
GET/api/v1/eventsPoll event stream (cursor-based)
GET/api/v1/openapiOpenAPI 3.1 spec JSON
[ AUTHENTICATION ]

Bearer tokens with scopes.

Generate API keys from Settings → API Keys. Each key carries explicit scopes, limiting what it can access. Rotate keys instantly without downtime.

Key Format
Productionwf_live_••••••••••••••••
Sandboxwf_test_••••••••••••••••

Available Scopes

messages:sendSend template and session messages
contacts:readRead contact list and profiles
contacts:writeCreate and update contacts
templates:readList and inspect message templates
leads:writeCapture leads and trigger result delivery
[ CODE EXAMPLE ]

Send a message

Request
# POST a template message
curl -X POST https://app.leapcrew.in/api/v1/messages \
  -H "Authorization: Bearer wf_live_••••••••••••" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1234" \
  -d '{
    "to": "+919876543210",
    "template": "cart_recovery",
    "variables": {
      "product_name": "Running Shoes",
      "cart_link": "https://yourstore.com/cart/abc"
    }
  }'
200 OK
Response
{
  "id": "msg_01J9XKZTV4BQRSP8WDCN7HGF2",
  "status": "queued",
  "to": "+919876543210",
  "template": "cart_recovery",
  "created_at": "2026-06-11T08:14:33Z"
}
[ SANDBOX MODE ]

Test without side effects.

Use wf_test_ keys to simulate the full API without sending real messages or consuming wallet credits.

No billing impact

Sandbox calls are never charged. Wallet balance is unaffected.

No real sends

Messages log to your inbox tagged [Sandbox] instead of reaching customers.

Same response shape

Every response is identical to production. Ship code that works on day one.

[ INTERACTIVE DOCS ]

Try every endpoint live in your browser.

Scalar-powered interactive reference with request builder, auto-auth, and response inspector.

Open API Docs