# WhatsApp Username Generator API

Version: 2026-07-01

## Generate usernames

`POST /api/whatsapp-usernames`

Request body:

- `brandName`: required string, 1 to 80 characters.
- `category`: one of `with-your-name`, `business`, `cool`, `beauty`, `aesthetic`, `funny`, `for-girls`, `for-boys`.
- `businessAccount`: boolean.
- `description`: optional string, up to 200 characters.

Example:

```json
{
  "brandName": "Acme Studio",
  "category": "business",
  "businessAccount": true,
  "description": "Short optional context"
}
```

The response contains `ok`, `version`, and either `data.suggestions` or an `error` object.