How to connect WhatsApp to GoHighLevel with the official API
Setup, real costs, coexistence, templates and the errors to avoid, from four connections done on the official API.
By Lucas Nobre ·
I've connected WhatsApp to GoHighLevel for four businesses, always through the official API, and added AI agents that answer leads in under five seconds. This guide covers what you need before you start, each step, what it really costs after Meta's October 2026 pricing change, and the errors I see most often. Several popular guides still describe the old pricing and say your number can't stay on the WhatsApp app. Both changed.
GoHighLevel connects to WhatsApp through Meta's official WhatsApp Business API, right inside your sub-account. You subscribe for US$10 a month, log in to Meta through a pop-up, pick or create your WhatsApp Business account, add a number and verify it. The whole connection takes under an hour. Meta charges per delivered message on top of the subscription.
Before you start
- A GoHighLevel sub-account where WhatsApp will live. WhatsApp is set up per sub-account, not at the agency level.
- A Meta Business portfolio (formerly Business Manager) with admin access. You can create one during the connection.
- A phone number that can receive a code by text or call. It can be a new number, or the number you already use on the WhatsApp Business app (see coexistence below).
- A website that shows your business name. Meta checks your display name against it.
- A card on file in GoHighLevel, because messages are paid from your wallet.
New number or your current one? (coexistence)
Since 2025, Meta lets you keep using the WhatsApp Business app on your phone and connect the same number to GoHighLevel. Meta calls this coexistence. What to know before choosing it:
| New number | Coexistence (current number) | |
|---|---|---|
| Chat history | Starts empty | Up to 6 months of history comes into GoHighLevel |
| Phone app | Not used | Keeps working on your phone |
| Templates and campaigns | From GoHighLevel | From GoHighLevel only, not from the app |
| Groups, broadcast lists, calls | Not available | Not available for the connected number |
| Speed limit | Standard API limits | 20 messages per second |
I recommend coexistence when customers already know your number. I recommend a new number when you're starting fresh or want to keep personal and business chats apart.
Step by step
- Open WhatsApp in your sub-account settings and start the subscription (US$10 a month).
- Click to connect. A Meta pop-up opens. Keep it open until the end, because closing it cancels the process.
- Log in with the Facebook account that manages your business, then pick your Meta Business portfolio or create one.
- Choose or create the WhatsApp Business account, then set the display name customers will see. Use your real business name, exactly as it appears on your website.
- Add the phone number. For a new number, verify it with the code Meta sends. For coexistence, choose the option to connect the WhatsApp Business app and scan the QR code from the app on your phone.
- Finish and return to GoHighLevel. The number shows as connected in the WhatsApp settings.
- Complete Meta Business Verification if you haven't yet. You can start sending before it, with lower limits, but verification raises them and helps your display name get approved.
- Create your first templates (see below) and send yourself a test.
In my four implementations, Meta approved the connection, the display name and the templates in minutes, two hours at most. Meta's own guidance allows for up to a few days, so don't plan a launch on the same afternoon.
Templates: what they are and why they get rejected
Outside the 24-hour window after a customer's last message, you can only send pre-approved templates. Each template has a category, and the category sets the price: marketing (offers, re-engagement), utility (confirmations, reminders, updates) or authentication (codes).
The rejection reasons I see most, which Meta's own documentation lists too:
- Wrong category. A promotion submitted as utility gets rejected or reclassified as marketing.
- Broken variables. Variables must be sequential ({{1}}, {{2}}), can't contain symbols like #, $ or %, and the message can't end with one.
- Too many variables for the length. A short message with four variables looks like spam to Meta.
- Duplicates. The same text as an existing template is rejected.
- Policy content. Asking for sensitive data, or promoting what WhatsApp's Commerce Policy forbids.
When a template is rejected, read the reason Meta gives, fix only that and resubmit. Most of my rejections were solved in one edit.
What it really costs in 2026
There are three parts: US$10 a month per sub-account to HighLevel, Meta's fee per delivered message, and a 5% processing fee on usage.
| Message type | US and Canada | Brazil |
|---|---|---|
| Marketing | US$0.0263 | US$0.0656 |
| Utility | US$0.0034 | US$0.0071 |
What changed on October 1, 2026: service messages (your free-form replies inside the 24-hour window) and utility templates sent inside that window started being charged. Each number gets 1,000 free service messages a month. Conversations started from a Click-to-WhatsApp ad stay free for 72 hours.
Example monthly bill for a US business: 500 marketing messages (about US$13), 1,000 utility messages outside the window (about US$3.40) and 1,000 replies inside the window (free, within the allowance), plus the US$10 subscription and the 5% fee: about US$28 a month. Meta updates rates every quarter, so check the current table before you launch.
The setup itself is a separate cost: what GoHighLevel really costs, from the audit to monthly support.
Agencies can resell WhatsApp to clients with their own price and a usage markup from 1x to 10x.
The errors I see most often, and the fix
| Error | Why it happens | Fix |
|---|---|---|
| Number not eligible during setup | The number is still attached to another WhatsApp provider | Disconnect it from the other provider, then try again |
| Display name rejected | The name doesn't match the business or doesn't appear on your website | Put the exact name in your website footer and resubmit, or appeal in WhatsApp Manager |
| Template rejected | Category, variables, duplicates or policy (see above) | Read Meta's reason, fix it and resubmit |
| Message not sent outside 24 hours | Free-form text was sent after the window closed | Send an approved template instead |
| Customer's message shows as unsupported | Polls and some message types aren't supported by the API | Nothing to fix in GoHighLevel; it's an API limit |
| Error 131051 | Messaging another WhatsApp API number | Test with a regular phone, not another API number |
| Messages stop sending | Wallet is out of credit | Top up and turn on auto-recharge |
What to automate first
Once WhatsApp is connected, these are the workflows that pay for themselves fastest:
- Instant reply to new leads from forms, ads and your website, in seconds.
- Appointment confirmations and reminders with utility templates.
- Follow-up for leads who went quiet, with a limit so you don't spam.
- An AI agent that qualifies leads. Most agents I build do two jobs: they check whether the person fits the sales criteria, and they answer technical questions about the service. Each agent is trained on both.
In the implementations I've done, AI agents on WhatsApp answer in under 5 seconds, handle 70% of conversations without a human, and 83% of the leads they pass to sales arrive qualified.
Why not use an unofficial tool?
QR-code tools that mirror the WhatsApp app are cheaper and easier to start. They aren't approved by Meta, they depend on a phone session staying connected, and the number can be blocked along with every conversation in it. That's a risk I don't put on a client's business. The official API costs a bit more and gives you approved templates, stable sending and a number you keep.
Frequently asked questions
Do I need a new number to use WhatsApp in GoHighLevel?
No. With coexistence, you can connect the number you already use on the WhatsApp Business app.
How long does approval take?
In my projects, minutes, two hours at most. Plan for up to a few days in case Meta asks for more information.
Can I send bulk messages?
Yes, with approved marketing templates to contacts who opted in. Each delivered message is charged.
Can I call customers through WhatsApp in GoHighLevel?
Business-initiated WhatsApp calls aren't available for US or Canada numbers, and coexistence numbers don't support calls.
Does WhatsApp work in every sub-account automatically?
No. Each sub-account needs its own subscription and its own number.
Can you set this up for me?
Yes. I set up the connection, the templates, the workflows and the AI agent.
Lucas Nobre
I'm Lucas Nobre, a freelance marketing and CRM specialist based in Fortaleza, Brazil. I started as a software developer at HP, which is why I test everything before it goes live.
Since 2021 I've built 150+ GoHighLevel sub-accounts and 100+ websites across 20+ industries, for clients in the US and 6+ other countries. Certified by CXL and the Interaction Design Foundation. My client work is under NDA, so names stay private.
Want WhatsApp running inside your GoHighLevel?
Tell me who you message and how many conversations you have a month. I'll reply with the setup and what it will cost to run.
Email me