How to connect and activate a new WhatsApp Business number in Meta Business Portfolio

What "activation" actually means

Your number moves through a few states:

Status	What it means
Pending	The number is added and verified, but not yet registered on the Cloud API. It cannot send or receive messages yet.
Connected	The number is registered and live. It can send and receive messages through the API.

The step most people miss is registration — the action that takes you from Pending to Connected.

Prerequisites

Before you start, make sure you have:

✅ Admin access to your Meta Business Portfolio (formerly Business Manager) and its WhatsApp Manager.
✅ A phone number that is not currently active in the WhatsApp consumer app or the WhatsApp Business app. A number can't be registered on the Cloud API while it's still active elsewhere — delete that account first if needed.
✅ Access to receive an SMS or voice call on the number, to complete verification.
✅ A System User access token with the whatsapp_business_management and whatsapp_business_messaging permissions (we create this in Step 4).
✅ A 6-digit PIN for two-step verification, or a new one you'll set during registration.

Step 1 — Add the phone number in WhatsApp Manager

Open your Meta Business Portfolio and go to WhatsApp Manager.
Select your WhatsApp Business Account, then open the Phone numbers tab.
Click Add phone number.
Enter your business details and a display name for the number (this is the name recipients will see). Meta reviews display names, so follow their naming guidelines to avoid rejection.
Choose your phone number and how you want to receive the verification code — SMS or Voice call.

Step 2 — Verify the phone number

Enter the verification code you received by SMS or voice call.
Once verified, the number appears in your WhatsApp Business Account — typically in Pending status.

Important: Verified ≠ activated. At this point the number is verified and owned by you, but it still needs to be registered (Steps 5–6) before it can send or receive messages.

Step 3 — Find your Phone Number ID

Registration uses the number's Phone Number ID — a numeric identifier, not the phone number itself.

In WhatsApp Manager, open your number and go to API Setup (in the App Dashboard, this is under WhatsApp → API Setup).
Copy the Phone number ID value shown there. You'll use it as <PHONE_NUMBER_ID> below.

Step 4 — Create a System User access token

Registration must be authenticated with a token that has the right permissions. A System User token from your Business settings is the reliable choice (it doesn't expire the way temporary tokens do).

In your Meta Business Portfolio, go to Business settings → System users.
Click Add to create a system user (or select an existing one), and give it Admin access.
Assign assets: grant the system user control over your WhatsApp Business Account (and the associated app) with full control.
Click Generate new token, select your app, and enable these permissions:
- whatsapp_business_management
- whatsapp_business_messaging
Generate the token and store it securely — you'll need it for registration and for any future re-registration or migration.

Tip: Treat this token like a password. Anyone with it can manage messaging for your number.

Step 5 — Set or confirm your two-step verification PIN

Registration requires a 6-digit PIN. How you handle it depends on your number's current state:

If two-step verification is already enabled on the number, use that existing 6-digit PIN in Step 6.
If it isn't enabled yet, the PIN you provide during registration becomes your two-step verification PIN. Choose one you'll remember — you'll need it for future re-registrations and migrations.
If you've forgotten an existing PIN, disable or reset two-step verification first (via your number's settings in WhatsApp Manager, or POST /<PHONE_NUMBER_ID>/settings), then register with a new PIN.

Step 6 — Register the number on the Cloud API

This is the activation step. Send a POST request to Meta's registration endpoint using your Phone Number ID, System User token, and PIN.

POST https://graph.facebook.com/v21.0/<PHONE_NUMBER_ID>/register
Authorization: Bearer <SYSTEM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
  "messaging_product": "whatsapp",
  "pin": "<6-digit-PIN>"
}

Replace:

<PHONE_NUMBER_ID> — the numeric ID from Step 3 (not the phone number).
<SYSTEM_USER_ACCESS_TOKEN> — the token from Step 4.
<6-digit-PIN> — your existing or newly chosen PIN from Step 5.

Tip: You can send this request from any HTTP client (Postman, cURL, or your own code). It's a one-time activation call. Use the current Graph API version if v21.0 is no longer the latest.

Step 7 — Confirm the number is Connected

A successful registration returns:

{
  "success": true
}

When you see this, the number flips from Pending → Connected in WhatsApp Manager and is live — it can now send and receive messages through the API.

Step 8 — Add a payment method (required to send template messages)

A Connected number can receive messages and reply within the 24-hour customer service window, but it cannot send template messages — marketing, utility, or authentication templates — until a valid payment method is on the account.

In your Meta Business Portfolio, go to WhatsApp Manager → your WhatsApp Business Account → Billing / Payment settings (also reachable via Business settings → WhatsApp Accounts → Payment methods).
Add a valid payment method (credit card) and confirm it's set as the active payment method for the account.
Once billing is active, your number can send template messages within Meta's messaging limits.

Important: Skipping this is the most common reason a fully-registered, Connected number still can't send outbound templates. If template sends fail, check the payment method first.

Troubleshooting

Important: Meta allows a maximum of 10 registration requests per number in a rolling 72-hour window. Exceeding it returns error 133016 and locks the number for 72 hours. Double-check your Phone Number ID, token, and PIN before retrying so you don't burn attempts.

Error 133016 / too many attempts — you've hit the 10-requests-per-72-hours limit. Wait for the 72-hour window to clear before trying again.
"Number already active" error — the number is still registered with the Cloud API and the WhatsApp Business app at the same time. A number can't run on both. Remove it from the app first, then register.
Forgotten PIN — reset or disable two-step verification for the number (see Step 5), then register with a new PIN.
Permission / token errors (e.g. 401/190) — your token is missing a required scope or has expired. Regenerate a System User token with both whatsapp_business_management and whatsapp_business_messaging (Step 4).
Number stays Pending — the registration call hasn't succeeded yet. Confirm you received {"success": true}; if not, review the error message returned by the API.
Number is Connected but template messages fail — you likely don't have a valid payment method on the WhatsApp Business Account. Add one (Step 8). Registration alone doesn't enable billed, template-based sending.

FAQs

Is my number active once I've verified it? No. Verification only confirms you own the number. It stays in Pending until you complete registration (Steps 5–6), which moves it to Connected.
What's the difference between the Phone Number ID and my phone number? The Phone Number ID is a numeric identifier Meta assigns to your number for API calls. It's found under API Setup and is different from the actual phone number. Registration uses the ID, not the number.
Do I have to set a PIN? Yes. Registration requires a 6-digit two-step verification PIN. If your number doesn't have one, the value you pass during registration sets it.
My number is Connected but I still can't send template messages. Why? Registration activates the number, but sending template messages (marketing, utility, authentication) requires a valid payment method on the WhatsApp Business Account. Add one under your billing/payment settings (Step 8).
Can I undo registration? Yes. Sending POST /<PHONE_NUMBER_ID>/deregister disables Cloud API access for the number. Your message history is preserved.
Where can I read Meta's official reference? See Meta's WhatsApp business phone number registration documentation.

Next steps — connect the number to TimelinesAI

Once your number is Connected on Meta and has a valid payment method, you're ready to bring it into TimelinesAI to manage chats, sync with your CRM, and run template campaigns.

👉 Follow WhatsApp Business Accounts (WABA) integration with TimelinesAI to complete the connection.