Developer Docs

One API. Two editions. Same shape.

REST + Webhooks + SDKs for Node, PHP, Python and Go. Quickstarts below — full reference lives on each edition.

v1 API docs → v2 API docs →
Quickstart

Send your first WhatsApp message in 30 seconds.

Both editions expose REST endpoints — the shape is identical, only base URL and auth differ.

Zwaapi v1

Send text via WhatsApp Web

curl -X POST https://v1.zwaapi.com/api/send-message \
  -H "Authorization: Bearer V1_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "text",
    "message": "Hello from Zwaapi v1!"
  }'

Token from your v1 dashboard. Same endpoint shape works for the Cloud API path.

Zwaapi v2

Send template via Cloud API

curl -X POST https://v2.zwaapi.com/api/send \
  -H "Authorization: Bearer V2_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "order_confirmed",
      "language": "en"
    }
  }'

REST API is on the Enterprise tier. Webhooks available from Basic.

SDKs

Official libraries for your favourite stack.

JS

Node.js

npm i zwaapi-sdk

🐘

PHP

composer require zwaapi/sdk

🐍

Python

pip install zwaapi

Go

Go

go get github.com/zwaapi/go-sdk

Resources

Everything a developer needs.

📘 API Reference

Full REST reference: message types, contacts, templates, flows, webhooks — for both v1 and v2.

Open reference →

📥 Postman Collection

One-click import of every endpoint with sample payloads and auth helper pre-wired.

Get collection →

🪝 Webhooks Guide

Signed payloads, retry policy, event types — receive messages, statuses, and flow submissions.

Read guide →

🧱 Flow Builder JSON

Export / import chat flows as JSON. Version-control your bot in Git.

Flow docs →

🧪 Sandbox & Test Numbers

Test sends to your own number on either edition without burning template credits.

Sandbox docs →

⚡ Rate Limits

What to expect per plan, how to scale, and how to handle back-off cleanly.

Limit docs →

Building something cool?

Get developer credits, priority support, and an invite to our partner Slack — free for indie devs and startups.

Apply for partner program