WhatsApp API / Identity readiness guide
WhatsApp Usernames in 2026: Reservations, Privacy and API Readiness
A username can make an introduction less dependent on sharing a phone number. For a business, that also raises practical questions about contact permission and matching a conversation to the correct customer. Separate the consumer announcement, actual account availability and documented Cloud API fields before changing a CRM or campaign plan.
- Published
- Reading time
- 7 min
- Attribution
- Pending

In this guide
- Reservations are different from a completed rollout
- Addressability and customer identity solve different problems
- Check the reservation and naming rules in the genuine app
- Contact controls do not remove messaging permission
- Prepare CRM mappings without inventing an API contract
- Usernames do not establish sending capacity
- Compare privacy questions without unsupported rankings
- Plan useful business journeys with independent feature checks
- Use readiness gates instead of the old June deadline
- Protect codes, linked devices and business identity
- Frequently asked questions
Part 01
Reservations are different from a completed rollout
On 29 June 2026, Meta announced username reservations and described a later gradual country rollout with in-app notification. It said that, once launched and enabled, first contact with a person or business could avoid exposing the phone number. This is a dated announcement, not proof of current availability to every Indian account.
The original March guide forecast a June migration deadline and the end of phone-number identity. Neither follows from the announcement. A reservation, a consumer feature being usable and an API integration receiving a documented identifier are separate milestones. Preserve existing working customer mappings while checking each milestone.
Further reading
Part 02
Addressability and customer identity solve different problems
Sharing a handle can reduce how widely a person distributes a contact number, but a reachable conversation is not necessarily an authenticated customer relationship. A support desk still needs an appropriate way to identify the order or account before disclosing information. Do not ask for unnecessary sensitive identifiers to compensate for missing fields.
Keep an internal customer key and use an authorized mapping process. A username may be suitable for starting a conversation while the customer’s account record uses another identifier. Handle changes, collisions in imported data and ambiguous records need a review path; the display name or a similar handle is not sufficient evidence to merge two people.
Part 03
Check the reservation and naming rules in the genuine app
The announcement directs reservations through Settings → Account → Username in the latest app and mentions an option for creators/businesses to claim existing Instagram or Facebook handles. Exact claim eligibility and naming constraints were not verified from the help body during this check.
The old 3–30-character table, permitted punctuation and invalid examples are therefore held. Use the current validation shown by the genuine app rather than implementing an inferred naming rule in your software. Do not treat an accepted reservation as trademark clearance, a business verification or confirmation that the feature is already usable.
Prepare a preferred handle and alternatives consistent with your approved public identity. Check that the person managing the account has permission to represent the business. Avoid sharing verification codes or approving an unexpected linked device for someone who claims to reserve a name on your behalf.
Further reading
Part 04
Contact controls do not remove messaging permission
Meta’s announcement describes exact-name discovery without a browsable directory and an optional username key. It does not substantiate the earlier four-digit PIN specification. Check the available app controls and protect the key appropriately; do not present a key as an all-purpose anti-spam or account-security guarantee.
A discoverable or supplied username is not unlimited permission to market, disclose records or send repeated follow-up. Preserve the recipient’s permission and stop choices, appropriate message format and account restrictions. Treat a conversation request separately from permission for future categories of communication.
Part 05
Prepare CRM mappings without inventing an API contract
The current BSUID documentation could not be retrieved on 29 September 2026. Universal phone-number replacement, exact BSUID format/length, mandatory ExternalUserId and a 30-day visibility window remain unconfirmed here. The consumer announcement does not define webhook payloads or the identifier your business account will receive.
Identity decision map
Keep ambiguous customer matches unresolved
A handle, phone reference and internal customer record need their own source and scope.

Source
Preserve where each external identifier came from.
Scope
Confirm the documented namespace and account rollout before joining records.
Review
Keep uncertain matches separate and reversible.
Keep external identifiers as opaque strings with their documented source and scope. Store a separate internal customer ID and the evidence used to associate each external value. Do not parse a supposed prefix, trim an identifier into a phone number or copy an ID from one business scope into another. Retain the original event reference for investigation without unnecessarily retaining customer content.
Rehearse missing phone fields, unknown recipient keys and multiple possible matches using synthetic records. A missing identifier should lead to a clear pending state or authorized verification, not a fabricated phone number. Preserve old mappings until a supported join is verified and reversible.
Identity mapping worksheet — schematic, not a provider payload
Scroll sideways to see every column →
| Record | Purpose | Do not infer |
|---|---|---|
| Internal customer key | Stable reference for order/support records | A public username is this key |
| External identifier and source | Opaque value from documented integration | Format or namespace without documentation |
| Business/account scope | Where the association was established | Same value usable across every business |
| Mapping evidence | Authorized association and original event reference | Similar display names prove identity |
| Unresolved association | Review queue and safe reply path | Missing phone proves a universal rollout |
Part 06
Usernames do not establish sending capacity
Throughput in messages per second is separate from recipient messaging limits, template pacing and quality restrictions. Standard and hybrid limits must be checked for the actual account; no fixed MPS or universal upgrade is confirmed here.
A version announcement, business verification or username rollout does not establish a fixed daily recipient baseline. Confirm the current number or portfolio limit, quality and provider upgrade conditions before planning campaigns.
Keep recipient permission, template eligibility, account restrictions and delivery evidence in the campaign plan. A new addressability mechanism does not remove recipient/MPS controls or make every message free. Record the actual limit and stop rule before increasing volume.
Part 07
Compare privacy questions without unsupported rankings
The previous Telegram/Signal table, Rust implementation claims and randomized-ID guarantees were not verified from current primary support. Rather than declare a platform winner, compare the specific account, chat, backup, device and data-sharing conditions for your intended task using each product’s current documentation.
Message-content encryption, metadata, backups, endpoint security and data supplied to an external AI or CRM are separate questions. A scoped identifier alone does not certify legal compliance or prevent account takeover. Review what your own integration stores and exposes, who can access it and how users can correct or end the relationship.
Part 08
Plan useful business journeys with independent feature checks
An order enquiry can ask for a reference and use an authorized mapping before returning status. A form can collect only the information needed for an appointment. An advertising entry can open a conversation, but should not be treated as automatic permission for unrelated campaigns. These are candidate workflow designs, not proof of available Flows or advertising features for every account.
RAG assistants, ERP access and payments require separate supported connectors, permissions, source validation and human recovery. The original always-available support and two-times-conversion claims are held. A username does not make an AI answer accurate or authorize a payment. Do not switch an invoice recipient mapping merely because a different identifier appears.
Keep phone-based contact where legitimately required and permissioned, while avoiding an unnecessary demand for a number solely because an old CRM assumed one. Explain why any additional verification is needed and offer a human path for people who cannot complete it.
Part 09
Use readiness gates instead of the old June deadline
Assign an owner to the consumer/account evidence, API contract, CRM matching and operator training. Obtain the actual supported field and scope before changing production parsing. Check reports, exports, deduplication, recipient selection and recovery consumers; updating only the inbox leaves other paths at risk.
Keep synthetic tests and a reversible mapping rollout. Compare unknown-identity counts and incorrect joins during an approved pilot, without treating local tests as provider availability proof. If the contract is unavailable, keep the public explanation qualified and the production migration decision pending.
- Inventory current identity assumptions across sends, events and reports.
- Obtain the current account/region and API field contract.
- Rehearse absent, unknown and conflicting identifiers with synthetic examples.
- Confirm authorized customer association and recovery ownership.
- Enable only an approved limited workflow with a clear stop and rollback/recovery criterion.
Part 10
Protect codes, linked devices and business identity
Never share registration or verification codes with someone offering reservations, account recovery or a subscription. Approve device linking only for an action you initiated and understand. Check unexpected requests through an independent trusted channel and review authorized devices after a suspected compromise.
Use the genuine app and official support channels; do not install an APK from a message to unlock a username. A badge or familiar brand name is not sufficient identity proof. The earlier claimed Ghost Pairing incident pattern is not a verified case series here; the practical recovery question is whether a device was authorized and who controls the account.
Further reading
Questions
Frequently asked questions
Does a reservation mean usernames are live in India?
No current account-level rollout is confirmed by this guide. Check the in-app availability for the relevant account and country, separately from the dated announcement.
Must I replace phone numbers with BSUID now?
No universal API replacement or migration deadline is established here. Obtain the documented field and scope, preserve existing working mappings and rehearse missing data before approving a change.
Is the username key a four-digit PIN?
The exact earlier PIN format was not validated. Use the current genuine-app instructions for the available contact control rather than assuming a fixed format.
Can I send unlimited messages to usernames?
No. Check permission, message-format rules, account restrictions, recipient limits, throughput and billing conditions independently of a username.
How should support handle a customer without a phone field?
Keep the association pending and use an authorized verification or human support path. Do not create a dummy number, merge similar names or disclose another customer’s account.
Share this guide
If copying is unavailable, select the article link below.
Next reads
Continue reading
WhatsApp API
WhatsApp Graph API v24 to v25: An Evidence-Based Migration Checklist
Plan a Graph API version migration with changelog checks, scoped identity mapping, token expiry and revocation checks, delivery reconciliation and rollback.
Read guide →WhatsApp API
WhatsApp account model in October 2026: what changed for Cloud API teams?
Meta's WhatsApp account split separates phone numbers from templates and billing. Understand the September–October rollout, routing and checks for Cloud API teams.
Read guide →WhatsApp API
WhatsApp Direct Send utility messages: who became eligible in October 2026?
Meta widened Direct Send utility eligibility on 8 October 2026. Check the 100,000 messaging-limit threshold, account banner, supported formats and safe pilot path.
Read guide →WhatsApp API
Meta's WhatsApp Business Tools MCP: a practical Cloud API setup checklist
Meta announced agent-assisted WhatsApp Business Platform setup in September 2026. See its rollout limits and a safe way to test onboarding, templates and webhooks.
Read guide →