Skip to content

How to get the official WhatsApp Business API: step by step

What you need, the possible paths (directly with Meta or through a partner) and the step-by-step to activate the official WhatsApp Business API in 2026, based on Meta's documentation.

Marlos Carmo

Founder of Tolky

Updated on November 16, 2026

12 min read
How to get the official WhatsApp Business API: step by step

Share

Anyone searching "how to get the WhatsApp API" is almost always at the same point: the company phone can no longer keep up, conversations get lost across devices and someone suggested automating. The next question is whether approval is required, how long it takes and whether the current number can be reused.

The good news is that access has become simpler. Since Meta consolidated everything into the Cloud API, there is no server to install and signup can be done in minutes. What usually stalls projects is what comes before: a number already used in the app, a portfolio without verification, a rejected display name.

This guide lays out the path based on Meta's official documentation consulted on November 16, 2026. Meta's rules change; always check the linked sources before planning.

Updated in November 2026.

What is the official WhatsApp Business API?

The official WhatsApp Business API is the Meta-authorized way to connect a WhatsApp number to systems, chatbots, AI agents and CRMs, sending and receiving messages through software. Today it is offered as the Cloud API, hosted by Meta itself.

The old On-Premises version, which companies installed on their own servers, has been retired. According to Meta, since July 1, 2024 new numbers can only be registered on the Cloud API, and the last version of the On-Premises client expired on October 23, 2025. Source: On-Premises API sunset, consulted on November 16, 2026.

In practice, "official API" is the opposite of tools that simulate WhatsApp Web, which expose the number to being banned. For the advantages of the official channel, see the benefits of the WhatsApp Business API.

What are the paths to getting the API?

There are three paths to the official API: build the integration directly on the Cloud API, connect through a platform that uses Meta's Embedded Signup or sign up through a BSP. All three lead to the same place, a number registered on the Cloud API, but they change who takes care of the technology.

PathHow it worksWho it makes sense for
Directly on the Cloud APIThe company creates an app on Meta for Developers, generates tokens and builds the integrationEngineering teams that will build their own system
Platform with Embedded SignupThe company logs in with its Meta account inside the platform, picks the portfolio and connects the number in a few screensThose who want to serve customers, sell and automate without writing code
Through a BSPA business solution provider (BSP) that partners with Meta makes the connection and can offer its own support and billingCompanies that prefer a contract with the provider and dedicated support

Embedded Signup is the flow in which Meta's login opens inside the partner's tool. The company authorizes access, creates or selects the WhatsApp account and verifies the number without leaving the platform. Source: Embedded Signup overview, consulted on November 16, 2026.

What do you need before you start?

Before any signup, gather five items: access to a Meta business portfolio, the number you will use, the display name, the company details for verification and a payment method. The table summarizes what the documentation asks for and where each item is configured.

ItemWhat Meta asks forWhere to configure it
Account and portfolioA Facebook account or Meta managed account and a business portfolioMeta Business Suite
Phone numberA number you own, with country and area code, able to receive SMS or calls; short codes are not acceptedWhatsApp Manager or Embedded Signup
Available numberA number not in use on another WhatsApp account, except through coexistenceWhatsApp or WhatsApp Business app on the phone
Display nameA name tied to the company and within Meta's guidelinesWhatsApp Manager
Two-step PINA 6-digit PIN set when registering the numberWhatsApp Manager or API
PaymentPayment method for the Messaging accountMeta Business Suite

Sources: getting started with the Cloud API and business phone numbers, consulted on November 16, 2026.

Does the number need to be new?

No, but it needs to be available. According to the documentation, numbers in use on WhatsApp can only be registered on the API after being deleted from the current account. The exception is coexistence, which keeps the number in the WhatsApp Business app and connects it to the API at the same time. We explain the feature in WhatsApp coexistence: the app and the API on the same number.

Step-by-step to get the official API

The most common path, through Embedded Signup, has five steps and can be completed the same day when the items above are ready. Direct Cloud API integrations follow the same points inside the developer dashboard.

Step 1: Organize the business portfolio

Confirm who is an admin of the portfolio in Meta Business Suite. The WhatsApp account needs to sit in your company's portfolio, not in an agency's or an employee's. This avoids losing access to the number when someone leaves.

Step 2: Choose the path and the provider

Decide whether you will integrate directly, use a platform with Embedded Signup or sign up through a BSP. Ask the provider whether the account stays in your name, how Meta's billing works and whether it supports coexistence, in case you want to keep the app.

Step 3: Connect the account and verify the number

In Embedded Signup, you log in with your Meta account, choose the portfolio, create the WhatsApp account (the current documentation calls it a Messaging account) and enter the number. Meta sends a code by SMS or call to confirm ownership.

Step 4: Set the display name and the PIN

Enter the name customers will see and set the 6-digit two-step verification PIN. A name unrelated to the company, with a person's name or with formatting outside the rules may be rejected. Keep the PIN: you need it to change the PIN or delete the number.

Step 5: Register the number and set up payment

The number needs a connected status to send and receive messages. Add the payment method for the Messaging account. In Brazil, Meta has billed in Brazilian reais (BRL) through Facebook Brasil since July 1, 2026, and the currency chosen when the account is created cannot be changed later. Source: platform pricing, consulted on November 16, 2026.

Do I need to verify my business with Meta?

Business verification is not required to get started, but it is what unlocks higher limits, more numbers and the request for an Official Business Account. It is done in the Security Center of Meta Business Suite.

Under the process Meta describes, you provide the company's legal name, address, phone and website, exactly as they appear in the official registry. If Meta cannot find the record, it may ask for documents such as the articles of incorporation or, in Brazil, the CNPJ card, plus proof of address. Then you confirm the connection by email, phone, SMS, WhatsApp or domain verification. Source: verify your business in Meta Business Suite, consulted on November 16, 2026.

With the business verified and the name approved, the number can request Official Business Account status, which shows the blue verified badge. See how to request an Official Business Account on WhatsApp.

Which limits apply at the start?

Every new portfolio starts with low sending and number limits, which go up as the company gets verified and sends quality messages. They do not affect service to people who write first, only the volume of contacts the company initiates.

  • Messaging limit: a new portfolio starts at 250 unique users per rolling 24-hour period for messages outside the customer service window. The next tiers are 2,000, 10,000, 100,000 and unlimited. The limit applies to the whole portfolio, shared across its numbers.
  • How to move up to 2,000: verify the business (or have verification done by the partner that handled the signup) or send 2,000 messages outside the window to unique numbers within 30 days, with high-quality templates.
  • Numbers per portfolio: starts at two registered numbers and goes up to 20 when the business is verified or reaches the 2,000 limit.

Sources: messaging limits and business phone numbers, consulted on November 16, 2026.

How much does the official API cost?

Meta has charged per delivered message since July 1, 2025, with different rates by category and by country. Messages the customer sends to the business are not charged by Meta. Platforms and providers charge separately for the software.

Rates and rules changed again on October 1, 2026, when service and utility messages inside the window started being charged, with a monthly allowance of service messages per number. The details are in the WhatsApp Business cost guide. To estimate the cost for your volume, use the free WhatsApp pricing simulator.

Outside the window, the business can only reach people with approved templates and only those who gave opt-in. The campaign playbook is in 24-hour window, templates and campaigns.

Common mistakes that delay activation

Most delays come from signup details, not from technology. Use the table as a checklist before you start.

MistakeWhat happensHow to avoid it
Using a number active in the app without planningRegistration fails or the history is lostDecide in advance between deleting the app account and using coexistence
Account created in the agency's portfolioThe company loses control of the numberCreate the account in the company's own portfolio
Generic display name or one with a person's nameName rejected and messages blockedUse the brand name, the same as on the website
Verification details that differ from the CNPJ (in Brazil)Verification rejectedCopy the legal name and address from the official registry
Number behind an IVRThe verification code never arrivesMake sure the call or SMS reaches a person
Wrong currency on the accountBilling stays in another currency for goodChoose BRL at creation if the company bills in Brazil

Where does Tolky fit in?

Tolky is a conversational AI CRM that connects to the official WhatsApp Business API, directly with Meta (Cloud API) or through Gupshup, an official Meta partner. For the direct connection, you use the "Connect with Meta" button, which opens Embedded Signup: you log in with your Meta account, choose the portfolio and connect the number, with nothing to install.

When enabled for your account, coexistence keeps the number in the WhatsApp Business app on the phone. If someone on the team replies from the phone, the AI pauses in that conversation. Once connected, the number is handled by AI agents, with handoff to people and history in the CRM. See the WhatsApp integration and the WhatsApp customer service solution.

Tolky does not replace Meta's rules: business verification, name approval and sending limits still apply to any provider. There is also no SMS or email channel on the platform.

Frequently asked questions

Do I need a CNPJ to get the official WhatsApp API?

To get started, Meta asks for a business portfolio and a valid number. To verify the business, however, you have to prove the company's legal name, address and phone, which in Brazil usually involves the CNPJ. Without verification, the company stays at the initial limits.

How long does it take to activate the API?

With the portfolio, an available number and the display name ready, Embedded Signup can be completed the same day. Business verification and the name review can take longer and have no fixed timeline published by Meta.

Can I use the same number I already use on WhatsApp Business?

Yes, in two ways. You can delete the app account and register the number on the API, or use coexistence, when available, to keep the number in the app and on the API at the same time, with up to 180 days of history synced.

Can I use the official API without coding?

Yes. Platforms with Embedded Signup make the connection in a few screens and come with customer service, campaigns and automations ready to use. Coding is only needed when the company wants to build its own system on top of the Cloud API.

How does Meta charge for using the official API?

According to Meta's pricing page, billing is per delivered message, with a rate by category and by country, and the invoice is issued in Meta Business Suite. Platforms and providers charge for their own software separately. See the cost guide.

What is the difference between a BSP and a platform with Embedded Signup?

A BSP is a Meta partner that provides access to the API and can offer its own support and billing. A platform with Embedded Signup connects the number inside its own tool. Some platforms offer both paths.

What happens if I leave the platform later?

If the WhatsApp account is in your company's portfolio, the number remains yours and can be connected to another provider by following Meta's migration process. So create the account in your own portfolio from the start.


Conclusion

Getting the official WhatsApp Business API in 2026 is less a technical matter and more a matter of preparation: a portfolio in the company's name, an available number or planned coexistence, the right display name and business verification to grow. With that in order, the connection takes minutes, and the work becomes what to do with the conversations. For the other topics, check the WhatsApp Business Guide.

See the WhatsApp integration, check the plans or talk to the team →. Let's talk?

Share

Tags

  • how to get the official WhatsApp API
  • #WhatsApp Business API
  • Cloud API
  • Embedded Signup
  • Meta business verification
  • WhatsApp BSP
  • phone number for WhatsApp API
  • WhatsApp messaging limit

About the author

Marlos Carmo

Founder of Tolky

Marlos Carmo is an AI entrepreneur and founder of Tolky, the conversational-era infrastructure and AI CRM that unifies intelligent service, multi-channel support (such as WhatsApp and voice), live CRM, and operational intelligence in a single ecosystem. He is a finalist for the SXSW Innovation Awards and a member of Francesco's Economy, a global network of young entrepreneurs focused on innovation and social impact. He works connecting Artificial Intelligence and digital transformation in projects for large organizations.

Next step

Want to bring this to your operation?

Tati, Tolky's AI assistant, understands your scenario in a few questions, suggests the best path and connects you with someone from the team, with full context.

Read also