New Self-serve onboarding is live — connect a WhatsApp number in minutes with Embedded Signup. Get started
Developers

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.

Quickstart

Send your first message

  1. Connect your number

    Use Embedded Signup to link your WhatsApp Business Account.

  2. Create an API key

    Generate a key in the console. Keys are scoped to an environment — keep them server-side.

  3. 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.

API reference

Core endpoints

Base URL https://api.wappnexus.com/v1 · Authenticate with Authorization: Bearer <key>

POST/messagesSend a template, text, media or interactive message
GET/messages/{id}Retrieve a message and its delivery status
POST/verifyGenerate and send a one-time passcode
POST/verify/checkCheck a code entered by the user
GET/templatesList templates and their Meta approval status
POST/templatesCreate a template and submit it for approval
GET/numbersList connected WhatsApp numbers and quality ratings
POST/webhooksRegister an endpoint for message and status events
DELETE/webhooks/{id}Remove a webhook endpoint
Webhooks

Real-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 id for 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" }
}
Good to know

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.