Get business username
Fetch the current WhatsApp Business username and its approval status.
Username status can be approved (active), reserved (pending activation), or none (no username set).
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
WhatsApp social account ID
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.whatsapp.getWhatsappBusinessUsername({ query: { accountId: 'account_abc123', },});console.log(data);{
"success": true,
"username": "string",
"status": "approved"
}{
"error": "Unauthorized"
}Get username suggestions GET
Retrieve a list of available WhatsApp Business username suggestions based on the account's business profile name. Use these to help users discover valid, unclaimed usernames.
Set business username POST
Claim or transfer a WhatsApp Business username for the account. Username rules: 3-35 characters, letters/digits/period/underscore only, must contain at least one letter, no leading or trailing periods, no consecutive periods, no `www` prefix, no domain TLD suffix (e.g. `.com`). If the desired username is currently held by another account, pass `transferAction: "force_transfer"` to request a transfer. On failure the API returns a standard error envelope with one of these codes: `whatsapp_username_unavailable` (already taken and transfer not requested), `whatsapp_username_ineligible` (account not eligible to claim a username), or `whatsapp_username_transfer_required` (username is held elsewhere; retry with `force_transfer`).