Set business username
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).
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
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.setWhatsappBusinessUsername({ body: { accountId: 'account_abc123', username: 'Example', },});console.log(data);{ "success": true, "username": "mybusiness", "status": "approved"}Get username suggestions
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.
Delete business username
Release the currently claimed WhatsApp Business username from the account. After deletion the username becomes available for other accounts to claim.