API Reference
WhatsApp API
37 endpoints for messaging, broadcasts, contacts, templates, phone numbers, and business profile. One REST API.
Quick Start
- 1.Get API KeySign up for free and get your API key in seconds.
- 2.Connect AccountUse our OAuth flow to connect WhatsApp accounts.
- 3.Start PostingMake API calls to post content to WhatsApp.
// Step 1: Create a broadcast with a WhatsApp template
const broadcast = await fetch('https://zernio.com/api/v1/broadcasts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
profileId: 'prof_123',
accountId: 'acc_waba123',
platform: 'whatsapp',
name: 'Order Confirmations',
template: {
name: 'order_confirmation',
language: 'en',
components: [{
type: 'body',
parameters: [
{ type: 'text', text: 'John' },
{ type: 'text', text: 'ORD-12345' }
]
}]
}
})
}).then(r => r.json());
// Step 2: Add recipients by phone number
await fetch(`https://zernio.com/api/v1/broadcasts/${broadcast.broadcast.id}/recipients`, {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
phones: ['+1234567890', '+0987654321']
})
});
// Step 3: Send immediately
const result = await fetch(`https://zernio.com/api/v1/broadcasts/${broadcast.broadcast.id}/send`, {
method: 'POST',
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}).then(r => r.json());
console.log(`Sent: ${result.sent}, Failed: ${result.failed}`);WhatsApp Endpoints
Create a WhatsApp broadcast campaign with a Meta-approved template
List WhatsApp broadcast campaigns with delivery stats
Get broadcast details including sent, delivered, and read counts
Add WhatsApp recipients by phone number, contact ID, or segment
Send a WhatsApp broadcast campaign immediately
Schedule a WhatsApp broadcast for a future time
Cancel a scheduled or in-progress WhatsApp broadcast
List all Meta-approved message templates from your WABA
Create a new WhatsApp template (submitted to Meta for approval)
Update an existing WhatsApp message template
Delete a WhatsApp message template
List WhatsApp contacts with filtering by tags, opt-in status, and search
Create a WhatsApp contact with phone number and tags
Update a WhatsApp contact (name, tags, opt-in status, custom fields)
Delete a WhatsApp contact
Bulk import up to 1,000 WhatsApp contacts with phone numbers
List all purchased WhatsApp phone numbers
Search available US numbers for purchase
Purchase a WhatsApp-ready phone number
Complete phone number verification
Get WhatsApp Business profile (about, address, description)
Update WhatsApp Business profile fields
Media Requirements
| Type | Format | Max Size | Notes |
|---|---|---|---|
| Image | JPEG, PNG | 5 MB | Supported in template headers and media messages |
| Video | MP4 (H.264/AAC) | 16 MB | Supported in template headers and media messages |
| Audio | AAC, MP4, MPEG, AMR, OGG | 16 MB | Voice and audio messages |
| Document | PDF, DOC, XLS, PPT, etc. | 100 MB | Any common document format supported |
Zernio automatically transcodes and optimizes media for WhatsApp's requirements.
API Limits
WhatsApp enforces per-phone-number messaging tiers based on your quality rating (1K, 10K, 100K, unlimited). Zernio handles rate limit errors (131047) with automatic retries and exponential backoff.
Zernio handles all rate limiting automatically. We queue and retry requests as needed.
Features
- ✓Full WhatsApp API: broadcasts, contacts, templates, phone numbers, and business profile management
- ✓No Meta developer app or Business Manager required. One-click Embedded Signup
- ✓Broadcast campaigns: send to 100 recipients per request with per-user template variables
- ✓Full template CRUD: create, list, update, delete. We track category changes to prevent surprise billing
- ✓Contact CRM: bulk import, tags, custom fields, subscription tracking, search and segmentation
- ✓Phone number provisioning: search, purchase, and verify WhatsApp-ready US numbers via API
- ✓Business profile management: read and update about, description, address, email, websites
- ✓24-hour messaging window handled automatically. Clear errors, no silent failures
- ✓Webhook delivery for incoming messages, delivery status, and read receipts
- ✓We absorb Meta's breaking changes so your integration keeps working
Response Example
{
"success": true,
"status": "completed",
"sent": 2,
"failed": 0,
"recipientCount": 2
}Start building with WhatsApp API
Free tier available · No credit card required · 99.97% uptime

