Skip to main content

About the WhatsApp Business Platform | Developer Documentation

About the WhatsApp Business Platform

Updated: Dec 5, 2025
TESTMARKER The WhatsApp Business Platform enables businesses to communicate with customers at scale.
This documentation is intended for developers using our APIs. If you are looking for information on other ways to use WhatsApp for your business see the WhatsApp Business site⁠.

Core APIs and capabilities

WhatsApp Cloud API

WhatsApp Cloud API enables you to programmatically message and call on WhatsApp. You can use Cloud API to send users a variety of messages, from simple text messages to rich media and interactive messages.
WhatsApp Cloud API includes:
    Messaging: Send text messages, rich media, and interactive messagesCalling: Make and receive calls to customersGroups: Create, manage, and message WhatsApp group conversations
    WhatsApp messaging provides a powerful and private way to engage with customers. Use Cloud API to:
      Send order confirmations and shipping updatesShare appointment availability and other remindersDrive upsell and cross-sell opportunitiesFacilitate end-to-end transactions, from product discovery to paymentEnable multi-factor authentication or one-time passwords to verify accounts and usersDeliver custom interactive conversational experiences

      Business Management API

      The WhatsApp Business Management API enables you to programmatically manage a WhatsApp Business Account and its associated assets.
      Manage account assets with Business Management API like:
        Business phone numbers: Add and remove phone numbers associated with your businessTemplates: Create and modify message templates for scalable messaging.
        Business Management API also gives you access to account analytics like:
          Messaging analytics: The number and type of messages sent and delivered.Pricing analytics: Granular pricing breakdowns for delivered messages.
          Template analytics: Sent/read/delivered template metrics, alongside template message button clicks.
          Learn more about message templates.Learn more about managing business phone numbers.Learn more about account analytics.

          Marketing Messages API for WhatsApp

          MM API for WhatsApp is an API for sending optimized marketing messages on WhatsApp.
          When you send marketing messages through the MM API for WhatsApp, you can access new features not available on Cloud API and get automatic optimizations, so high engagement messages can reach more customers.
          The MM API for WhatsApp includes:
            Quality-based delivery: Up to 9% higher marketing message deliveries over Cloud API for high engagement content.Automated creative optimizations: Automatic enhancements to marketing creative to increase message performance.Performance benchmarks and recommendations: Comparison of read and click rates versus similar templates from businesses in your region.Conversion metrics: Measure marketing messages that lead users to perform app events such as ‘Add to Cart’, ‘Checkout Initiated’, or ‘Purchase’.

            Key resources

            Business portfolios

            A business portfolio allows organizations to bring all their Meta business assets together so they can be managed in one place. On the WhatsApp Business Platform, a business portfolio mainly serves as a container for WhatsApp Business Accounts (WABA). You must have a business portfolio to use the platform.
            Business portfolios can be verified, and verification status factors into improved functionality, such as higher throughput and Official Business Account status.

            WhatsApp business accounts (WABA)

            A WhatsApp Business Account represents your business, storing metadata and linking to phone numbers, templates, and analytics.

            Business phone numbers

            Business phone numbers, real or virtual, are used for sending and receiving WhatsApp messages. They can have display names and earn Official Business Account status.

            Message templates

            Templates are customizable messages that you can construct in advance of sending them. Template messages generally require approval before you can send them.
            Templates are useful for messaging at scale. They are also the only type of message that can be sent to WhatsApp users outside of a customer service window.
            Templates have quality scores and are subject to various messaging limits.

            Test resources

            When you get started with Cloud API, a test WABA and test business phone number are automatically created for you. Test WABAs and test phone numbers are useful for testing purposes, as they have relaxed messaging limits and don’t require a payment method on file in order to send template messages.
            You can delete your business portfolio and its test resources if:
              You are an admin on the business portfolio associated with the appNo other apps are associated with the business portfolioThe business portfolio is not associated with any other WABAsThe WABA is not associated with any other business phone numbers.
              To delete your business portfolio and its test resources:
                Go to the App Dashboard > WhatsApp > Configuration panel.Locate the Test Account section.Click the Delete button.
                We recommend using our API Playground when testing endpoints. You can find the playground in the “API Reference” section on the left sidebar of this page. In each reference, there is a “Try it” button which opens the playground.
                Also helpful for testing is our Postman collection⁠.

                Tools and integrations

                WhatsApp Manager

                WhatsApp Manager is a web app for managing WABAs, phone numbers, templates, and reviewing analytics.

                Third-party SDKs

                Some SDKs, like PyWa⁠ (Python wrapper), are available but are not maintained or endorsed by Meta.

                Security and performance

                Throughput

                Business phone numbers can send up to 80 messages per second by default, with capacity upgrades available.

                Encryption

                With the Cloud API, every WhatsApp message continues to be protected by Signal protocol encryption that secures messages before they leave the device. This means messages with a WABA are securely delivered to the destination chosen by each business.
                The Cloud API uses industry standard encryption techniques to protect data in transit and at rest. The API uses Graph API for sending messages and Webhooks for receiving events, and both operate over industry standard HTTPS, protected by TLS. See our Encryption Overview whitepaper for additional details.
                See the WhatsApp Encryption Overview whitepaper⁠ for additional details.

                Scaling

                The Cloud API automatically scales usage within your rate limits.

                Rate limits

                Requests made by your app on your WhatsApp Business Account (WABA) are counted against your app’s request count. An app’s request count is the number of requests it can make during a rolling one hour.
                For the following endpoints, your app can make 200 requests per hour, per app, per WABA, by default. For active WABAs with at least one registered phone number, your app can make 5000 requests per hour, per app, per active WABA.
                Type of request Endpoint
                GET
                /<WHATSAPP_BUSINESS_ACCOUNT_ID>
                GET, POST, and DELETE
                /<WHATSAPP_BUSINESS_ACCOUNT_ID>/assigned_users
                GET
                /<WHATSAPP_BUSINESS_ACCOUNT_ID>/phone_numbers
                GET, POST, and DELETE
                /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
                GET, POST, and DELETE
                /<WHATSAPP_BUSINESS_ACCOUNT_ID>/subscribed_apps
                GET
                /<WHATSAPP_BUSINESS_ACCOUNT_TO_NUMBER_CURRENT_STATUS_ID>
                For the following Credit Line API requests, your app can make 5000 requests per hour.
                Type of request Endpoint
                GET
                /<BUSINESS_ID>/extendedcredits
                POST
                /<EXTENDED_CREDIT_ID>/whatsapp_credit_sharing_and_attach
                GET and DELETE
                /<ALLOCATION_CONFIG_ID>
                GET
                /<EXTENDED_CREDIT_ID>/owning_credit_allocation_configs
                For more information on how to get your current rate usage, see Headers.
                In addition, the platform applies several message rate limits:
                  Test message rate limit (for unverified WABAs)Quality rating and messaging limits (for verified WABAs)Capacity rate limit (for all accounts)Business phone rate limit (per phone number)
                  Pair rate limits
                  Business phone numbers can send 1 message every 6 seconds to the same WhatsApp user (0.17 messages/second), which equals about 10 messages per minute or 600 per hour. Exceeding this limit triggers error code 131056 until you are back within the allowed rate.
                  You may send up to 45 messages in a 6-second burst, but this “borrows” from your future quota. After a burst, you must wait the equivalent time it would take to send those messages at the normal rate (e.g., a burst of 20 requires a ~2-minute wait before sending more to that user).
                  To manage post-burst throttling, if a send request fails, retry after 4^X seconds (starting with X=0 and increasing X by 1 after each failure) until successful.

                  Terms and policies

                  User opt-in

                  You must obtain user opt-in before sending message templates. Opt-in must clarify your business name and intent.

                  Terms and policies

                  All platform use must comply with WhatsApp’s terms and policies. Using unauthorized third-party tools is prohibited.
                    Learn more about terms and policies.⁠

                    Next steps

                    Learn more
                      Display namesPhone numbersPricingWebhooks
                      Back to top