Skip to main content
Base URL: https://whatsrb.com/api/v1 — All requests require Authorization: Bearer YOUR_API_KEY

Resources

Business Accounts

Connect and manage WhatsApp Business accounts via the official Meta API. Supports the embedded signup flow.

Messages

Send text, images, documents, and template messages to your customers at scale.

Templates

Create, sync from Meta, and send pre-approved message templates with dynamic variables.

Webhooks

Register endpoints to receive real-time delivery receipts and inbound message events.

Sessions

Manage WhatsApp Web sessions for the session-based channel (no Meta approval required).

Usage

Monitor your plan limits, message throughput, and delivery metrics.

Authentication

Every request must include your API key as a Bearer token:
Authorization: Bearer wrb_live_xxxxxxxxxxxxx
Generate your key from the WhatsRB Dashboard under Settings → API Keys.
Keep your API key secret. Never expose it in client-side code or public repositories.

Response format

All responses return JSON. Successful responses wrap data in a data key:
{
  "data": {
    "id": "acc_01hx...",
    "waba_id": "123456789",
    "business_name": "Acme Corp",
    "status": "active"
  }
}
List endpoints include a meta key with pagination info:
{
  "data": [...],
  "meta": {
    "total": 42,
    "plan_limit": 10
  }
}

Error format

Errors return a JSON object with a human-readable error key:
{
  "error": "Business account not found"
}
StatusMeaning
400Bad request — invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — plan limit reached
404Not found
422Validation error
429Rate limited
5xxServer error