If you've ever tried integrating WhatsApp into your app,
you know the pain. Meta's official API requires business
verification, approval processes, and per-message fees
that don't make sense for small projects.
There's a simpler way. In this tutorial, I'll show you how
to send your first WhatsApp message programmatically in
under 5 minutes using a REST API.
Step 1: Get Your API Key
Sign up at wazen.dev and grab your
API key from the dashboard. Takes about 30 seconds.
Step 2: Connect Your WhatsApp
Scan the QR code shown in the dashboard with your WhatsApp
app just like connecting WhatsApp Web. Your session is
now live.
Step 3: Send a Message
One API call. That's it:
curl -X POST https://wazen.dev/api/v1/sessions/{session_id}/messages \
-H "Authorization: Bearer wz_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"to": "1234567890",
"type": "text",
"content": "Hello from my app!"
}'
Response:
{
"id": "msg_abc123",
"sessionId": "sess_xyz",
"to": "1234567890",
"type": "text",
"content": "Hello from my app!",
"status": "queued",
"direction": "outgoing",
"createdAt": "2026-03-21T10:30:00Z"
}
The message gets queued and delivered through Wazen's
smart pacing system automatically.
Send Media
Not just text. Send images, videos, audio, and documents:
curl -X POST https://wazen.dev/api/v1/sessions/{session_id}/messages \
-H "Authorization: Bearer wz_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"to": "1234567890",
"type": "image",
"media_url": "https://example.com/photo.jpg"
}'
Supported types: text, image, video, audio,
document. Media can be sent via URL (media_url) or
base64 encoded (media_base64).
Receive Messages via Webhooks
Set up a webhook URL in your dashboard and Wazen will POST
incoming messages to your endpoint in real-time.
Get Message History
Fetch sent and received messages with pagination:
curl https://wazen.dev/api/v1/sessions/{session_id}/messages?direction=incoming&limit=20 \
-H "Authorization: Bearer wz_your_api_key"
Filter by direction (incoming/outgoing) and type
(text/image/video/audio/document).
Smart Warming
One thing that sets this apart, Wazen has a built-in
warming module that automatically paces your messages
based on your session age. New numbers start slow and
ramp up gradually, which helps with deliverability.
No need to manage rate limits yourself. The platform
handles it for you.
MCP Server for AI Agents
If you're building AI agents with Claude Code, Cursor,
or any MCP-compatible tool, Wazen has a native MCP server.
Your AI agents can send and receive WhatsApp messages
directly. No custom integration needed.
Pricing
Starts at $9.99/mo for 1 WhatsApp session. No per-message
fees. Plans go up to 10 sessions for teams that need more.
Right now there's a founding member offer — 50% off
forever for the first 100 customers.
Check it out: https://wazen.dev
Top comments (0)