> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/messaging-api/api-reference/business-username.md).

# Business Username

Endpoints for managing WhatsApp business username

## Get current business username

> Retrieve current WhatsApp business username and status.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.49.2"},"tags":[{"name":"Business Username","description":"Endpoints for managing WhatsApp business username"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"businessusername.GetUsernameResponse":{"description":"Response payload for retrieving current business username","properties":{"status":{"type":"string"},"username":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/username":{"get":{"description":"Retrieve current WhatsApp business username and status.","operationId":"get-username","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.GetUsernameResponse"}}},"description":"Username retrieved successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Get current business username","tags":["Business Username"]}}}}
```

## Adopt or change business username

> Adopt or change WhatsApp business username. On success, username status is either approved (visible to WhatsApp users after feature rollout) or reserved (approved but not yet visible).

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.49.2"},"tags":[{"name":"Business Username","description":"Endpoints for managing WhatsApp business username"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"businessusername.AdoptUsernameRequest":{"description":"Request payload for business username adoption or change","properties":{"username":{"type":"string"}},"type":"object"},"businessusername.AdoptUsernameResponse":{"description":"Response payload for successful business username adoption or change","properties":{"status":{"type":"string"}},"type":"object"},"businessusername.AdoptUsernameErrorResponse":{"description":"Generic Meta error response for adopt username operations. Exact message, code, subcode, and details vary by failure reason.","properties":{"error":{"$ref":"#/components/schemas/businessusername.AdoptUsernameAPIError"}},"type":"object"},"businessusername.AdoptUsernameAPIError":{"properties":{"code":{"type":"integer"},"error_data":{"$ref":"#/components/schemas/businessusername.AdoptUsernameErrorData"},"error_subcode":{"type":"integer"},"fbtrace_id":{"type":"string"},"message":{"type":"string"},"type":{"type":"string"}},"type":"object"},"businessusername.AdoptUsernameErrorData":{"properties":{"details":{"type":"string"},"messaging_product":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/username":{"post":{"description":"Adopt or change WhatsApp business username. On success, username status is either approved (visible to WhatsApp users after feature rollout) or reserved (approved but not yet visible).","operationId":"adopt-business-username","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.AdoptUsernameRequest","summary":"requestBody","description":"Adopt username request payload"}}},"description":"Adopt username request payload","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.AdoptUsernameResponse"}}},"description":"Username adopted or changed successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.AdoptUsernameErrorResponse"}}},"description":"Meta API error with operation-specific code and details"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Adopt or change business username","tags":["Business Username"]}}}}
```

## Delete business username

> Delete WhatsApp business username.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.49.2"},"tags":[{"name":"Business Username","description":"Endpoints for managing WhatsApp business username"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"businessusername.DeleteUsernameResponse":{"description":"Response payload for deleting business username","properties":{"success":{"type":"boolean"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/username":{"delete":{"description":"Delete WhatsApp business username.","operationId":"delete-username","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.DeleteUsernameResponse"}}},"description":"Username deleted successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Delete business username","tags":["Business Username"]}}}}
```

## Get reserved business username suggestions

> Get reserved WhatsApp business username suggestions. Reserved usernames have higher approval likelihood.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.49.2"},"tags":[{"name":"Business Username","description":"Endpoints for managing WhatsApp business username"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"businessusername.GetUsernameSuggestionsResponse":{"description":"Response payload for retrieving reserved business username suggestions","properties":{"data":{"items":{"$ref":"#/components/schemas/businessusername.UsernameSuggestionsItem"},"type":"array","uniqueItems":false}},"type":"object"},"businessusername.UsernameSuggestionsItem":{"properties":{"username_suggestions":{"items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/username_suggestions":{"get":{"description":"Get reserved WhatsApp business username suggestions. Reserved usernames have higher approval likelihood.","operationId":"get-username-suggestions","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/businessusername.GetUsernameSuggestionsResponse"}}},"description":"Reserved username suggestions retrieved successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Get reserved business username suggestions","tags":["Business Username"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.360dialog.com/docs/messaging-api/api-reference/business-username.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.