Business username

The username command mirrors Settings → Username. The username is the vanity handle that surfaces in WhatsApp Search and on the business profile card.

Quick start


splashify username                    # show current username + status
splashify username suggestions        # backend-suggested ideas
splashify username adopt mybrand      # claim a username
splashify username delete             # release the current username

Command reference

Subcommand	Backed by
(none — default) / `show` / `get` / `status`	`GET /api/v1/app/phone/username`
`suggestions` / `suggest` / `ideas`	`GET /api/v1/app/phone/username_suggestions`
`adopt <name>` (aliases: `claim`, `set`, `reserve`)	`POST /api/v1/app/phone/username` `{"username":"…"}`
`delete` (aliases: `release`, `remove`, `rm`)	`DELETE /api/v1/app/phone/username`

Status values

`status`	What it means
`approved`	Username is live on the business profile
`reserved`	Claim accepted; Meta is verifying
(absent)	No username on this account

Naming rules

Meta enforces the rules; the CLI passes the name through. In broad strokes:

3–30 characters
Lowercase letters, numbers, periods, and underscores
No reserved words, profanity, or impersonation of brands you don’t own

If the backend refuses your pick, try splashify username suggestions for valid alternatives.

Common patterns


# Pick the first available suggestion
NAME=$(splashify username suggestions | jq -r '.data[0].username_suggestions[0]')
splashify username adopt "$NAME"
 
# Audit: is my username approved?
splashify username | jq -r '.status'

WhatsApp Business Account — phone, verification, OBA
Profile — user-level profile (different surface)