Developers

Pair a number, send a message, receive webhooks.

Wapio gives your team predictable REST endpoints, signed webhooks, and a console that mirrors the API state.

Quickstart

curl -X POST https://api.wapio.io/v1/messages \
  -H "Authorization: Bearer wp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "ses_123",
    "to": "+15551234567",
    "text": "Your order is ready."
  }'

SDKs and tools.

Node.js

Ready

Python

Examples

REST

Stable

Postman

Collection

Rate limits.

Limits are account-level defaults. We can tune Agency plans after reviewing your workload and sending pattern.

Plan	API limit	Webhook delivery	Burst
Solo	60 req/min	3 retry attempts	10 requests
Team	120 req/min	5 retry attempts	25 requests
Studio	180 req/min	7 retry attempts	50 requests
Agency	256 req/min	Custom retry window	100 requests

API sandbox

Test the send-message flow.

This sandbox validates payloads and returns a mocked Wapio API response. Connect a real number in the console when production sending is enabled.

POST /api/sandbox

{
  "ok": true,
  "status": "ready",
  "message": "Submit the form to preview a response."
}

Authentication

Use workspace tokens for account APIs and per-session tokens for message APIs.

Webhooks

Every delivery is signed and retried with idempotency keys.

REST shape

Predictable JSON errors, request IDs, and cursor pagination.