WhatsApp Cloud API setup: exact steps and 2026 India prices

Set up the WhatsApp Cloud API in Meta for Developers step by step, fix the usual errors, and see India's per-message prices from October 2026.

By the KutrimBots teamPublished November 4, 202610 min read

To set up the WhatsApp Cloud API, you create an app in Meta for Developers with the "Connect with customers through WhatsApp" use case, link a WhatsApp Business account, register a phone number that isn't already on WhatsApp, generate a permanent System User token, and point a webhook at the software that will reply, such as an AI agent. As of November 2026, Meta charges per delivered message in India: ₹0.8631 for marketing, ₹0.115 for utility and authentication, and ₹0.115 for service replies after each number's first 1,000 free a month. Going direct to Meta means you pay Meta's own rates with no partner in between.

This guide gives the exact clicks, the costs and the errors people hit most.

Why is the WhatsApp Cloud API setup so confusing?

Because it spans four Meta screens, Meta for Developers, Business Settings, WhatsApp Manager and Meta Business Suite, and the names keep changing. A few numbers explain most of the friction:

Two numbers to start. Meta's docs say new business portfolios are initially capped at two registered business phone numbers.
250 new contacts a day. A new portfolio can start conversations with 250 unique customers in a moving 24-hour period outside open chats, rising to 2,000 once you verify your business.
Short-lived test token. The token on the API Setup page expires quickly; production needs a System User token.
A rule change in October 2026. Service replies were free from November 2024 until September 30, 2026; since October 1, 2026 Meta charges them after 1,000 free per number each month.

What do you need before you start?

Have these ready; each one blocks a later step if it's missing.

You need	Why	Tip
A Facebook or managed Meta account	To register as a developer	Use a business owner's account, not an employee's personal one
A business portfolio	Owns the app, WhatsApp account and numbers	Create it in Meta Business Suite with your legal business name
A phone number not in use on WhatsApp	Meta won't register a number already on WhatsApp	A new SIM or a landline that can take a voice call
Access to SMS or voice calls on that number	For the verification code	Keep the SIM in a phone during setup
A payment method	Meta bills messages	India accounts must move to INR billing by December 31, 2026
Business documents	For business verification	Registration or tax papers in the portfolio's legal name, such as a GST certificate

How do you set up the WhatsApp Cloud API step by step?

Follow these steps in order. They match Meta's Cloud API get-started guide as of November 2026.

Register as a developer at developers.facebook.com.
Create the app. Open the App Dashboard, click Create App, add a name and email, choose Connect with customers through WhatsApp, pick or create your business portfolio, and click Create app.
Start using the API. On Customize use case → Connect on WhatsApp → Quickstart, click Start using the API. On the API Setup page, connect an existing WhatsApp Business account or click Create a WhatsApp Business account. Note the account ID shown.
Add your phone number. In the From dropdown, add a number, enter the display name, verify it by SMS or voice call, and set a two-step verification PIN (Meta requires one). Copy the Phone number ID shown below the dropdown: it's a long internal ID, not your phone number.
Create a permanent token. In Business Settings → System users, add a system user, then Assign assets: your app with Manage app and your WhatsApp account with Manage WhatsApp Business accounts, both under Full control. Click Generate token with the business_management, whatsapp_business_messaging and whatsapp_business_management permissions, set it to never expire, and store it safely.
Copy the App secret from App settings → Basic. It lets your software check that incoming webhooks really come from Meta.
Set up the webhook. In the app's WhatsApp → Configuration, enter the callback URL of the software that will receive messages and a verify token (a long random string you choose), click Verify and save, then under Webhook fields subscribe to messages. Without that subscription, nothing arrives.
Check the display name. It shows on your WhatsApp profile, and Meta verifies it against its display name guidelines once your number reaches a higher messaging limit; an approved name can appear at the top of chats. You can change it up to 10 times per 30 days, re-registering the number within 14 days of each approval.
Verify your business in Business Settings → Security Center. It lifts the 250-a-day limit to 2,000.
Add a payment method in WhatsApp Manager. Meta warned that accounts without one by September 30, 2026 could have service messages stopped from October 1.
Create message templates in WhatsApp Manager for anything you send outside the 24-hour window, and wait for approval.

How much does the WhatsApp Cloud API cost per message in India in 2026?

Meta charges per delivered message by category and country; replies inside a 24-hour customer service window are cheapest. Meta's India rate card effective October 1, 2026, linked from its pricing page:

Category	Used for	India (INR)	USD equivalent card
Marketing	Offers, launches, broadcasts	₹0.8631	$0.0118
Utility	Order updates, booking reminders, payment links	₹0.115	$0.0014
Authentication	One-time passwords	₹0.115	$0.0014
Authentication-international	OTPs in eligible cross-border cases	₹2.4971	$0.0304
Service	Free-form replies within 24 hours of the customer's message	₹0.115 after 1,000 free per number a month	$0.0014
Meta Business Agent	Meta's own AI replies	$2.00 per 1 million tokens	Same

What changed in 2026, according to Meta:

January 1: India's marketing rate went up.
April 1: India's authentication-international rate went up.
October 1: service messages are charged after 1,000 free per business number per month (no rollover, no volume tiers), and utility templates sent inside an open service window, free since July 1, 2025, are now charged too.
Volume tiers apply only to utility and authentication. On India's INR tier card, utility stays at the list rate up to 25 million messages a month, so a small business pays the list rate.

Is there a markup if you go direct?

No partner sits between you and Meta, so Meta bills its own rates to your payment method. A Business Solution Provider usually adds its own plan on top; Wati, for example, bills a subscription, messaging credits and add-ons separately. That's not automatically worse: providers handle onboarding, templates and an inbox for you. Confirm GST on Meta's invoice with your CA.

How do you add AI to your WhatsApp Cloud API number?

In KutrimBots, an agent connects to your number through the Cloud API, and the agent guides you through the Meta side. The steps:

Open the agent that will answer customers (a Support or Inbox agent works well).
Click Connect on WhatsApp. The agent walks you through creating a WhatsApp Business app in Meta for Developers, one step at a time, using the steps above.
Fill in the secure card. When you're ready, the agent shows a card asking for four values: Phone number ID, Access token (your permanent System User token), App secret and Webhook verify token. Never paste them in chat; the card saves them straight into the agent's settings, and the agent itself never sees them.
Finish the webhook. The agent configures its WhatsApp connection, restarts it and walks you through Meta's webhook step (callback URL, the same verify token, the messages field).
Test it. Message the number from your own phone and check the reply in the Inbox Manager, where every conversation and every reply appears.
Add booking templates if you take appointments. In Bookings → Settings, KutrimBots creates its booking messages (confirmation, reminder, cancellation, advance payment and missed appointment, in English or Hindi) as utility templates on your WhatsApp Business account; Meta reviews them, and they then go out even when the 24-hour window has closed.

What the agent does once it's live, from tone to handover, is a topic of its own; how to set up your first AI team covers roles and instructions.

What are the common Cloud API errors and how do you fix them?

Most setup failures come from five mistakes. Here's what each looks like.

Problem	Usual cause	Fix
Can't add the number; "already registered"	The number is in use on WhatsApp or the WhatsApp Business app	Delete that WhatsApp account first, or use a new number. Keeping one number in both the app and the API ("coexistence") is offered through Solution Partners' Embedded Signup
Graph error 100, "Object with ID does not exist"	The phone number was pasted instead of the Phone number ID	Copy the ID from API Setup
Graph error 190, authentication error	The temporary token expired, or the token lacks permissions	Generate a System User token with all three permissions, never expiring
"The callback URL or verify token couldn't be validated"	Verify token mismatch, or the URL isn't reachable over HTTPS	Use exactly the same verify token on both sides
Webhook verified but no messages arrive	Not subscribed to the messages field	Webhook fields → Manage → messages
Error 131047, "Re-engagement message"	More than 24 hours since the customer last wrote	Send an approved template instead
Sends stop after 250 new contacts	New portfolio messaging limit	Verify your business to reach 2,000
Display name rejected	Name doesn't match Meta's guidelines	Edit it in WhatsApp Manager and resubmit

Example scenario: a coaching centre's monthly WhatsApp bill

Example scenario with Meta's India rates as of November 2026: a coaching centre in Indore runs an AI agent on its Cloud API number.

Replies to enquiries: 2,400 service messages a month. First 1,000 free, then 1,400 × ₹0.115 = ₹161.
Demo-class reminders: 450 utility templates × ₹0.115 = ₹51.75.
One admissions announcement to 600 past enquirers who opted in: 600 marketing templates × ₹0.8631 = ₹517.86.
Total Meta fees: about ₹731 a month, before tax.

The software side is separate: on KutrimBots that's the Solo plan at $20 a month for up to 5 agents (see pricing), and the AI cost of 2,400 replies (about $0.003 each, roughly $7.20) fits in Solo's $10 of included usage. The marketing message is the expensive line; most of the value comes from cheap service replies.

What the Cloud API can't do

It isn't an app. There's no screen to read chats; you need software, an inbox or an agent on top.
One number, one home. With your own Meta app, the number must not be on WhatsApp; coexistence needs a Solution Partner, and Meta lists limits such as no group chat sync.
No free-form messages after 24 hours. Only approved templates, and Meta can pause low-quality ones.
Limits grow slowly. 250 new contacts a day until you verify, then 2,000, with higher tiers through Meta's automatic scaling.
Tokens are keys. Anyone with your access token can send as your business. Keep it out of chats, screenshots and spreadsheets; our guide to whether AI agents are safe explains how KutrimBots keeps such secrets out of the agent's view.

KutrimBots has a free 7-day trial on Solo: add a card or UPI, nothing is charged today, and you can cancel before it renews.

Frequently asked questions

Is the WhatsApp Cloud API free?

Meta charges per delivered message rather than a subscription. As of November 2026 in India, each number gets 1,000 free service replies a month, then ₹0.115 each; templates are charged from the first message.

How long does WhatsApp Cloud API setup take?

The developer steps take an afternoon if your documents are ready. Display name review and business verification can take longer, and you can test with the starting limits while you wait.

Can I use my existing WhatsApp Business number with the Cloud API?

Only if you delete it from WhatsApp first, when you connect your own Meta app. Keeping it in the app and the API together is possible through a Solution Partner's coexistence onboarding.

What is the WhatsApp API price per message in India in 2026?

Meta's India card effective October 1, 2026 lists ₹0.8631 for marketing, ₹0.115 for utility, ₹0.115 for authentication and ₹0.115 for service replies beyond the free 1,000 a month per number.

Do I need a Business Solution Provider in India?

No. You can connect directly through Meta for Developers and pay only Meta's rates. A provider makes sense if you want onboarding help, a ready team inbox or bulk broadcast tools.