MEmeta
Phone Number Registration

Register WhatsApp Business Phone Number

Changed on

Register a WhatsApp Business phone number for messaging capabilities and enable two-step verification. This is a required step before sending messages through the WhatsApp Business Cloud API.

Registration Process:

  1. Phone number must be in UNVERIFIED status
  2. Provide a 6-digit PIN for two-step verification
  3. Optionally provide backup data for account migration
  4. Registration activates messaging capabilities

Migration Support: For migrating from on-premises WhatsApp Business API, include backup data with password and encrypted account information.

Rate Limiting: Registration attempts are rate-limited to prevent abuse. Standard Graph API rate limits apply with additional restrictions for registration endpoints.

Security Requirements:

  • Two-step verification is mandatory for all registered numbers
  • PIN must be securely stored and managed by the business
  • Registration enables webhook delivery and message sending capabilities
post/{Version}/{Phone-Number-ID}/register

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/register
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Phone-Number-IDstring required

The ID of the phone number to register. This ID is provided when the phone number is added to your WhatsApp Business Account and can be found in WhatsApp Manager.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body

messaging_product'whatsapp' required

Must be 'whatsapp' to indicate WhatsApp Business messaging product

pinstring required

6-digit PIN for two-step verification setup

data_localization_region'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'ZA'

Data localization region for message storage (deprecated in v21+)

meta_store_retention_minutesinteger

Message retention period in minutes (deprecated in v21+)

Example request

{
  "messaging_product": "whatsapp",
  "pin": "123456",
  "backup": {
    "password": "YOUR_BACKUP_PASSWORD",
    "data": "YOUR_BACKUP_DATA"
  },
  "data_localization_region": "AE",
  "meta_store_retention_minutes": 60
}

Response

Successfully registered WhatsApp Business phone number

successboolean required

Indicates whether the registration was successful

Example response

{
  "success": true
}

Changes