Docs

Build with the Wapio API.

Start with a token, pair a WhatsApp number by QR, send your first message, then subscribe to signed webhook events.

Authentication

Create workspace tokens, rotate keys, and scope access by session.

Pair sessions

Generate a QR code, connect a WhatsApp number, and monitor health.

Send messages

Send text and media payloads through predictable REST endpoints.

Receive webhooks

Verify signatures, handle retries, and replay missed events.

Authentication

Use a workspace bearer token for account APIs. For session-level sending, pass the session identifier in the payload or use a scoped session token when available.

Pair a WhatsApp number

Create a session, request the QR code, scan it with WhatsApp, and watch for the connected webhook event before sending production traffic.

Send a message

POST /v1/messages
Authorization: Bearer wp_live_xxx

{
  "session_id": "ses_123",
  "to": "+15551234567",
  "text": "Your appointment is confirmed."
}

Receive webhooks

Verify the signature header, process events idempotently, and return a 2xx response. Wapio retries failed deliveries with backoff and includes request IDs for tracing.