Build WhatsApp experiences with one clean API
REST endpoints for messages, verification and templates, with signed webhooks for every event. We handle Meta's Cloud API so you don't have to.
Send your first message
Connect your number
Use Embedded Signup to link your WhatsApp Business Account.
Create an API key
Generate a key in the console. Keys are scoped to an environment — keep them server-side.
Send a template
Business-initiated messages use Meta-approved templates. Replies inside the 24-hour window can be free-form.
# 1. Send a template message curl -X POST https://api.wappnexus.com/v1/messages \ -H "Authorization: Bearer $WAPPNEXUS_API_KEY" \ -H "Idempotency-Key: 5c1e…" \ -H "Content-Type: application/json" \ -d '{ "to": "+919876543210", "type": "template", "template": { "name": "order_shipped", "language": "en", "params": ["Priya", "#OD-4821"] } }' # 202 Accepted { "id": "msg_9f2c…", "status": "queued" }
Preview: the public API is in early access. Endpoint names and payloads below may change — request access.
Core endpoints
Base URL https://api.wappnexus.com/v1 · Authenticate with Authorization: Bearer <key>
/messagesSend a template, text, media or interactive message/messages/{id}Retrieve a message and its delivery status/verifyGenerate and send a one-time passcode/verify/checkCheck a code entered by the user/templatesList templates and their Meta approval status/templatesCreate a template and submit it for approval/numbersList connected WhatsApp numbers and quality ratings/webhooksRegister an endpoint for message and status events/webhooks/{id}Remove a webhook endpointReal-time events, verifiably signed
We POST JSON to your endpoint for inbound messages and status changes — sent, delivered, read and failed. Every request carries an X-WappNexus-Signature header: an HMAC-SHA256 of the raw body using your signing secret.
- Respond with 2xx within 10 seconds
- Failed deliveries are retried with exponential backoff
- Events include an
idfor de-duplication
// Verify a webhook (Node.js) const crypto = require('node:crypto'); function isValid(rawBody, header, secret) { const expected = crypto .createHmac('sha256', secret) .update(rawBody).digest('hex'); return header.length === expected.length && crypto.timingSafeEqual(Buffer.from(header), Buffer.from(expected)); } // Example payload { "id": "evt_31a…", "type": "message.status", "data": { "message_id": "msg_9f2c…", "status": "read" } }
WhatsApp platform essentials
Templates
Business-initiated messages need a Meta-approved template in the marketing, utility or authentication category.
24-hour window
When a customer messages you, you can reply free-form for 24 hours from their last message.
Messaging limits
Meta sets per-number limits that grow with quality and volume. We throttle sends to stay within them.