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/v1Authentication
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"}'/messages/sendSend 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": "…" }/contactsCreate 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", … } }/workflows/triggerTrigger 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": "…" }/numbersList numbers
Your linked WhatsApp numbers and their connection status.
Response
{ "numbers": [{ "id": "…", "label": "Sales", "phone": "9199…", "status": "ready" }] }/meAccount & 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).