Developers

Wappar REST API

Send WhatsApp messages from your website, CRM, ERP or app. Available on Growth and Pro plans. Base URL:

https://wappar.com/api/v1

Authentication

Create a key in Dashboard → Developers. Send it as a bearer token (or X-API-Key header). Keys are shown once — store them securely and never in front-end code.

curl -X POST https://wappar.com/api/v1/messages/send \
  -H "Authorization: Bearer wpr_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to":"919876543210","text":"Hello from Wappar"}'
POST/messages/send

Send a message

Sends text, image, video or document from your first connected number (or numberId).

Request body

{
  "to": "919876543210",
  "text": "Hi Aman, your order #1042 has shipped 🚚",
  "numberId": "optional-uuid",
  "media": { "kind": "image", "url": "https://example.com/invoice.png" }
}

Response

{ "ok": true, "messageId": "true_919876543210@c.us_3EB0...", "numberId": "…" }
POST/contacts

Create or update a contact

Upserts by phone. Tags are merged, attributes are merged.

Request body

{
  "phone": "919876543210",
  "name": "Aman Gupta",
  "tags": ["website-lead"],
  "attributes": { "city": "Noida" }
}

Response

{ "contact": { "id": "…", "phone": "919876543210", … } }
POST/workflows/trigger

Trigger a workflow

Starts an active workflow for a number. Variables are available as {{variable}} in the flow.

Request body

{
  "workflowId": "uuid",
  "phone": "919876543210",
  "variables": { "order_id": "1042" }
}

Response

{ "ok": true, "runId": "…" }
GET/numbers

List numbers

Your linked WhatsApp numbers and their connection status.

Response

{ "numbers": [{ "id": "…", "label": "Sales", "phone": "9199…", "status": "ready" }] }
GET/me

Account & usage

Current plan, limits and this month's usage.

Response

{ "plan": "growth", "limits": { … }, "usage": { "messagesSent": 120 } }

Webhooks

Add an endpoint in Dashboard → Developers and choose events: message.received, message.sent, number.connected, number.disconnected, campaign.completed. Each POST carries an X-Wappar-Signature: sha256=<hex> header — the HMAC-SHA256 of the raw body with your endpoint secret.

// Node.js verification
import crypto from "node:crypto";
const expected = "sha256=" + crypto.createHmac("sha256", process.env.WAPPAR_WEBHOOK_SECRET)
  .update(rawBody).digest("hex");
const valid = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers["x-wappar-signature"]));
{
  "event": "message.received",
  "timestamp": 1763540000000,
  "data": { "numberId": "…", "from": "919876543210", "name": "Aman", "text": "Hi", "type": "chat" }
}

Rate limits & errors

120 requests per minute per key. Messages count toward your plan's monthly limit. Errors return JSON { "error": "…" } with status 401 (bad key), 403 (plan limit), 404, 422 (validation) or 429 (rate limited).