# Business Phone Numbers

# Business phone numbers | Developer Documentation

<div id="bkmrk-business-phone-numbe">## Business phone numbers

<div><span>Updated: Feb 27, 2026</span></div><div>This document describes WhatsApp business phone numbers, their requirements, management information, and unique features.</div><div id="bkmrk-registering-business"><div id="bkmrk-registering-business-1"><div>### Registering business phone numbers

</div></div></div><div>A valid business phone number must be registered before it can be used to send and receive messages via Cloud API. Registered numbers can still be used for everyday purposes, such as calling and text messages, but cannot be used with WhatsApp Messenger (“WhatsApp”).</div><div>Numbers already in use with WhatsApp cannot be registered unless they are [deleted<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F2138577903196467%2F%3Fhelpref%3Duf_share&h=AT6Fa_hjE_3NMHTqdmlSl-X1WGZpTNJOKSM5o0P0RxX5_QUsSiaKKY8nG05SwmJhcxTgFXwV-cOVCudrdId7qrBDLiFkk3v7W3iAl19q-Ln94gjQjHfQK61iw9BHs-6Xs-EqNtDoJJKt1Rl-GPdAYg) first. If your number is banned on WhatsApp and you wish to register it, it must be unbanned via the [appeal process<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F465883178708358&h=AT6Fa_hjE_3NMHTqdmlSl-X1WGZpTNJOKSM5o0P0RxX5_QUsSiaKKY8nG05SwmJhcxTgFXwV-cOVCudrdId7qrBDLiFkk3v7W3iAl19q-Ln94gjQjHfQK61iw9BHs-6Xs-EqNtDoJJKt1Rl-GPdAYg) first.</div><div>Note that when you complete the steps in our [Get Started](/books/meta-whatsapp/page/get-started-developer-documentation) document, a **test** business phone number will be generated and registered for you automatically.</div><div id="bkmrk-eligibility-requirem"><div id="bkmrk-eligibility-requirem-1"><div>#### Eligibility requirements

</div></div></div><div>Eligible phone numbers must be:</div><span>owned by you</span><span>have a country and area code (short codes are not supported)</span><span>able to receive voice calls or SMS</span><span>number should have [scaled capabilities<span>⁠</span>](https://www.facebook.com/business/help/595597942906808)</span><div>If you are registering a 1-800 number, see [1-800 and toll free numbers](#bkmrk-1-800-and-toll-free--1) for additional information.</div><div id="bkmrk-registration-methods"><div id="bkmrk-registration-methods-1"><div>#### Registration methods

</div></div></div><span>**App Dashboard**: Complete the steps in our [Get Started](/books/meta-whatsapp/page/get-started-developer-documentation) document if you haven’t already, then use the [App Dashboard](https://developers.facebook.com/apps) &gt; **WhatsApp** &gt; **API Setup** panel to add a phone number.</span><span>**Meta Business Suite**: You can register a business phone number when [using Meta Business Suite to create a WhatsApp Business Account](/books/meta-whatsapp/page/managing-whatsapp-business-accounts-developer-documentation).</span><span>**WhatsApp Manager**: See our [How to connect your phone number to your WhatsApp Business Account<span>⁠</span>](https://www.facebook.com/business/help/456220311516626) help center article.</span><span>**Embedded Signup**: If you are working with a solution partner, they will provide you with a link to Embedded Signup, which you can use to register a number.</span><div>**Note:** The methods above add a phone number to your WhatsApp Business Account and verify your ownership, but they do not register the number for Cloud API use. To complete registration, call the [register endpoint](/books/meta-whatsapp/page/register-a-business-phone-number-developer-documentation). If you are a Solution Partner or Tech Provider using Embedded Signup, see [Registering business phone numbers](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation).</div><div id="bkmrk-business-phone-numbe-2"><div id="bkmrk-business-phone-numbe-3"><div>### Business phone number types

</div></div></div><div>This table categorizes phone number types and evaluates their suitability for receiving OTPs via SMS, international phone calls, and flash calls. It provides likelihood assessments for successful delivery based on number type and carrier characteristics. Additionally, it offers actionable recommendations for users to improve delivery success without changing their phone number type.</div><div><table><thead><tr><th><span>Phone type </span></th><th><span>Description </span></th><th><span>SMS OTP </span></th><th><span>Voice OTP </span></th><th><span>Actions </span></th></tr></thead><tbody><tr><td><div><div>Mobile (recommended)</div></div></td><td><div><div>Assigned to mobile devices/SIMs</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Enable International reception of SMS/Calls, ensure device is connected to Cellular Network, Grant App permissions</div></div></td></tr><tr><td><div><div>Fixed line</div></div></td><td><div><div>Assigned to physical locations (landline)</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Enable International reception of SMS/Calls, ensure line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Freephone</div></div></td><td><div><div>Toll-Free, recipient pays</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Premium rate</div></div></td><td><div><div>Higher charges for special services</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Shared cost</div></div></td><td><div><div>Cost shared between caller and recipient</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Universal access</div></div></td><td><div><div>Reachable globally for customer service</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Personal number</div></div></td><td><div><div>Assigned to individuals, not tied to device</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>VoIP</div></div></td><td><div><div>Internet telephony, not tied to physical line</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Confirm that the VoIP provider supports international SMS/calls for OTPs; check provisioning and account settings; keep app/service running and notifications enabled; ensure device is online and permissions granted</div></div></td></tr><tr><td><div><div>Inbound only</div></div></td><td><div><div>Only accept incoming calls/messages</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Standard</div></div></td><td><div><div>Ensure with Phone provider that the number is able to receive International SMS/Calls, check that line is ready for incoming calls and disable call forwarding or IVR features</div></div></td></tr><tr><td><div><div>Pager</div></div></td><td><div><div>Assigned to pagers (rare)</div></div></td><td><div><div>Not supported</div></div></td><td><div><div>Not supported</div></div></td><td><div><div>Not supported</div></div></td></tr><tr><td><div><div>M2M/IoT</div></div></td><td><div><div>Machine-to-machine, smart devices</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Not Recommended</div></div></td><td><div><div>Ensure device and SIM are allowed for incoming International SMS/calls</div></div></td></tr></tbody></table>

</div><div id="bkmrk-status"><div id="bkmrk-status-1"><div>### Status

</div></div></div><div>Business phone numbers have a status, which reflects their quality rating and current [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation). Business phone numbers must have a status of “connected” in order to send and receive messages via the API.</div><div id="bkmrk-viewing-status-via-w"><div id="bkmrk-viewing-status-via-w-1"><div>#### Viewing status via WhatsApp Manager

</div></div></div><div>Your business phone number’s current status appears in the **Status** column in the [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/) &gt; **Account tools** &gt; **Phone numbers** panel.</div><div>See our [About your WhatsApp Business phone number’s quality rating<span>⁠</span>](https://www.facebook.com/business/help/896873687365001) help center article to learn more about quality ratings and statuses as they appear in WhatsApp Manager.</div><div id="bkmrk-getting-status-via-a"><div id="bkmrk-getting-status-via-a-1"><div>#### Getting status via API

</div></div></div><div id="bkmrk-display-names"><div id="bkmrk-display-names-1"><div>### Display names

</div></div></div><div>You must provide display name information when registering a business phone number. The display name appears in your business phone number’s WhatsApp profile, and can also appear at the top of **individual chat** threads and the **chat list** if certain conditions are met. See our [Display names](/books/meta-whatsapp/page/display-names-developer-documentation) document to learn how display names work.</div><div>![WhatsApp display name shown in chat thread](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-hnogg8em.png)</div><div id="bkmrk-business-profiles"><div id="bkmrk-business-profiles-1"><div>### Business profiles

</div></div></div><div>A business profile provides additional information about your business, such as its address, website, description, and so on. You can supply this information when registering your business phone number. See our [Business profiles](/books/meta-whatsapp/page/business-profiles-developer-documentation) document to learn how business profiles work.</div><div>![Business profile information in WhatsApp](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-vhebkbz6.png)</div><div id="bkmrk-official-business-ac"><div id="bkmrk-official-business-ac-1"><div>### Official Business Account status

</div></div></div><div>Business phone numbers can gain Official Business Account (OBA) status. OBA numbers have a blue checkmark beside their name in the contacts view.</div><div>![Official Business Account blue checkmark displayed in contacts view](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-d4yjevw6.png)</div><div>See our [Official Business Account](/books/meta-whatsapp/page/official-business-accounts-developer-documentation) document to learn how to request OBA status for a business phone number.</div><div id="bkmrk-1-800-and-toll-free-"><div id="bkmrk-1-800-and-toll-free--1"><div>### 1-800 and toll free numbers

</div></div></div><div>You may want to register a 1-800 or other toll free number on the platform. These numbers are usually behind an Interactive Voice Response (IVR) system. A WhatsApp registration call cannot navigate an IVR. Phone numbers behind an IVR system can be registered, but must be able to accept calls from international numbers and be able to redirect our SMS message or voice call to a real person.</div><div>To register a phone number that is behind an IVR system:</div><span>WhatsApp shares with you 1 or 2 phone numbers that the registration call will come from.</span><span>Create an allow list for these numbers. If you are unable to create an allow list for these numbers, add the phone number to your WABA and open a Direct Support ticket asking for the registration call phone numbers and include the phone number you are trying to register in the ticket.</span><span>Redirect the registration call to an employee or a mailbox to capture the registration code.</span><div>Phone numbers behind an IVR system that are unable to receive registration calls are not supported.</div><div id="bkmrk-registered-number-ca"><div id="bkmrk-registered-number-ca-1"><div>### Registered number cap

</div></div></div><div>New business portfolios are initially capped at 2 registered business phone numbers.</div><div>If your business becomes [verified<span>⁠</span>](https://www.facebook.com/business/help/1095661473946872), or if you have reached a [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) of 2,000, Meta will automatically increase your cap to 20. Upon increase, a Meta Business Suite notification will be sent, informing you of your new cap, and a [business\_capability\_update](/books/meta-whatsapp/page/business-capability-update-webhook-reference-developer-documentation) webhook will be triggered with `max_phone_numbers_per_business` set to your new cap.</div><div id="bkmrk-whatsapp-user-phone-"><div id="bkmrk-whatsapp-user-phone--1"><div>### WhatsApp user phone number formats

</div></div></div><div>Plus signs (`+`), hyphens (`-`), parenthesis (`(`,`)`), and spaces are supported in send message requests.</div><div>We highly recommend that you include both the plus sign and country calling code when sending a message to a customer. If the plus sign is omitted, your business phone number’s country calling code is prepended to the customer’s phone number. This can result in undelivered or misdelivered messages.</div><div>For example, if your business is in India (country calling code `91`) and you send a message to the following customer phone number in various formats:</div><div><table><thead><tr><th><span>Number In Send Message Request </span></th><th><span>Number Message Delivered To </span></th><th><span>Outcome </span></th></tr></thead><tbody><tr><td><div><div>`+16315551234`</div></div></td><td><div><div>`+16315551234`</div></div></td><td><div><div>Correct number</div></div></td></tr><tr><td><div><div>`+1 (631) 555-1234`</div></div></td><td><div><div>`+16315551234`</div></div></td><td><div><div>Correct number</div></div></td></tr><tr><td><div><div>`(631) 555-1234`</div></div></td><td><div><div>`+916315551234`</div></div></td><td><div><div>Potentially wrong number</div></div></td></tr><tr><td><div><div>`1 (631) 555-1234`</div></div></td><td><div><div>`+9116315551234`</div></div></td><td><div><div>Potentially wrong number</div></div></td></tr></tbody></table>

</div><div>Note: For Brazil and Mexico, the extra added prefix of the phone number may be modified by the Cloud API. This is a standard behavior of the system and is not considered a bug.</div><div id="bkmrk-identity-change-chec"><div id="bkmrk-identity-change-chec-1"><div>### Identity change check

</div></div></div><div>You may want Meta to verify a customer’s identity before delivering your message to them. You can have us do this by enabling the identity change check setting on your business phone number.</div><div>If a customer performs an action in WhatsApp that is considered an identity change, Meta generates a new identity hash for the user. To get this hash when messaging a customer, enable the identity change check setting on your business phone number. Once enabled, anytime the customer messages you, or you message the customer without an identity hash, [any incoming messages webhooks](/books/meta-whatsapp/page/messages-webhook-reference-developer-documentation) or [status messages webhooks](/books/meta-whatsapp/page/status-messages-webhook-reference-developer-documentation) will include their hash. You can then capture and store this hash for future use.</div><div>To use the hash, include it in a send message request. Meta compares the hash in the request to the customer’s current hash. If the hashes match, the message will be delivered. If there is a mismatch, it means the customer has changed their identity since you last messaged them and the message will not be delivered. Instead, you will receive a status messages webhook with error code `137000`, notifying you of the failure and mismatch.</div><div>When you receive a mismatched hash webhook, assume the customer’s phone number can no longer be trusted. To reestablish trust, verify the customer’s identity again using other, non-WhatsApp channels. Once you have reestablished trust, resend the failed message to the new identity (if any), without a hash. Then store the customer’s new hash included in the message status delivery webhook.</div><div id="bkmrk-post-body"><div id="bkmrk-post-body-1"><div>#### Post body

</div></div></div><div>Set `<ENABLE_IDENTITY_KEY_CHECK>` to `true` to enable identity check, or `false` to disable it.</div><div id="bkmrk-get-throughput-level"><div id="bkmrk-get-throughput-level-1"><div>### Get throughput level

</div></div></div><div>Use the [WhatsApp Business Phone Number](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) endpoint to get a phone number’s current [throughput level](/books/meta-whatsapp/page/throughput-developer-documentation):</div><div id="bkmrk-get-a-single-phone-n"><div id="bkmrk-get-a-single-phone-n-1"><div>### Get a single phone number

</div></div></div><div>To get information about a phone number, send a GET request to the [WhatsApp Business Phone Number](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api) endpoint:</div><div id="bkmrk-get-display-name-sta"><div id="bkmrk-get-display-name-sta-1"><div>### Get display name status (beta)

</div></div></div><div>Include `fields=name_status` as a query string parameter to get the status of a display name associated with a specific phone number. This field is currently in beta and not available to all developers.</div><div id="bkmrk-deleting-business-ph"><div id="bkmrk-deleting-business-ph-1"><div>### Deleting business phone numbers

</div></div></div><div>Only business portfolio admins can delete business phone numbers, and numbers can’t be deleted if they have been used to send paid messages within the last 30 days.</div><div id="bkmrk-deleting-business-ph-3"><div id="bkmrk-deleting-business-ph-4"><div>#### Deleting business phone numbers via WhatsApp Manager

</div></div></div><div>If your business phone number has a Connected status, you will need your two-step verification PIN to delete your number.</div><span>Load your business portfolio in the [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/wa/manage/home/).</span><span>If it doesn’t automatically load the Phone numbers panel, navigate to **Account tools** (the toolbox icon) &gt; **Phone numbers**.</span><span>Click the phone number’s trash can icon and complete the flow.</span><div>If the number has been used to send paid messages within the last 30 days, you will be redirected to the **Insights** panel, showing the date of the last paid message. You can delete the number 30 days from this date.</div><div id="bkmrk-deleting-business-ph-6"><div id="bkmrk-deleting-business-ph-7"><div>#### Deleting business phone numbers via API

</div></div></div><div>You cannot delete a business phone number via API.</div><div id="bkmrk-migrating-business-p"><div id="bkmrk-migrating-business-p-1"><div>### Migrating business phone numbers

</div></div></div><div>You can [migrate phone numbers from one WABA to another](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup).</div><div id="bkmrk-conversational-compo"><div id="bkmrk-conversational-compo-1"><div>### Conversational components

</div></div></div><div>You can enable helpful message UI components to make it easier for WhatsApp users to interact with your business. See [Conversational components](/books/meta-whatsapp/page/conversational-components-developer-documentation).</div></div>

# Register a Business Phone Number | Developer Documentation

<div id="bkmrk-register-a-business-">## Register a Business Phone Number

<div><span>Updated: Mar 31, 2026</span></div><div>To use your business phone number with Cloud API you must register it. Registration can only be done via API - you cannot register a number through [WhatsApp Manager<span>?</span>](https://business.facebook.com) (WAM) or the App Dashboard.</div><div>To get your number ready for Cloud API, complete the following steps:</div><span>**Add** your business phone number to your WhatsApp Business account using [WhatsApp Manager](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation).</span><span>**Verify** ownership of the number using [WhatsApp Manager](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation).</span><span>**Register** your business phone number by making an API call to the [registration endpoint](#bkmrk-register-a-business--3) below.</span><div>Register your business phone number in the following scenarios:</div><span>**Account creation** - When you implement this API, register the business phone number you want to use. Meta enforces two-step verification during account creation to add an extra layer of security to your accounts.</span><span>**Name change** - If your phone is already registered and you want to change its display name, you can update it via [WhatsApp Manager<span>?</span>](https://www.facebook.com/business/help/378834799515077) or [via API](/books/meta-whatsapp/page/display-names-developer-documentation). Once the name change is approved (confirmed via the [phone\_number\_name\_update](/books/meta-whatsapp/page/phone-number-name-update-webhook-reference-developer-documentation) webhook), re-register your phone number using the endpoint below. Wait for approval before re-registering, as re-registering before approval has no effect. See [Display names](/books/meta-whatsapp/page/display-names-developer-documentation) for the complete workflow.</span><div id="bkmrk-migration-exception"><div id="bkmrk-migration-exception-1"><div>#### Migration exception

</div></div></div><div>If you are migrating a phone number from the On-Premises API to the Cloud API, there are extra steps you need to perform before registering a phone number with the Cloud API. See [Migrate From On-Premises API to Cloud API](/documentation/business-messaging/whatsapp/support/migrating-from-onprem-to-cloud) for the full process.</div><div id="bkmrk-register-a-business--2"><div id="bkmrk-register-a-business--3"><div>### Register a business phone number

</div></div></div><div>To register your verified business phone number, make a `POST` call to `PHONE_NUMBER_ID/register`. Include the parameters listed below.</div><div><table><thead><tr><th><span>Endpoint </span></th><th><span>Authentication </span></th></tr></thead><tbody><tr><td><div><div>`PHONE_NUMBER_ID/register`</div><div><div>(See [Get Phone Number ID](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation))</div></div></div></td><td><div><div><div>Solution Partners must authenticate themselves with an access token with the `whatsapp_business_management` and `whatsapp_business_messaging` permissions.</div></div></div></td></tr></tbody></table>

</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>#### Limitations

</div></div></div><div>Requests to the registration endpoint are limited to 10 requests per business number in a 72-hour moving window.</div><div>When you make a registration request, the API checks how many registration requests you have made to register that number in the last 72 hours. If you have already made 10 requests, the API will return error code `133016`, and the number will be prevented from being registered for the next 72 hours.</div><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>#### Parameters

</div></div></div><div><table><thead><tr><th><span>Name </span></th><th><span>Description </span></th></tr></thead><tbody><tr><td><div><div>`messaging_product`</div></div></td><td><div><div>**Required.**</div><div>Messaging service used. Set this to `"whatsapp"`.</div></div></td></tr><tr><td><div><div>`pin`</div></div></td><td><div><div>**Required.**</div><div>If your verified business phone number already has two-step verification enabled, set this value to your number's 6-digit two-step verification PIN. If you cannot recall your PIN, you can change it. See [Two-step verification](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation).</div><div>If your verified business phone number does not have two-step verification enabled, set this value to a 6-digit number. This will be the newly verified business phone number's two-step verification PIN.</div></div></td></tr><tr><td><div><div>`data_localization_region`</div></div></td><td><div><div>**Optional.**</div><div>  
If included, enables [local storage](/books/meta-whatsapp/page/local-storage-developer-documentation) on the business phone number. Value must be a 2-letter ISO 3166 country code (for example, `IN`) indicating the country where you want data-at-rest to be stored.</div><div>  
Supported values:</div><div>  
**APAC**</div><span>Australia: `AU`</span><span>Indonesia: `ID`</span><span>India: `IN`</span><span>Japan: `JP`</span><span>Singapore: `SG`</span><span>South Korea: `KR`</span><div>**Europe**</div><span>EU (Germany): `DE`</span><span>Switzerland: `CH`</span><span>United Kingdom: `GB`</span><div>**LATAM**</div><span>Brazil: `BR`</span><div>**MEA**</div><span>Bahrain: `BH`</span><span>South Africa: `ZA`</span><span>United Arab Emirates: `AE`</span><div>**NORAM**</div><span>Canada: `CA`</span><div>Once you enable local storage, you cannot disable or change it directly. Instead, you must [deregister](#bkmrk-deregister-a-busines-1) the number and register it again without this parameter (to disable), or include the parameter with the new country code (to change).</div><div>  
If the number is already registered, deregister it, then register it again with this parameter to enable local storage.</div></div></td></tr></tbody></table>

</div><div id="bkmrk-deregister-a-busines"><div id="bkmrk-deregister-a-busines-1"><div>### Deregister a business phone number

</div></div></div><div><div>Deregistering a business phone number makes it unusable with Cloud API and disables [local storage](/books/meta-whatsapp/page/local-storage-developer-documentation) on the number, if it had been enabled. To use the number again, you must re-register it.</div></div><div>To deregister a business phone number, make a `POST` call to `PHONE_NUMBER_ID/deregister`:</div><div><table><thead><tr><th><span>Endpoint </span></th><th><span>Authentication </span></th></tr></thead><tbody><tr><td><div><div>`PHONE_NUMBER_ID/deregister`</div><div><div>(See [Get Phone Number ID](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation))</div></div></div></td><td><div><div><div>Solution Partners must authenticate themselves with an access token with the `whatsapp_business_management` and `whatsapp_business_messaging` permissions.</div></div></div></td></tr></tbody></table>

</div><div id="bkmrk-limitations-3"><div id="bkmrk-limitations-4"><div>#### Limitations

</div></div></div><span>This endpoint cannot be used to deregister a business phone number that is in use with [both Cloud API and the WhatsApp Business app](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation).</span><span>Deregistration does not delete a number or its message history. To delete a number and its history, see [Delete Phone Number from a WABA](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation).</span><span>Requests to the deregistration endpoint are limited to 10 requests per business number in a 72-hour moving window. If you exceed this amount, the API will return error code `133016`, and the business phone number will be prevented from being deregistered for the next 72 hours.</span><div id="bkmrk-see-also"><div id="bkmrk-see-also-1"><div>### See also

</div></div></div><span>[Resetting your PIN](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation)</span><span>[Cloud API Local Storage](/books/meta-whatsapp/page/local-storage-developer-documentation)</span></div>

# Two-Step Verification | Developer Documentation

<div id="bkmrk-two-step-verificatio">## Two-Step Verification

<div><span>Updated: Nov 5, 2025</span></div><div>Set up two-step verification for your phone number to add an extra layer of security to your business accounts. To set it up, make a `POST` call to `/PHONE_NUMBER_ID` and attach the parameters below. There is no endpoint to disable two-step verification.</div><div><table><thead><tr><th><span>Endpoint </span></th><th><span>Authentication </span></th></tr></thead><tbody><tr><td><div><div>`/PHONE_NUMBER_ID`</div><div><div>(See [Get Phone Number ID](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation))</div></div></div></td><td><div><div><div>Solution Partners must authenticate themselves with an access token with the `whatsapp_business_management` and `whatsapp_business_messaging` permissions.</div></div></div></td></tr></tbody></table>

</div><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>#### Parameters

</div></div></div><div><table><thead><tr><th><span>Name </span></th><th><span>Description </span></th></tr></thead><tbody><tr><td><div><div>`pin`</div></div></td><td><div><div>**Required.**</div><div>A 6-digit PIN you wish to use for two-step verification.</div></div></td></tr></tbody></table>

</div><div id="bkmrk-reset-your-pin"><div id="bkmrk-reset-your-pin-1"><div>### Reset your PIN

</div></div></div><div>If you forget or misplace your PIN, you can update it by following these steps in WhatsApp Manager:</div>
<span>Go to [settings<span>?</span>](https://business.facebook.com/settings/) and log into your Facebook Business. Click the business you use to manage your WABA (WhatsApp Business Account).</span><span>In the settings screen, click **WhatsApp Accounts**. Find the WABA you want to update. Click the WABA. A panel with its info displays.</span><span>In the WABA info panel, click **Settings**.</span><span>In the new tab, click **WhatsApp Manager**.</span><span>In WhatsApp Manager, find your phone number and click **Settings**.</span><span>Click **Two-step verification**.</span><span>In the Two-step verification tab, click **Change PIN**.</span><span>Enter a new PIN and confirm it to complete the update.</span></div>

# Conversational Components | Developer Documentation

<div id="bkmrk-conversational-compo">## Conversational Components

<div><span>Updated: Mar 27, 2026</span></div><div>Conversational components are in-chat features that you can enable on business phone numbers. They make it easier for WhatsApp users to interact with your business. You can configure easy-to-use commands and provide pre-written ice breakers that users can tap.</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div><div>If a WhatsApp user taps a [universal link<span>?</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F425247423114725&h=AT6ZSnuSw3rONH-XCLfwSZuoVGjJ7btPa3ONzIIfn7vNKq59fhoW7liPEe_1WijkvxzhTRqdVqITeZkYi-HBy50v30M76CLbxGAsfpmgMyQhcNPr9Aa9mUp92geYdgKagd_FiaN7x2uN9mvbo_CCwg) (that is, **wa.me** link) configured with pre-filled text, the user interfaces for **ice breakers** are automatically dismissed.</div><div id="bkmrk-configure-using-what"><div id="bkmrk-configure-using-what-1"><div>### Configure using WhatsApp Manager (WAM)

</div></div></div><div>You can configure all of these features in WhatsApp Manager on the specific numbers you choose:</div>
<span>Navigate to the [My Apps dashboard in the Meta for Developers site.](https://developers.facebook.com/apps/)</span><span>Select your app, then on the left panel select **Configuration** under **WhatsApp**.</span><span>Under **Phone Numbers** select **Manage Phone Numbers**.</span><span>On the far right of the phone number you want to configure, select the **Gear Icon** under **Settings**.</span><span>Select **Automations**.</span><span>Access and configure Conversational Components.</span><div>Solution Partners can configure these features for their customers as well if they have access to their customer's WhatsApp Business Account in WhatsApp Manager.</div><div id="bkmrk-testing"><div id="bkmrk-testing-1"><div>### Testing

</div></div></div><div>To test conversational components once they have been configured, open the WhatsApp client and open a chat with your business phone number.</div><div>For ice breakers, if you already have a chat thread going with the business phone number, you must first delete the chat thread:</div>
<span>Open the thread in the WhatsApp client.</span><span>Tap the business phone number's profile.</span><span>Tap **Clear Chat** &gt; **Clear All Messages**.</span><span>**Delete Chat**.</span><span>Start a new chat thread with this business.</span><div>You can then send a message to the business phone number to test your ice breakers.</div></div>

# Media | Developer Documentation

<div id="bkmrk-mediaupdated%3A-dec-11">## Media

<div><span>Updated: Dec 11, 2025</span></div><div>You use 4 different endpoints to manage your media:</div><div>See [Supported Media Types](#bkmrk-supported-media-type-1) for supported types and size limits.</div><div id="bkmrk-get-media-id"><div id="bkmrk-get-media-id-1"><div>### Get media ID

</div></div></div><div>Some of the API requests described in this document require a media ID. Media IDs are returned by the API when [uploading media](#bkmrk-upload-media-1), and are included in incoming media messages webhooks ([image messages](/books/meta-whatsapp/page/image-messages-developer-documentation), [video messages](/books/meta-whatsapp/page/video-messages-developer-documentation), etc.)</div><div>Media IDs returned by the API expire after 30 days. Media IDs in webhooks expire after 7 days.</div><div id="bkmrk-delete-media"><div id="bkmrk-delete-media-1"><div>### Delete media

</div></div></div><div id="bkmrk-download-media"><div id="bkmrk-download-media-1"><div>### Download media

</div></div></div><div>To download media, make a `GET` request on the media URL and include your access token. **If you omit your token, the request will fail.**</div><div>Note that when retrieving a media from a media ID received via webhook, the media ID will only be available to download for 7 days.</div><div id="bkmrk-supported-media-type"><div id="bkmrk-supported-media-type-1"><div>### Supported media types

</div></div></div><div id="bkmrk-audio"><div id="bkmrk-audio-1"><div>#### Audio

</div></div></div><div><table><thead><tr><th><span>Audio Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>AAC</div></div></td><td><div><div>.aac</div></div></td><td><div><div>audio/aac</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>AMR</div></div></td><td><div><div>.amr</div></div></td><td><div><div>audio/amr</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP3</div></div></td><td><div><div>.mp3</div></div></td><td><div><div>audio/mpeg</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP4 Audio</div></div></td><td><div><div>.m4a</div></div></td><td><div><div>audio/mp4</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>OGG Audio</div></div></td><td><div><div>.ogg</div></div></td><td><div><div>audio/ogg (OPUS codecs only; base audio/ogg not supported; mono input only)</div></div></td><td><div><div>16 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-document"><div id="bkmrk-document-1"><div>#### Document

</div></div></div><div><table><thead><tr><th><span>Document Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>Text</div></div></td><td><div><div>.txt</div></div></td><td><div><div>text/plain</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xls</div></div></td><td><div><div>application/vnd.ms-excel</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xlsx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.doc</div></div></td><td><div><div>application/msword</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.docx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.wordprocessingml.document</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.ppt</div></div></td><td><div><div>application/vnd.ms-powerpoint</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.pptx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.presentationml.presentation</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>PDF</div></div></td><td><div><div>.pdf</div></div></td><td><div><div>application/pdf</div></div></td><td><div><div>100 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-image"><div id="bkmrk-image-1"><div>#### Image

</div></div></div><div>Images must be 8-bit, RGB or RGBA.</div><div><table><thead><tr><th><span>Image Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>JPEG</div></div></td><td><div><div>.jpeg</div></div></td><td><div><div>image/jpeg</div></div></td><td><div><div>5 MB</div></div></td></tr><tr><td><div><div>PNG</div></div></td><td><div><div>.png</div></div></td><td><div><div>image/png</div></div></td><td><div><div>5 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-sticker"><div id="bkmrk-sticker-1"><div>#### Sticker

</div></div></div><div>WebP images can only be sent in [sticker messages](/documentation/business-messaging/whatsapp/messages/sticker-messages).</div><div><table><thead><tr><th><span>Sticker Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>Animated sticker</div></div></td><td><div><div>.webp</div></div></td><td><div><div>image/webp</div></div></td><td><div><div>500 KB</div></div></td></tr><tr><td><div><div>Static sticker</div></div></td><td><div><div>.webp</div></div></td><td><div><div>image/webp</div></div></td><td><div><div>100 KB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-video"><div id="bkmrk-video-1"><div>#### Video

</div></div></div><div>Only H.264 video codec and AAC audio codec supported. Single audio stream or no audio stream only.</div><div>Note that videos encoded with the H.264 “High” profile and B-frames are not supported by Android WhatsApp clients. We recommend that you use H.264 “Main” profile without B-frames, or the H.264 “Baseline” profile when encoding (or re-encoding with a tool like ffmpeg), and place moov boxes before mdat boxes, for broader compatibility. If you are using ffmpeg, you can use the -movflags faststart flag to place moov boxes before mdata boxes.</div><div><table><thead><tr><th><span>Video Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>3GPP</div></div></td><td><div><div>.3gp</div></div></td><td><div><div>video/3gpp</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP4 Video</div></div></td><td><div><div>.mp4</div></div></td><td><div><div>video/mp4</div></div></td><td><div><div>16 MB</div></div></td></tr></tbody></table>

</div><div>Note that mismatched MIME type (`131053`) is a common error. Inspect your media files to verify their MIME type. Make sure that your file name extensions reflect their types. For example, if you are using UNIX, you can inspect a file via the command line to determine its MIME type:</div><div>`file -I your-image-asset.png`</div><div id="bkmrk-media-message-downlo"><div id="bkmrk-media-message-downlo-1"><div>### Media message download constraints

</div></div></div><div>The maximum supported file size for media messages on Cloud API is 100MB. In the event the customer sends a file that is greater than 100MB, you will receive a webhook with error code [131052](/documentation/business-messaging/whatsapp/support/error-codes#other-errors) and `title`:</div><div>*“Media file size too big. Max file size we currently support: 100MB. Please communicate with your customer to send a media file that is smaller than 100MB”*.</div><div>Send customers a warning message that their media file exceeds the maximum file size when this webhook event is triggered.</div><div id="bkmrk-learn-more"><div id="bkmrk-learn-more-1"><div>### Learn more

</div></div></div><div>WhatsApp Business Blog – [Sending WhatsApp media messages from an app<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fmedia-messages-via-app&h=AT56g_m791Hz2vyNNxrkcc3oGe9djDJ55IquMcadv5v_8g862_4P3sB_VC52BnOQahwV3sbhmBSXmha494eux1vBjaR8-pM7XdPamcQtB_Qgsx5KHVpQGBMSFf8_-fFzeVUm0Q56pkIhHFrJyzL0Fg)</div></div>