Industries
Restaurants & Food
Take restaurant orders, table bookings and payments in one WhatsApp chat. Auto-reply to common questions and cut support costs with ChatMitra.
Real Estate
Use WhatsApp automation to capture property leads, qualify them automatically, and follow up fast. See how real estate agents close more with ChatMitra.
Travel & Tourism
Use the WhatsApp Business API to capture travel leads, send itineraries, confirm bookings, and keep travellers updated. See how agencies grow with ChatMitra.
Banking & Finance
Run secure KYC, send account alerts and payment notifications on WhatsApp. Cut support load and stay within Meta's rules with ChatMitra.
Beauty & Cosmetics
Sell your catalog, recover carts and win repeat orders on WhatsApp. Auto-reply to product questions and send launches to opted-in customers with ChatMitra.
Education
Answer admission enquiries, fee and timetable questions, and keep parents updated — all on WhatsApp. Cut admin load and costs with ChatMitra.
EduTech
Capture course leads, qualify them and onboard learners on WhatsApp. Automate replies and cut lead-qualification cost with ChatMitra's no-code chatbot.
Events & Webinars
Handle event registrations, reminders and RSVPs in one WhatsApp chat. Cut no-shows, automate FAQs and keep attendees updated with ChatMitra.
Freelancers & Consultants
Capture leads, send proposals and chase invoices in one chat. WhatsApp automation for freelancers and consultants with ChatMitra — from ₹0.20 a chat.
Health & Wellness
Book appointments, send reminders and answer client questions in one WhatsApp chat. Auto-reply to routine queries and cut support costs with ChatMitra.
Home Decor
Share your home decor catalog, take orders and send delivery updates on WhatsApp. Automate FAQs and cut support costs with ChatMitra.
IT Services
Use the WhatsApp Business API to qualify leads, run support over chat, and wire WhatsApp into your stack with webhooks. How IT companies scale with ChatMitra.
Marketing Agencies
Use WhatsApp automation to capture leads, run campaigns and manage multiple client brands from one account. How agencies scale on WhatsApp with ChatMitra.
Offline & Retail
Turn shop footfall into a WhatsApp list. Share catalogs, add a QR-to-chat at the counter and bring buyers back — with ChatMitra from ₹0.20 per chat.
Spas & Salons
Use the WhatsApp Business API to take spa and salon bookings, cut no-shows with automated reminders, and rebook regulars. How salons grow with ChatMitra.
Automotive
Use the WhatsApp Business API for automotive dealerships to qualify buyers, book test drives and send service reminders — automated, on one chat, with ChatMitra.
All Industries
Browse every industry guide
Setup & API Guides

WhatsApp Username for Business: Rules, Reservation and API Changes

WhatsApp usernames for businesses: the naming rules, how to reserve one in WhatsApp Manager, the India status, and what BSUIDs change for API teams.

Nikunj Gohil
Written byNikunj Gohil
Read time 16 min
Posted on
Summarise this post with:

Short on time? Read this first

  • A WhatsApp username is an optional, unique @handle tied to one phone number. People must type it exactly to reach you, because WhatsApp has no username directory.
  • Businesses reserve a username per number in WhatsApp Manager → Phone numbers → Username. It's 3–35 characters: English letters, digits, periods and underscores, with at least one letter.
  • A business keeps showing its phone number. A customer with a username can message you without revealing theirs, and the API then identifies them by a BSUID (business-scoped user ID).
  • In India, the government asked Meta on 1 July 2026 not to launch usernames until consultations end. As of 14 October 2026 we found no public announcement that they are live there.
On this page 0

    A WhatsApp username is an optional, unique handle, like @yourbrand, that lets people start a chat without knowing your phone number. Businesses can reserve one for each number in WhatsApp Manager, or in the WhatsApp Business app. A username is 3 to 35 characters: English letters, digits, periods and underscores, with at least one letter. Usernames are rolling out country by country. In India, the government has asked Meta to hold the launch.

    For a business, the username is the easy part. The bigger change is on the customer side. A customer who adopts a username can message you without sharing their number. When that happens, the WhatsApp Business API identifies them with a new ID called a BSUID. This guide covers both halves: claiming the right name, and getting your contact lists, CRM and automations ready for customers who arrive without a number.

    Using ChatMitra? Your number sits in your own WhatsApp Business Account, so you reserve the username yourself in WhatsApp Manager, and nothing in ChatMitra needs to change for that. Jump to what this means for ChatMitra users for what works today and what to plan for.

    A restaurant place card on a set table reads Reserved @yourbrand, with a small teal chat bubble beside it

    What is a WhatsApp username?

    A username is a second way to reach a WhatsApp account. It sits on top of the phone number and doesn’t replace it. Meta’s help centre describes four properties that matter for a business:

    • It’s unique. No two accounts, personal or business, can hold the same username. Your display name (the name on your profile) doesn’t have to be unique; your username does.
    • It’s optional. You can create, change or delete it at any time. A phone number is still required to register a WhatsApp account.
    • It’s exact-match only. There’s no directory to browse and no suggestions. A customer has to type your exact username, or open a link or QR code you’ve shared, to start a chat.
    • It can have a key. A username key is an optional code. If you turn it on, a new contact needs both your username and your key to message you for the first time. Customers who already have your phone number don’t need the key.

    On WhatsApp, a username always shows with an @ in front, so people can tell it apart from a display name or a phone number.

    Business usernames vs personal usernames

    The feature works differently for the two sides of a conversation, and this table is the one to remember.

    Business usernamePersonal (customer) username
    Main purposeDiscovery: an easy handle to put on packaging, ads and your websitePrivacy: chat without handing out a phone number
    Phone numberStays visible on your business profileHidden from anyone who doesn’t already have it saved
    Who sees the usernameCustomers who haven’t saved your number see it in place of the numberAnyone the person chats with who hasn’t saved their number
    CountryNot applicableWhatsApp may show the other side the country code of the person’s number

    So a business username doesn’t make your business more private. It makes you easier to find. The privacy shift happens on the customer’s side, and it affects what data reaches you through the API.

    WhatsApp username rules

    These are the format rules from Meta’s developer documentation and help centre for business usernames. Check your preferred name against every row before you try to reserve it.

    RuleWhat’s allowedExample
    Length3 to 35 charactersabc passes, ab fails
    CharactersEnglish letters (a–z), digits (0–9), periods and underscoresurban_threads passes; ürban fails (accented letters aren’t supported)
    LettersAt least one English letterstore247 passes, 247247 fails
    PeriodsCan’t start or end with a period, or have two in a rowurban.threads passes, urban..threads fails
    Web-style namesCan’t start with wwwurbanthreads rather than www.urbanthreads
    Upper and lower caseIgnored when comparing usernamesMyShop and myshop are the same name
    Periods vs underscoresNot interchangeablemy.shop and my_shop are two different names
    One per numberA username belongs to exactly one phone numberSales and support numbers need two usernames

    Some names can’t be claimed by just anyone. WhatsApp’s own usernames FAQ says it holds existing Instagram and Facebook usernames for their owners, protects well-known public figures, celebrities and government entities, and blocks words such as “bank”, “government”, “police” and “verified”. A bank can’t simply register a handle containing “bank” and expect it to pass. Expect to verify ownership through Meta, or choose a name without the restricted word.

    Is the WhatsApp username feature live?

    It’s live in some countries and rolling out to others, so “yes” depends on where you are. Here’s the timeline from Meta’s own pages:

    WhenWhat happenedSource
    Early April 2026BSUIDs began appearing in messages webhooks on the WhatsApp Business PlatformMeta developer docs
    29 June 2026WhatsApp announced usernames. People and businesses could start reserving namesWhatsApp blog, Meta developer docs
    July 2026The API began supporting messages sent to a BSUID instead of a phone numberMeta developer docs
    Now”Rolling out gradually over the next few months.” WhatsApp sends an in-app notification when a reserved name becomes activeWhatsApp Help Center

    A reserved username isn’t visible or searchable yet. Customers can’t reach you through it, and a QR code for it won’t open a chat, until WhatsApp makes it active in your region. So don’t print a username on packaging until WhatsApp has told you it’s active.

    WhatsApp username status in India

    On 1 July 2026, India’s Ministry of Electronics and Information Technology (MeitY) sent Meta a notice. It told Meta not to launch usernames in India until consultations conclude to the government’s satisfaction. MeitY’s stated concern was that phone-number-free contact could make fraud, phishing, “digital arrest” scams and impersonation easier. Meta met ministry officials and filed its reply in early July, and MeitY said it was examining that reply.

    As of 14 October 2026, we found no public announcement that usernames have gone live in India. For an Indian business, that means three things:

    1. Reserving a name early still costs you nothing. If the WhatsApp Manager or app option appears for your number, the name is held for you.
    2. Don’t build a launch campaign around “message us at @yourbrand” until WhatsApp activates usernames for Indian users.
    3. BSUIDs are already in your webhooks. They appear for every user, username or not, so API teams can prepare now, whatever the launch date.

    If you serve customers outside India, from the Gulf, the UK or South-East Asia, some of them may get usernames before your Indian customers do. Your systems will meet phone-less customers first through those conversations.

    How to reserve a WhatsApp username for your business

    The steps depend on whether your number runs on the WhatsApp Business app or on the WhatsApp Business Platform (the API).

    On the WhatsApp Business Platform (API numbers)

    You need admin access to the Meta business portfolio that owns the WhatsApp Business Account (WABA).

    1. Sign in to Meta Business Suite and open WhatsApp Manager.
    2. Go to Phone numbers and select the number you want a username for.
    3. Find the Username section and click Create (or Edit if one is already set).
    4. Type your preferred username, or pick one Meta has reserved or suggested for your business.
    5. Save. The status shows as reserved until usernames are active for your number.

    Meta Business Suite also has a second route: Settings → Accounts → WhatsApp accounts, select the WABA, then the Phone numbers tab. For developers, Meta’s API has an endpoint on the phone number (POST /{phone_number_id}/whatsapp_business_account/username) to set or change the username. Pending requests can’t be cancelled, so double-check the spelling before you submit.

    If you aren’t sure where these screens are, our WhatsApp Manager guide walks through the layout, and Meta business portfolio basics explains who owns what.

    On the WhatsApp Business app

    1. Update WhatsApp Business to the latest version and restart it.
    2. Open your profile settings and look for Username. Meta’s troubleshooting page says the option “appears in your profile when available”.
    3. Enter your username and confirm.

    Creating, reserving or deleting a business username isn’t available on WhatsApp Web. Use the phone app.

    Claiming your Instagram or Facebook handle

    If the handle you want is already your Instagram or Facebook username, WhatsApp holds it for you, but only for a limited time. The two routes:

    • App: go to Tools → Facebook and Instagram in WhatsApp Business and link your Facebook Page or Instagram business profile. WhatsApp’s help pages also describe adding WhatsApp to the same Accounts Center (being renamed Meta Account) as those profiles.
    • API numbers: link the Facebook Page or Instagram account to the business phone number first, then claim the reserved name in WhatsApp Manager.

    Meta doesn’t publish how long it holds these names. If your brand handle matters, claim it now rather than waiting for the launch in your country.

    Choosing a username: a naming plan for one number or many

    A username is short marketing copy that people have to type exactly. Before you reserve, settle three things.

    1. Match your other handles. If customers know you as @urbanthreads on Instagram, use the same name on WhatsApp. One handle everywhere is easier to remember.

    2. Plan for every number. One username covers one number. If you run separate numbers for sales, support and a second city, decide the pattern now:

    Number’s jobPatternExample
    Main or sales numberBrand name aloneurbanthreads
    SupportBrand + functionurbanthreads.support
    A second region or storeBrand + placeurbanthreads.pune
    A separate brand in the same portfolioIts own brand namethreadsbyurban

    Pick periods or underscores and use the same one everywhere. Because my.shop and my_shop are different usernames, mixing them invites typos and lets someone else register the variant you didn’t use.

    3. Make it easy to type.

    • Avoid letter-and-digit look-alikes (l and 1, o and 0).
    • Avoid long hyphen-free strings like thebestorganicspicesstore.
    • Avoid words your customers might spell two ways.

    Say it out loud once. If you have to spell it for the person listening, simplify it.

    Also reserve the obvious variant if you can. If urbanthreads is yours, someone else holding urban.threads could confuse customers. WhatsApp’s protections cover public figures and verified brands, not every small business, so a defensive reservation is cheap insurance.

    Why your username request fails

    WhatsApp’s troubleshooting page lists the common errors. Here’s what each one means and what to do.

    Message or symptomLikely reasonWhat to do
    No Username optionYour app is out of date, or usernames haven’t reached your regionUpdate and restart the app. If it’s still missing, the feature isn’t available to your number yet
    ”This username is not available”It’s held for the owner of an Instagram or Facebook account, or an earlier attempt was interruptedIf you own that profile, link it (see above). If a network drop interrupted you, wait a few minutes and retry
    ”Username is taken”Someone reserved it firstUse a clear variant from your naming plan, or tap Suggest a username
    ”Try again later”Too many attempts in a short timeWait a few minutes before trying again
    Customers can’t find youThe name is reserved but not yet active, or they mistyped itWait for WhatsApp’s “active” notification, and share a link or QR code instead of asking people to type the name
    Old QR code stopped workingYou changed your usernameShare the new QR code. It updates to the new username automatically

    One warning from WhatsApp’s own help pages: if you change or delete a username, the old one “may become available for others to claim”, and deleting a username is permanent. Some providers’ guides mention a 60-day hold on old names. Meta’s help pages promise no such window, so treat any rename as a chance to lose the old name.

    What usernames change for customers who message you

    This is where usernames start to matter for API teams. When a customer adopts a username:

    • They can message you without revealing their number. WhatsApp’s help centre says that if a person has a username the first time they chat with a business, “the business won’t see your phone number unless you choose to share it.”
    • You still learn their country. WhatsApp shares the country based on the customer’s country code, and the BSUID itself starts with that country code (for example IN.).
    • Existing relationships keep the number. If you already have their number from an earlier conversation, you continue to see it.

    Meta’s developer documentation on BSUIDs is precise about when the API still includes a customer’s phone number in a webhook. It does if any of these is true:

    1. You messaged or called that user’s number within the last 30 days.
    2. You received a message or call from that number within the last 30 days.
    3. The user is in your business’s contact book.

    The 30-day lookback is checked per business phone number. The contact book is a Meta-hosted store of WhatsApp users your business has talked to. It fills up automatically, with no integration work. You can turn it off in Meta Business Suite, under Business settings → Business info, but Meta warns that turning it off deletes what it has stored. For most businesses, that’s a reason to leave it on.

    If you need a number for a delivery or a payment, ask for it. Meta has added a Request contact info button for utility and marketing templates and for interactive messages. When the customer taps it, their number is shared in the chat and a contacts webhook delivers it to you. In the app, WhatsApp suggests setting up a quick reply that asks the customer to share their contact card.

    A customer contact card with a stencil-cut window where the phone number would be, showing a teal ID beginning IN. through the gap, with labels Username, BSUID and Phone number withheld
    For a first-time customer who uses a username, the phone number field can be empty. The BSUID is always there.

    Username vs phone number vs BSUID

    There are now three identifiers for the same customer. Each has a different job.

    UsernamePhone numberBSUID
    What it isA public handle the person choosesThe number registered on WhatsAppAn ID Meta generates for each user and business portfolio pair
    Example@riya.k+91 98XXX XXXXXIN.13491208655302741918
    Always in your webhooks?No, only if the person has oneNo, only under the 30-day or contact-book rulesYes, as user_id, for every user
    Can it change?Yes, whenever the person changes itYes, if the person changes numbersOnly when the person changes their phone number
    Can you message it?NoYesYes, from any number in the same portfolio
    Best use in your systemsShowing who you’re talking toDelivery, OTPs, payments, callsThe stable key for matching a customer across tools

    The practical rule: key your customer records on the BSUID, store the phone number when you have it, and treat the username as a display label, because it’s the identifier most likely to change. Changing a username doesn’t change the person’s BSUID or phone number.

    Three luggage tags hang from one suitcase handle, labelled Username for display, Phone number for delivery and OTPs, and BSUID as the stable customer key
    One customer, three identifiers: the username is for display, the phone number for delivery and OTPs, and the BSUID is the key your systems should match on.

    What changes on the WhatsApp Business API

    If you or your provider work directly with the API, these are the changes in Meta’s documentation that touch your code.

    Webhook fields

    FieldWhereBehaviour
    fromIncoming messageOmitted when the phone number can’t be shared
    from_user_idIncoming messageNew. Always set to the user’s BSUID
    contacts[].wa_idIncoming messageOmitted when the phone number can’t be shared
    contacts[].user_idIncoming messageNew. Always set to the user’s BSUID
    contacts[].profile.usernameIncoming messageSet only if the user has a username
    recipient_idStatus updateOmitted if you messaged a BSUID and the number can’t be shared
    recipient_user_idStatus updateNew. Always the BSUID, whether you sent to a number or a BSUID

    Here’s a simplified incoming message from a first-time customer with a username, using the field names above. The values are illustrative:

    {
      "contacts": [
        {
          "profile": { "name": "Riya", "username": "riya.k" },
          "user_id": "IN.13491208655302741918"
        }
      ],
      "messages": [
        {
          "from_user_id": "IN.13491208655302741918",
          "id": "wamid.HBgM...",
          "timestamp": "1760438400",
          "type": "text",
          "text": { "body": "Hi, is the blue kurta in stock?" }
        }
      ]
    }

    Notice what’s missing: there’s no from and no wa_id. Any code that reads messages[0].from as the customer key will get nothing for this message. That’s the most common thing to fix.

    Sending messages

    • Send requests gain a recipient field that takes a BSUID or a parent BSUID. You can still use to for a phone number. If you send both, to wins.
    • You can send any message type to a BSUID except one-tap, zero-tap and copy-code authentication templates, which still need a phone number. Trying returns error 131062 (“Business-scoped User ID (BSUID) recipients are not supported for this message”). If you send login codes, see our authentication templates guide.
    • A BSUID works from any phone number owned by the same business portfolio. Sending from a number in a different portfolio fails. Groups of portfolios enrolled under a parent account get a parent BSUID (it looks like IN.ENT.…) that works across them.

    Identity changes

    • A new user_id_update webhook fires when a user’s BSUID changes, which happens when they change their phone number. It carries the previous and the current BSUID. Use it to merge the old record into the new one rather than creating a duplicate customer.
    • If you delete a user through Meta’s Contact Book API, their phone number and BSUID stop appearing in webhooks.

    What doesn’t change

    Opt-in rules don’t change. You still need a customer’s permission before you send them template messages. A username doesn’t count as consent, and finding a customer’s BSUID doesn’t either. Our WhatsApp opt-in guide covers how to collect and record consent. None of Meta’s username or BSUID pages lists a fee for having a username. Templates are still billed per delivered message by category, as explained in our WhatsApp API pricing guide.

    A preparation checklist for businesses

    Work through this in order. The first four steps secure your name. The rest get your systems ready for customers who arrive without a number.

    1. Agree one handle that matches your Instagram and Facebook usernames.
    2. Link your Facebook Page and Instagram account to each business number that needs the same handle.
    3. Reserve a username for every number, following one naming pattern. Remember that pending requests can’t be cancelled, so check the spelling first.
    4. Wait for “active” before you print. Add the handle to packaging, your website and ads only after WhatsApp confirms it’s live in your region.
    5. Add a BSUID field to your CRM and make it the matching key. Keep the phone number as a separate field that can be empty. If you’re choosing a CRM, our WhatsApp CRM guide lists what to look for.
    6. Fix code that assumes from is a phone number. Check webhook handlers, lead forms, order lookups, and any automation step that searches by number.
    7. Route OTPs around the gap. For login and verification, keep collecting the phone number on your own sign-up form, because BSUID-only customers can’t receive one-tap, zero-tap or copy-code templates.
    8. Leave Meta’s contact book on, so customers you already talk to keep arriving with their numbers.
    9. Handle user_id_update to merge records when a customer changes numbers.
    10. Train your team. Tell agents that a chat showing an @handle and no number is normal, and give them a polite line for asking for a number when an order needs one.

    Using ChatMitra with WhatsApp usernames

    Reserving your username. ChatMitra connects your number through Meta’s Embedded Signup. The WhatsApp Business Account belongs to your own Meta business portfolio, so you reserve the username in WhatsApp Manager exactly as described above. You don’t need to change anything in ChatMitra, and your broadcasts, inbox, chatbot flows and API keys keep working while the request is pending.

    Your display name still leads. Meta shows a business’s display name before its username in the profile, chat list and messages. Keep your display name consistent with your username so customers see one brand.

    Helping customers find you. Until your username is active, keep using your phone-number chat link and QR code. Our free WhatsApp chat link generator and QR code generator both build links from your number, and they work everywhere today.

    Good to know. ChatMitra identifies each chat by the customer’s WhatsApp phone number today. Under Meta’s rules, most conversations will keep arriving with a number: anyone you’ve messaged in the last 30 days, anyone who messaged you, and anyone in your Meta contact book. ChatMitra doesn’t yet support customers who reach you with a BSUID only, which can happen with a brand-new customer who uses a username. ChatMitra’s template builder doesn’t offer Meta’s Request contact info button yet either. Within an open chat, your agents can ask the customer to share their contact card, and ChatMitra’s inbox shows contact cards customers send. We’ll update this guide when BSUID-only contacts are supported. If you build on the ChatMitra API and webhooks, plan your own records around the BSUID now, so they’re ready either way.

    If you’re new to the WhatsApp Business API and want to see how inbox, broadcasts and automation fit together, start with what the WhatsApp Business API is, then see ChatMitra’s plans.

    Clear answers

    Frequently Asked Questions

    It's an optional, unique handle such as @yourbrand that is tied to one WhatsApp phone number. Someone who knows your exact username can start a chat with you without your phone number. WhatsApp has no searchable directory of usernames, so people must type the handle exactly, or use a link or QR code you share.

    On the WhatsApp Business Platform, open WhatsApp Manager in Meta Business Suite, go to Phone numbers, select the number, find Username and click Create. Enter your handle or pick one Meta has reserved or suggested, then save. On the WhatsApp Business app, update to the latest version and look for the Username option in your profile settings. Reservation isn't available on WhatsApp Web.

    A business username must be 3 to 35 characters long and use only English letters, digits, periods and underscores. It needs at least one letter, can't start or end with a period, can't contain two periods in a row, and can't start with www. Case is ignored when usernames are compared, but periods and underscores are not, so my.shop and my_shop are different usernames.

    No. Meta says your business phone number stays visible on your business profile, and customers who have your number can still message you on it. Number privacy applies to people: when a customer with a username messages a business for the first time, the business doesn't see their number unless they share it.

    Not as far as we can find. On 1 July 2026 India's Ministry of Electronics and Information Technology told Meta not to launch usernames in India until consultations conclude, citing fraud and impersonation risks. Meta sent its reply in early July. As of 14 October 2026 we found no public announcement that usernames are live in India. Check WhatsApp Manager to see whether the option appears for your number.

    A business-scoped user ID is an identifier Meta generates for each WhatsApp user and business portfolio pair, for example IN.13491208655302741918. It appears as user_id in messages webhooks for every user, whether or not they have a username. Any number in the same portfolio can message a user by BSUID. It changes only if the user changes their phone number.

    Not with every authentication template. Meta says you can send any message type to a BSUID except one-tap, zero-tap and copy-code authentication templates, which need the customer's phone number. If you try, the API returns error 131062.

    No. A username belongs to exactly one phone number. A brand with separate sales and support numbers needs a different username for each, such as yourbrand and yourbrand.support, so plan a naming pattern before you reserve.

    Nikunj Gohil

    ChatMitra

    Nikunj Gohil writes for the ChatMitra blog about the WhatsApp Business API.

    Ready to try WhatsApp Business API?

    Start free on the Starter plan — free subscription. Pro is ₹999/month with a 15-day trial when you need automation.