Join Slack Community
WhatsApp API: Types, Access, Pricing and Limits
// Link an existing WhatsApp account
const account = await client.account.connectWhatsapp();
// account.qrCodeString -> show to the user
// or pass a pairing_phone_number instead
const chats = await client.chats.list({
account_type: 'WHATSAPP'
});What is the WhatsApp API?
| Name | What it is | Who operates it | Access requirements |
|---|---|---|---|
| WhatsApp Business Platform (Cloud API) | Meta's own official API for provisioning new business phone numbers and sending template messages at scale | Meta | Meta developer app, WABA, business phone number, verification for higher tiers |
| Business Solution Provider (BSP) access | A third party (Twilio, 360dialog and similar) reselling the same Cloud API, wrapped in its own dashboard and billing | Meta infrastructure, BSP-managed | Same underlying Meta requirements, provisioned through the BSP |
| Unified session API (Unipile) | Connects a WhatsApp account, business or personal, the way WhatsApp Web does, by QR code or pairing code | Unipile, on behalf of the authenticated user | No Meta Business verification, no new number, no template approval |
What are the different types of WhatsApp API?
| Type | Provisioning | Best for | Works with an existing account |
|---|---|---|---|
| Cloud API | New business phone number + Meta Business verification for higher volume | Companies sending high-volume marketing or notifications at scale | No, requires a new number |
| On-Premise API | Deprecated. Meta retired it and pushed migration to the Cloud API | Legacy integrations only | No |
| WhatsApp Business App | Free consumer-facing app, manual setup on one device | Small businesses managing chats by hand | Yes, but manually, one device, not programmatic |
| Unified session API (Unipile) | Links the account the way WhatsApp Web does, no new number | SaaS platforms embedding each user's own WhatsApp account in-product | Yes, this is the primary use case |
WhatsApp API ecosystem
Meta offers two official APIs that allow businesses to integrate WhatsApp into their software. Both are designed to enable high-volume messaging, with features such as templated messages, media sharing, and customer support tools.
WhatsApp Business API
The Business API was the first solution released by Meta to help companies interact with their customers on WhatsApp. It is typically self-hosted or managed by an approved provider, giving businesses more control over infrastructure. It supports templated outbound messages, customer replies, and rich media formats, making it suitable for enterprises that need to integrate WhatsApp directly into their CRM, contact center, or support system.
WhatsApp Cloud API
Launched later, the Cloud API is fully hosted by Meta. It removes the need for companies to manage servers or handle heavy infrastructure. The Cloud API provides similar core functionalities, sending and receiving messages, managing templates, and supporting media, while being easier to deploy for developers. It is positioned as a faster way to access WhatsApp programmatically, especially for businesses that want scalability without the overhead of on-premise hosting.
The complexity of WhatsApp integration
While Meta's Business and Cloud APIs provide powerful capabilities, their integration is far from straightforward. Developers need to manage business verification, template approvals, and message quotas before even going live. Hosting or connecting to the Cloud API also requires handling webhooks, encryption, and compliance with strict opt-in rules. These hurdles often delay projects and limit access to smaller SaaS providers who want to add WhatsApp quickly to their platforms.
Can you integrate WhatsApp into your own software?
How do you get WhatsApp API access?
What do you need before you can use the WhatsApp Cloud API?
What are the WhatsApp API limits?
| Limit | Value | Notes |
|---|---|---|
| Throughput | 80 messages / second | Platform-wide send rate |
| API rate limit | 200 to 5,000 requests / hour | Scales with account status and quality |
| Pair rate limit | 1 message / 6 seconds | Per recipient, prevents spamming the same user |
| Messaging tier | 250 → 2,000 → 10,000 → 100,000 → unlimited | Unique recipients per rolling 24h, starts at 250 unverified |
Can you use the WhatsApp API with an existing personal or Business App account?
How do you connect a WhatsApp account with Unipile?
// Node.js SDK
const { qrCodeString, code } = await client.account.connectWhatsapp();
// render qrCodeString to the user as an imagePOST /api/v1/accounts
X-API-KEY: your_api_key
{
"provider": "WHATSAPP",
"pairing_phone_number": "33612345678"
}
// 201 Created
{
"object": "AccountCreated",
"account_id": "e-ma1oQ..."
}POST /api/v1/chats/{chat_id}/messages
X-API-KEY: your_api_key
{
"text": "Hi! Your order has shipped."
}
// 201 Created
{
"object": "MessageSent",
"message_id": "msg_9f2c..."
}{
"account_id": "e-ma1oQ...",
"account_type": "WHATSAPP",
"event": "message_received",
"chat_id": "chat_182...",
"message_id": "msg_9f2c...",
"message": "Hi, is this order still available?",
"sender": { "attendee_provider_id": "33612345678@s.whatsapp.net" },
"timestamp": "2026-08-04T10:15:02Z"
}What can you build with the WhatsApp API?
| Capability | What it does | Notes |
|---|---|---|
| Send messages | Text, media, voice notes, documents | Voice notes: .mp3/.m4a. typing_duration simulates typing |
| List & sync chats | Pull every conversation into your own database | Cursor-based pagination, filter by account |
| React to messages | Add an emoji reaction to a message | WhatsApp and LinkedIn |
| Forward messages | Forward a message into another chat | WhatsApp only |
| Edit / delete messages | Edit or delete a message you sent | Delete: WhatsApp + LinkedIn. Edit: WhatsApp + LinkedIn Classic |
| Real-time webhooks | Push events: received, reaction, read, edited, deleted, delivered | No polling required |
List all WhatsApp chats into your software
GET /api/v1/chats?account_id=e-ma1oQ...&account_type=WHATSAPP&limit=50
X-API-KEY: your_api_key
// 200 OK
{
"object": "ChatList",
"items": [
{
"id": "chat_182...",
"account_id": "e-ma1oQ...",
"name": "Jordan Miles",
"unread_count": 2,
"archived": false
}
],
"cursor": "eyJsYXN0X2..."
}How Unipile helps developers connect WhatsApp instantly to their software
Unipile provides an alternative path for SaaS vendors who want to integrate WhatsApp without going through Meta's official partner program. We are not a Meta partner; instead, we offer a unified messaging API that allows developers to connect personal or business WhatsApp accounts instantly through a QR-code authentication flow. This approach makes it possible to add WhatsApp alongside other channels in just a few steps.
WhatsAppClassic
WhatsAppBusiness
WhatsApp Messaging Integration with Unipile
With Unipile, developers can integrate all core WhatsApp messaging features directly into their SaaS in just a few steps. The API supports simple text messages, media, and real-time sync so your users never miss an interaction.
LinkedIn
Gmail
Manage WhatsApp Groups with Unipile API
Unipile's WhatsApp API lets developers integrate full group management directly into their applications. Your users can create or join WhatsApp groups, send and reply to group messages, and synchronize conversations in real time.
Whether it's coordinating a recruitment session, managing sales discussions, or running community engagement, every group interaction can be centralized inside your CRM or ATS. With support for text, images, documents, and voice notes, teams stay connected and productive without leaving your platform.
List all WhatsApp chats into your software
curl --request GET --url https://api1.unipile.com:13111/api/v1/chats --header 'accept: application/json'
Unipile's API makes it easy to retrieve every WhatsApp chat linked to a user account. Whether it's individual messages, group discussions, or archived threads, developers can pull the full list of conversations with a single request. This ensures your SaaS platform can centralize all WhatsApp interactions in real time, providing users with a complete and unified inbox experience.
WhatsApp API features with Unipile
Integrate WhatsApp messaging into your CRM, ATS, or outreach tool with a single API. Sync chats, groups, and contacts in real time, on behalf of your authenticated users, without leaving your platform.
Messages
10 endpoints available
Account Connection
2 endpoints available
Attachments
2 endpoints available
Webhooks
3 events available
Does the WhatsApp API support group messaging?
Which WhatsApp automation tools and APIs should you use in 2026?
| Profile | What they need | Best-fit approach |
|---|---|---|
| SaaS / CRM embedding user-owned accounts | Each end-user connects the WhatsApp (and often LinkedIn, Instagram, email) they already have, inside your product | Unified session API, no per-user Meta verification |
| Enterprise broadcasting at scale | One verified business number sending marketing or utility templates to a large audience | Meta's Cloud API directly, or through a BSP |
| Developer prototyping | Fastest possible path to a working integration before committing to infrastructure | Session API for user-owned accounts, Cloud API sandbox for a single business number |
What are Meta's WhatsApp API best practices?
Where to go next with the WhatsApp API
Why Choose Unipile Instead of Building on Meta
Skip the limitations of Meta's APIs. Here's how Unipile compares on speed, effort, and access, so you can focus on building instead of battling with setup.
| Criteria | Meta APIs | Unipile |
|---|---|---|
| Time to integrate | Weeks or months | 2-3 days |
| Dev effort | High | Low (REST + SDKs) |
| Maintenance | Manual | Fully managed |
| Access to features | Partial (after approval) | Full, instantly |
| Support | Self-service only | Dedicated tech team |
| Criteria | Meta APIs | Unipile |
|---|---|---|
| Time to integrate | Weeks/months | 2–3 days |
| Dev effort | High | Low (REST + SDKs) |
| Maintenance | Manual | Fully managed |
| Access to features | Partial (after approval) | Full, now |
| Support | Self-service only | Dedicated tech team |
Fast and simplified integration
With Unipile, onboarding WhatsApp takes just a few minutes. Developers can authenticate accounts through a secure QR-code, start sending and receiving messages right away, and benefit from dedicated support during setup. This approach drastically reduces time-to-market, making it easier for SaaS editors to launch new messaging features.
Complete messaging features
The Unipile API provides full access to WhatsApp’s essential functions: sending and receiving messages, voice notes, images, videos, documents, and syncing conversations in real time. All communications are centralized in a unified inbox, ensuring nothing is missed. Beyond WhatsApp, the same API connects LinkedIn, Instagram, Telegram, Messenger, X/Twitter, Gmail, and Outlook.
One dashboard for all your integrations
Manage all your LinkedIn, WhatsApp, Gmail accounts and more from a single, intuitive interface.
want to connect
Accounts
03/01/2025
02/15/2025
02/10/2025
03/01/2025
02/28/2025
02/20/2025
03/01/2025
02/25/2025
03/01/2025
02/22/2025
02/14/2025
02/12/2025
02/08/2025
02/05/2025
03/01/2025
02/15/2025
03/01/2025
02/22/2025
Quick WhatsApp API integration with QR-code authentication
With Unipile, connecting a WhatsApp account takes just a few minutes. The flow is simple, secure, and avoids Meta’s long business approval process. Here’s how it works:
1. Request a QR Code
Your application generates a unique QR-code via the Unipile API. Users simply scan it with WhatsApp to start authentication.
2. Display the QR Code
The QR-code can be displayed directly in your app using standard libraries (PHP or JS). Users scan it with their phone to link their account.
3. Confirm authentication
Once the code is scanned, the account status changes to connected. You can listen to this event either by polling the account status or by setting up a webhook for real-time confirmation.
4. Start messaging
As soon as the account is active, you can send and receive text messages, share images, videos, documents, and voice notes. Real-time webhooks also notify you about new messages, reactions, and read receipts.
Use Cases: Add WhatsApp to Your Product
Bring native WhatsApp messaging into the tools your users already work in, from sales to recruiting to multi-channel outreach.
CRM / Sales tools
Turn conversations into opportunities. Bring WhatsApp messages directly into your CRM. Centralize client chats, reply faster, share documents or voice notes, and trigger automated follow-ups, all from one place without switching tools.
WhatsApp for CRMATS / Recruiting
Connect with candidates where they are. Sync candidate conversations on WhatsApp and manage them in a shared inbox. Assign threads to teammates, collaborate easily, and keep every exchange visible in your ATS to speed up hiring decisions.
WhatsApp for ATSOutreach platforms
Multi-channel made simple. Build campaigns that combine WhatsApp, LinkedIn, and email into one unified workflow. Send personalized sequences, track replies in real time, and stay compliant while managing every conversation inside your outreach tool.
WhatsApp for Outreach toolExplore more with
our Messaging API
Unipile doesn’t stop at WhatsApp. Our unified API also connects with LinkedIn, Instagram, Messenger, X (Twitter), and Telegram. By centralizing all these channels in one place, your users can manage every conversation seamlessly. From DMs to comments and group chats, everything is accessible in a single inbox, helping teams reply faster, track engagement, and deliver a consistent user experience across platforms.
Integration Support and Resources for WhatsApp API Success
Technical Setup Made Simple
Quickly integrate WhatsApp messaging features using our fully documented API and SDK examples. Whether it's sending messages, sharing media, or syncing conversations, our tools are designed to help you go live in days instead of weeks.
Expert Support for Smooth Deployment
Our technical team works directly with your developers to guarantee a seamless onboarding. From authentication with QR-code to managing webhooks and debugging real-time message flows, Unipile experts guide your integration every step of the way.
Continuous Improvements and Compatibility
We continuously align our WhatsApp API endpoints with the latest updates. This ensures your product benefits from new features without unexpected changes or disruptions. You stay up to date and compliant, with zero maintenance overhead.
Final Thoughts
WhatsApp has become an essential channel for customer engagement, support, and sales, with billions of active users worldwide. While Meta's official Business and Cloud APIs provide robust capabilities, they often come with complexity: lengthy onboarding, business verification, quotas, and strict compliance rules. For many SaaS publishers, this creates friction and delays in delivering value to their users.
Unipile removes these barriers with a unified messaging API that makes WhatsApp integration fast, secure, and developer-friendly. Through a simple QR-code authentication, software companies can enable text messaging, media sharing, voice notes, and group conversations in just minutes, without becoming a Meta partner or hosting infrastructure. Real-time webhooks, message synchronization, and multi-channel compatibility ensure a seamless experience across WhatsApp, LinkedIn, Instagram, Telegram, Gmail, and Outlook.
By choosing Unipile, SaaS platforms can deliver true omnichannel communication: one API, one integration, unlimited potential. Whether you are building a CRM, ATS, or outreach solution, Unipile accelerates your time-to-market, reduces maintenance costs, and ensures compliance with the Digital Markets Act.
Now is the time to transform WhatsApp into a powerful asset for your product. Start building with Unipile today and give your users the communication experience they expect.
WhatsApp API - Frequently Asked Questions
message_received webhook event in real time, with the message text, sender and attachments, so you never have to poll for new messages.
