Developer guide. Updated November 9, 2026

WhatsApp Cloud API: how to set up Meta's official API, step by step

Everything between creating a Meta app and sending your first real message: test number, permanent token, webhooks, templates and limits. And a shorter path for the part that comes after the setup.

What is the WhatsApp Cloud API

The WhatsApp Cloud API, also called the Meta Cloud API, is Meta's official, Meta-hosted API for businesses to send and receive WhatsApp messages from software. You call Meta's Graph API to send, and Meta calls your webhook when a customer writes or a message is delivered or read.

It is the same thing people mean by the WhatsApp Business API or the WhatsApp Business Platform. Meta has retired the self-hosted On-Premises API, so the Cloud API is the only version for new projects.

WhatsApp Cloud API setup in 7 steps

Setting up the WhatsApp Cloud API on your own takes seven steps, from the Meta app to business verification.

  1. 1. Create a Meta developer app

    Go to developers.facebook.com, create an app of the Business type and add the WhatsApp product. Meta links the app to a business portfolio (formerly Business Manager) and creates a WhatsApp Business account for it.

  2. 2. Send a test message from the test number

    Meta gives every new app a test phone number and a temporary access token. Add up to five recipient numbers, send the hello_world template from the API Setup page, and you have proof that the API works before you touch your real number.

  3. 3. Register your business phone number

    Add the number your customers will see. It must receive a verification code by SMS or voice call, and it cannot be active in the WhatsApp or WhatsApp Business app at the same time unless you use Meta's coexistence option. Set the display name, which Meta reviews.

  4. 4. Create a permanent access token

    The token on the API Setup page expires in 24 hours. For production, create a system user in your business portfolio, give it access to the app and the WhatsApp account, and generate a token with the whatsapp_business_messaging and whatsapp_business_management permissions.

  5. 5. Set up the webhook

    Incoming messages and delivery statuses reach you only through a webhook. Your HTTPS endpoint has to answer Meta's verification request with the hub.challenge value, then you subscribe the app to the messages field. Plan for retries: Meta resends events your server did not acknowledge.

  6. 6. Get your message templates approved

    To start a conversation, or to write after the 24-hour customer service window closes, you need a template approved by Meta, in the marketing, utility or authentication category. Inside the window, free-form text is allowed.

  7. 7. Verify your business and add a payment method

    Meta charges per delivered template message, so the WhatsApp Business account needs a payment method. Business verification raises your limits and is required for some features, such as the official business account badge request.

What you still have to build after the setup

After the setup, the Cloud API delivers messages, and the rest is yours to build:

  • A webhook server that is always online, answers fast and handles Meta's retries without duplicates.
  • Storage for conversations and media, because Meta's media links expire.
  • Tracking of the 24-hour window, so you know when to send text and when you need a template.
  • Template creation and status checks, plus alerts when Meta lowers your quality rating.
  • Token rotation, monitoring and a way to see what happened when a message fails.

The shorter path: the Cloud API through Ubli

With Ubli you still do steps 1 to 4 in your own Meta account, so the number and the WhatsApp Business account stay yours. Then you paste three values into the Ubli dashboard (the Phone Number ID, the WhatsApp Business Account ID and the permanent token), point Meta's webhook to the address Ubli gives you, and the rest of this page is done.

You get a simple REST API, signed webhooks with retries, conversation and media storage, bot rules and template management, for $39 per month for the first number. Meta keeps billing its message fees to your own WhatsApp Business account, with no markup.

Frequently asked questions

What is the WhatsApp Cloud API?+

The WhatsApp Cloud API is the version of the WhatsApp Business API that Meta hosts on its own servers. Your system sends messages with HTTPS requests to Meta's Graph API and receives messages through a webhook, without running any WhatsApp server yourself.

Is the WhatsApp Cloud API free?+

Meta has no fee for access to the Cloud API, but it charges per delivered template message, by category and country. For US numbers, utility and authentication messages cost about $0.0034 each. Messages customers send you are free. See our WhatsApp Business API pricing guide for the full breakdown.

What is the difference between the Cloud API and the WhatsApp Business API?+

The Cloud API is the WhatsApp Business API, hosted by Meta. There used to be an On-Premises version that companies ran on their own servers, but Meta has retired it, so today the Cloud API is the way to use the WhatsApp Business API.

Can I use my current WhatsApp number with the Cloud API?+

Yes. You can move a number that is on the WhatsApp Business app to the Cloud API. Depending on your country, Meta's coexistence option lets you keep using the app on the phone with the same number while the API runs.

How many messages can I send with the Cloud API?+

Replies to customers who wrote to you have no daily cap. Conversations you start with templates follow a messaging limit that begins low for new accounts and goes up automatically as you send good quality messages. Business verification also raises it.

Do I need a Business Solution Provider to use the Cloud API?+

No. You can use the Cloud API directly with your own Meta app. A provider such as Ubli saves you the webhook infrastructure, the storage, the template management and the dashboard, and gives you support when something goes wrong.

Keep the official API, skip the infrastructure

Bring your Cloud API number to Ubli and send your first message with one API call.