Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.
Claiming the username
The username is the public @name of your official WhatsApp Business line. It is a new way for customers to reach you without needing your phone number — the number is still displayed on your profile.This guide shows how to claim the username directly in the WhatsApp Manager, using the administrator account of your business portfolio (Business Manager) on Meta.
The same operation can be done through the Positus API, including reading, setting, deleting and getting username suggestions. See Official line username.
Prerequisites
Access to the Facebook account with a BM administrator user (business portfolio on Meta).
The WhatsApp Business API number already active inside the WhatsApp account (WABA).
Step by step
1
Access the business portfolio
Log in to Facebook with the BM administrator user (business portfolio on Meta).
Click on the WhatsApp account that holds the number and then on WHATSAPP MANAGER.
WhatsApp Manager button on the WhatsApp account screen
4
Create the username
Click on the desired number, open the PROFILE tab and, under Username, click CREATE.
Profile tab of the number with the Create option under Username
5
Fill in and save
Type the desired name and click SAVE. Meta also displays suggestions of available names.
Username creation window with suggestions and the Save button
Important notes
Each number can have only one username.
It is not possible to have more than one number with the same username.
Username format
Business usernames must follow the format below:
May contain only English alphabet letters (a-z), digits (0-9), period (.) and underscore (_);
Characters that are not English alphabet letters (such as ñ, é, ü) are not supported and will cause the request to fail;
Must be between 3 and 35 characters;
Must contain at least one English alphabet letter (a-z, A-Z);
Cannot start or end with a period, nor contain two consecutive periods (..);
Cannot start with www;
Cannot end with a domain (for example .com, .org, .net, .int, .edu, .gov, .mil, .us, .in, .html and so on);
Usernames are compared case-insensitively.
After saving
Username propagation is asynchronous. Meta may first reserve (reserved) the name and only then promote it to approved (approved), when it becomes visible to customers on WhatsApp.
Positus notifies your webhook on every username status change — including changes made through the WhatsApp Manager, as in this guide. The event is business_username_update; see Line username update.
Common issues
Situation
What to do
The username is already taken or unavailable
Choose another name or use one of the suggestions displayed by Meta.
The account does not meet the messaging limit requirements
Increase the number’s messaging limit before reserving a username.
A Facebook Page or Instagram account already uses that name
Link the Page or the Instagram account to the number and try again.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Robbu Docs","colors":{"primary":"#007aff","light":"#007aff","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/robbu/iCVnyYfr1g5LFTfr/logo/light.svg?fit=max\u0026auto=format\u0026n=iCVnyYfr1g5LFTfr\u0026q=85\u0026s=5a7060dcdff16650cab3b50abae2118c","dark":"https://mintcdn.com/robbu/iCVnyYfr1g5LFTfr/logo/dark.svg?fit=max\u0026auto=format\u0026n=iCVnyYfr1g5LFTfr\u0026q=85\u0026s=d57ea8e559e163d8062cb269f7690ff7"},"favicon":"https://mintcdn.com/robbu/iCVnyYfr1g5LFTfr/logo/light.svg?fit=max\u0026auto=format\u0026n=iCVnyYfr1g5LFTfr\u0026q=85\u0026s=5a7060dcdff16650cab3b50abae2118c","navbar":{"links":[{"href":"mailto:help@robbu.global","label":"Suporte"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"footer":{"socials":{"instagram":"https://instagram.com/robbu","linkedin":"https://www.linkedin.com/company/robbu/posts?feedView=all"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Institucional","icon":"book-open-cover","href":"https://robbu.global"},{"anchor":"Blog","icon":"newspaper","href":"https://robbu.global/blog/"}]},"languages":[{"language":"pt","href":"docs/accounts/como-acessar-plataforma"},{"language":"en","href":"en/positus/getting-started/introduction"},{"language":"es","href":"es/positus/primeros-pasos/introduccion"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"robbu","hasAudioNarration":false,"actualSubdomain":"robbu","customDomains":["docs.robbu.global"],"gitSource":{"type":"github","owner":"robbuapps","repo":"invenio-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af4b1331d4e06723e755557","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"pt","tag":"Invenio Center","count":47},{"language":"pt","tag":"Positus","count":43},{"language":"en","tag":"Positus","count":43},{"language":"es","tag":"Positus","count":37},{"language":"pt","tag":"Invenio Live","count":17},{"language":"pt","tag":"Integração WhatsApp API","count":8},{"language":"en","tag":"WhatsApp API Integration","count":8},{"language":"es","tag":"Integración WhatsApp API","count":8},{"language":"pt","tag":"Coexistência","count":7},{"language":"pt","tag":"Flows","count":7},{"language":"en","tag":"Coexistence","count":7},{"language":"en","tag":"Flows","count":7},{"language":"es","tag":"Coexistencia","count":7},{"language":"es","tag":"Flows","count":7},{"language":"pt","tag":"Robbu APIs","count":6},{"language":"pt","tag":"Templates","count":6},{"language":"en","tag":"Templates","count":6},{"language":"pt","tag":"WhatsApp Calling","count":4},{"language":"pt","tag":"Positus Studio","count":4},{"language":"en","tag":"WhatsApp Calling","count":4},{"language":"en","tag":"Positus Studio","count":4},{"language":"es","tag":"WhatsApp Calling","count":4},{"language":"es","tag":"Positus Studio","count":4},{"language":"en","tag":"Getting Started","count":3},{"language":"es","tag":"Primeros Pasos","count":3},{"language":"en","tag":"Positus and WhatsApp Business API","count":2},{"language":"en","tag":"Positus Messenger","count":2},{"language":"es","tag":"Positus Messenger","count":2},{"language":"es","tag":"Positus y WhatsApp Business API","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"en/positus/getting-started/claiming-username","slug":"/en/positus/getting-started/claiming-username","pageMetadata":{"title":"Claiming the username","description":"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.","href":"/en/positus/getting-started/claiming-username"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Info,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`claiming-the-username`,children:`Claiming the username`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`username`}),` is the public `,_jsx(_components.code,{children:`@name`}),` of your official WhatsApp Business line. It is a new way for customers to reach you `,_jsx(_components.strong,{children:`without needing your phone number`}),` — the number is still displayed on your profile.`]}),`\n`,_jsxs(_components.p,{children:[`This guide shows how to claim the username directly in the `,_jsx(_components.strong,{children:`WhatsApp Manager`}),`, using the administrator account of your business portfolio (Business Manager) on Meta.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`The same operation can be done through the `,_jsx(_components.strong,{children:`Positus API`}),`, including reading, setting, deleting and getting username suggestions. See `,_jsx(_components.a,{href:`/en/positus/integration/line-username`,children:`Official line username`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Access to the Facebook account with a `,_jsx(_components.strong,{children:`BM administrator user`}),` (business portfolio on Meta).`]}),`\n`,_jsx(_components.li,{children:`The WhatsApp Business API number already active inside the WhatsApp account (WABA).`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`step-by-step`,children:`Step by step`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Access the business portfolio`,children:_jsxs(_components.p,{children:[`Log in to Facebook with the `,_jsx(_components.strong,{children:`BM administrator user`}),` (business portfolio on Meta).`]})}),_jsx(Step,{title:`Open the WhatsApp Accounts menu`,children:_jsxs(_components.p,{children:[`Access the `,_jsx(_components.strong,{children:`WHATSAPP ACCOUNTS`}),` menu through this link: `,_jsx(_components.a,{href:`https://business.facebook.com/latest/settings/whatsapp_account`,children:`business.facebook.com/latest/settings/whatsapp_account`})]})}),_jsxs(Step,{title:`Open the WhatsApp Manager`,children:[_jsxs(_components.p,{children:[`Click on the WhatsApp account that holds the number and then on `,_jsx(_components.strong,{children:`WHATSAPP MANAGER`}),`.`]}),_jsx(Frame,{caption:`WhatsApp Manager button on the WhatsApp account screen`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=23ad0f3a3d7e8878fb9b3436405bcd92`,\"data-og-width\":`858`,width:`858`,\"data-og-height\":`744`,height:`744`,\"data-path\":`images/positus/primeiros-passos/gerenciador-do-whatsapp.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=280\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=26d693c47d3dc21df7b056f8655d91bc 280w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=560\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=0f4f474fb879486aa3bc09c83d7face9 560w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=840\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=9b1dfa96d248386dbe122fafb8c46ccf 840w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=f6df9409b14914de679186dc574bfdde 1100w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=da06b3c898a9e3399f62114bed1db2b1 1650w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/gerenciador-do-whatsapp.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=f0771cc688e85b97f6d330d2850897fe 2500w`})})]}),_jsxs(Step,{title:`Create the username`,children:[_jsxs(_components.p,{children:[`Click on the desired number, open the `,_jsx(_components.strong,{children:`PROFILE`}),` tab and, under `,_jsx(_components.strong,{children:`Username`}),`, click `,_jsx(_components.strong,{children:`CREATE`}),`.`]}),_jsx(Frame,{caption:`Profile tab of the number with the Create option under Username`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=0111c46ea8be2154e4716047be4431e9`,\"data-og-width\":`1206`,width:`1206`,\"data-og-height\":`507`,height:`507`,\"data-path\":`images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=280\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=f474dc81dc49f0bc3bff855509e0c7a2 280w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=560\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=0528a789b94230b1b6fc455b86264fd3 560w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=840\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=3e5b341da5f092eb37424023d6998982 840w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=cecb89032ee62e92040e46077afbdeaa 1100w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=dac1fb61417f019fc14ef156703680ab 1650w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-perfil-criar.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=661b1c54650b9177dddf490543936578 2500w`})})]}),_jsxs(Step,{title:`Fill in and save`,children:[_jsxs(_components.p,{children:[`Type the desired name and click `,_jsx(_components.strong,{children:`SAVE`}),`. Meta also displays `,_jsx(_components.strong,{children:`suggestions`}),` of available names.`]}),_jsx(Frame,{caption:`Username creation window with suggestions and the Save button`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=8ce67c346f409e40328bfe71e298f579`,\"data-og-width\":`683`,width:`683`,\"data-og-height\":`391`,height:`391`,\"data-path\":`images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=280\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=2869b0452475b81673c5bf7357142622 280w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=560\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=17ab006034562e0c4a0ed6851348f023 560w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=840\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=e85e8ec337978662e2c714f8dea83a89 840w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=ea968493ee90dbabed5dd6abee835489 1100w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=df15603c67545727d64efe251f5f9e0f 1650w, https://mintcdn.com/robbu/3e4bfLiNwxzpjrBk/images/positus/primeiros-passos/nome-de-usuario-modal-salvar.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3e4bfLiNwxzpjrBk\u0026q=85\u0026s=78c8d19a59425b27de9d54966c5b7933 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`important-notes`,children:`Important notes`}),`\n`,_jsx(Warning,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Each number can have `,_jsx(_components.strong,{children:`only one`}),` username.`]}),`\n`,_jsxs(_components.li,{children:[`It is `,_jsx(_components.strong,{children:`not possible`}),` to have more than one number with the same username.`]}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`username-format`,children:`Username format`}),`\n`,_jsx(_components.p,{children:`Business usernames must follow the format below:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`May contain only English alphabet letters (`,_jsx(_components.code,{children:`a-z`}),`), digits (`,_jsx(_components.code,{children:`0-9`}),`), period (`,_jsx(_components.code,{children:`.`}),`) and underscore (`,_jsx(_components.code,{children:`_`}),`);`]}),`\n`,_jsxs(_components.li,{children:[`Characters that are not English alphabet letters (such as `,_jsx(_components.code,{children:`ñ`}),`, `,_jsx(_components.code,{children:`é`}),`, `,_jsx(_components.code,{children:`ü`}),`) are not supported and will cause the request to fail;`]}),`\n`,_jsxs(_components.li,{children:[`Must be between `,_jsx(_components.strong,{children:`3 and 35 characters`}),`;`]}),`\n`,_jsxs(_components.li,{children:[`Must contain at least one English alphabet letter (`,_jsx(_components.code,{children:`a-z`}),`, `,_jsx(_components.code,{children:`A-Z`}),`);`]}),`\n`,_jsxs(_components.li,{children:[`Cannot start or end with a period, nor contain two consecutive periods (`,_jsx(_components.code,{children:`..`}),`);`]}),`\n`,_jsxs(_components.li,{children:[`Cannot start with `,_jsx(_components.code,{children:`www`}),`;`]}),`\n`,_jsxs(_components.li,{children:[`Cannot end with a domain (for example `,_jsx(_components.code,{children:`.com`}),`, `,_jsx(_components.code,{children:`.org`}),`, `,_jsx(_components.code,{children:`.net`}),`, `,_jsx(_components.code,{children:`.int`}),`, `,_jsx(_components.code,{children:`.edu`}),`, `,_jsx(_components.code,{children:`.gov`}),`, `,_jsx(_components.code,{children:`.mil`}),`, `,_jsx(_components.code,{children:`.us`}),`, `,_jsx(_components.code,{children:`.in`}),`, `,_jsx(_components.code,{children:`.html`}),` and so on);`]}),`\n`,_jsx(_components.li,{children:`Usernames are compared case-insensitively.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`after-saving`,children:`After saving`}),`\n`,_jsxs(_components.p,{children:[`Username propagation is `,_jsx(_components.strong,{children:`asynchronous`}),`. Meta may first `,_jsx(_components.strong,{children:`reserve`}),` (`,_jsx(_components.code,{children:`reserved`}),`) the name and only then promote it to `,_jsx(_components.strong,{children:`approved`}),` (`,_jsx(_components.code,{children:`approved`}),`), when it becomes visible to customers on WhatsApp.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Positus notifies your webhook on every username status change — including changes made through the WhatsApp Manager, as in this guide. The event is `,_jsx(_components.code,{children:`business_username_update`}),`; see `,_jsx(_components.a,{href:`/en/positus/integration/webhook#business-username-update`,children:`Line username update`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`common-issues`,children:`Common issues`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The username is already taken or unavailable`}),_jsx(_components.td,{children:`Choose another name or use one of the suggestions displayed by Meta.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The account does not meet the messaging limit requirements`}),_jsx(_components.td,{children:`Increase the number’s messaging limit before reserving a username.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A Facebook Page or Instagram account already uses that name`}),_jsx(_components.td,{children:`Link the Page or the Instagram account to the number and try again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The request fails due to invalid format`}),_jsxs(_components.td,{children:[`Review the rules in `,_jsx(_components.a,{href:`#username-format`,children:`Username format`}),`.`]})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`The full list of error codes returned by Meta is available in `,_jsx(_components.a,{href:`/en/positus/integration/line-username#errors`,children:`Official line username — Error handling`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Claiming the username","description":"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.","href":"/en/positus/getting-started/claiming-username"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Claiming the username","slug":"claiming-the-username","depth":1,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Step by step","slug":"step-by-step","depth":2,"children":[]},{"title":"Important notes","slug":"important-notes","depth":2,"children":[]},{"title":"Username format","slug":"username-format","depth":2,"children":[]},{"title":"After saving","slug":"after-saving","depth":2,"children":[]},{"title":"Common issues","slug":"common-issues","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/robbu/ae2c024f9fda5c61/static/global.js","/_mintlify/custom/robbu/5255cc048bdb0b57/static/chat.js"],"subdomain":"robbu","siteName":"Robbu Docs","title":"Claiming the username - Robbu Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt":{"href":"/docs/accounts/como-acessar-plataforma","matchLevel":3},"en":{"href":"/en/positus/getting-started/claiming-username","matchLevel":0},"es":{"href":"/es/positus/primeros-pasos/introduccion","matchLevel":3}}},"lastModified":"2026-08-20T18:02:13.768Z","originalFileLocation":"en/positus/getting-started/claiming-username.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Robbu Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Claiming the username - Robbu Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Robbu Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.robbu.global/en/positus/getting-started/claiming-username\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://robbu.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Claiming+the+username\u0026amp;description=Step-by-step+guide+to+claim+the+username+%28%40%29+for+your+WhatsApp+Business+API+numbers+through+the+WhatsApp+Manager.\u0026amp;theme=08ec3db945b45576f6702401\u0026amp;signature=bd1309850df7ee21a41e817171dac3f837ea79756377700b8368d7ec4c158c89\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Claiming the username - Robbu Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://robbu.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Claiming+the+username\u0026amp;description=Step-by-step+guide+to+claim+the+username+%28%40%29+for+your+WhatsApp+Business+API+numbers+through+the+WhatsApp+Manager.\u0026amp;theme=08ec3db945b45576f6702401\u0026amp;signature=bd1309850df7ee21a41e817171dac3f837ea79756377700b8368d7ec4c158c89\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/robbu/pmUTouq0L8AT5A3r/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Robbu Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007aff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.robbu.global/en/positus/getting-started/claiming-username\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/positus/getting-started/claiming-username.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.robbu.global/#organization\",\"name\":\"Robbu Docs\",\"url\":\"https://docs.robbu.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/robbu/iCVnyYfr1g5LFTfr/logo/light.svg?fit=max\u0026auto=format\u0026n=iCVnyYfr1g5LFTfr\u0026q=85\u0026s=5a7060dcdff16650cab3b50abae2118c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.robbu.global#website\",\"name\":\"Robbu Docs\",\"url\":\"https://docs.robbu.global\",\"publisher\":{\"@id\":\"https://docs.robbu.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username#webpage\",\"url\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username\",\"name\":\"Claiming the username\",\"description\":\"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\",\"dateModified\":\"2026-08-20T18:02:13.768Z\",\"isPartOf\":{\"@id\":\"https://docs.robbu.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Positus\",\"item\":\"https://docs.robbu.global/en/positus/getting-started/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting Started\",\"item\":\"https://docs.robbu.global/en/positus/getting-started/how-to-start\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Claiming the username\",\"item\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username#article\",\"headline\":\"Claiming the username\",\"name\":\"Claiming the username\",\"description\":\"Step-by-step guide to claim the username (@) for your WhatsApp Business API numbers through the WhatsApp Manager.\",\"url\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username\",\"mainEntityOfPage\":{\"@id\":\"https://docs.robbu.global/en/positus/getting-started/claiming-username#webpage\"},\"dateModified\":\"2026-08-20T18:02:13.768Z\",\"publisher\":{\"@id\":\"https://docs.robbu.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.robbu.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Robbu Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Robbu Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/positus/getting-started/claiming-username.md","siteName":"Robbu Docs","nav":{"global":{"anchors":[{"anchor":"Institucional","icon":"book-open-cover","href":"https://robbu.global"},{"anchor":"Blog","icon":"newspaper","href":"https://robbu.global/blog/"}]},"languages":[{"language":"pt","pages":[{"title":"pt","href":"/docs/accounts/como-acessar-plataforma"}]},{"language":"en","groups":[{"group":"Positus","pages":[{"group":"Positus and WhatsApp Business API","pages":[{"title":"Positus and WhatsApp Business API","href":"/en/positus/getting-started/introduction"},{"title":"WhatsApp Benchmark","href":"/en/positus/whatsapp-benchmark"}]},{"group":"Getting Started","pages":[{"title":"How to Get Started","href":"/en/positus/getting-started/how-to-start"},{"title":"Creating a Facebook Business Account","description":"Business Manager is a Facebook tool that helps organize and manage your business.","href":"/en/positus/getting-started/creating-facebook-business"},{"title":"Claiming the username","href":"/en/positus/getting-started/claiming-username"}]},{"group":"WhatsApp API Integration","pages":[{"title":"BSUID and user identifiers","description":"Understand the BSUID (Business-Scoped User ID), the parent BSUID, the username, and how they relate to the phone number (wa_id) in webhooks and WhatsApp Business API requests.","href":"/en/positus/integration/bsuid"},{"title":"API - Documentation","href":"/en/positus/integration/api"},{"title":"Number and business profile","href":"/en/positus/integration/number-and-profile"},{"title":"Contacts API","href":"/en/positus/integration/contacts"},{"title":"Official line username","href":"/en/positus/integration/line-username"},{"title":"Webhook","href":"/en/positus/integration/webhook"},{"title":"Webhook IP addresses","href":"/en/positus/integration/webhook-ips"},{"title":"Code examples","href":"/en/positus/integration/code-examples"}]},{"group":"Positus Studio","pages":[{"title":"Positus Studio","href":"/en/positus/studio/positus-studio"},{"title":"Sandbox","href":"/en/positus/studio/sandbox"},{"title":"Webhook","href":"/en/positus/studio/webhook"},{"title":"API - Studio","href":"/en/positus/studio/api-studio"}]},{"group":"Positus Messenger","pages":[{"title":"Positus Messenger","href":"/en/positus/messenger/positus-messenger"},{"title":"FAQ","href":"/en/positus/messenger/faq"}]},{"group":"Flows","pages":[{"title":"Introduction to Flows","href":"/en/positus/flows/introduction"},{"title":"Types of Flows","href":"/en/positus/flows/types-of-flows"},{"title":"Structure and Components","href":"/en/positus/flows/structure-and-components"},{"title":"Dynamic Flows","href":"/en/positus/flows/dynamic-flows"},{"title":"Flows Webhooks","href":"/en/positus/flows/webhooks"},{"title":"Flows API","href":"/en/positus/flows/api"},{"title":"Samples","href":"/en/positus/flows/samples"}]},{"group":"Templates","pages":[{"title":"Introduction to Templates","href":"/en/positus/templates/introduction"},{"title":"Template Attributes","href":"/en/positus/templates/attributes"},{"title":"Templates API","href":"/en/positus/templates/api"},{"title":"Bulk Sending","href":"/en/positus/templates/bulk-sending"},{"title":"Templates Webhooks","href":"/en/positus/templates/webhooks"},{"title":"Examples","href":"/en/positus/templates/examples"}]},{"group":"WhatsApp Calling","pages":[{"title":"Introduction to WhatsApp Calling","href":"/en/positus/calling/introduction"},{"title":"Calling API","href":"/en/positus/calling/api"},{"title":"Call Webhooks","href":"/en/positus/calling/webhooks"},{"title":"Samples","href":"/en/positus/calling/samples"}]},{"group":"Coexistence","pages":[{"title":"Introduction to Coexistence","href":"/en/positus/coex/introduction"},{"title":"Coexistence Onboarding","href":"/en/positus/coex/onboarding"},{"title":"Contact synchronization","href":"/en/positus/coex/contact-sync"},{"title":"History synchronization","href":"/en/positus/coex/history-sync"},{"title":"Mirrored messages","href":"/en/positus/coex/mirrored-messages"},{"title":"CoEx Webhooks","href":"/en/positus/coex/webhooks"},{"title":"API - Coexistence","href":"/en/positus/coex/api"}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/positus/primeros-pasos/introduccion"}]}]},"basePath":"","title":"Claiming the username - Robbu Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}