Update Display Name

The verified business name (shown at the top of every customer chat) is updated through the same endpoint used to register a number. Send the new name in the body; Meta puts it through name review and flips your number to PENDING_REVIEW until approved.


POST /api/v25.0/{PHONE_NUMBER_ID}/register
Authorization: Bearer pk_live_<your-key>
Content-Type: application/json

Request body


{
  "messaging_product":  "whatsapp",
  "pin":                "123456",
  "new_verified_name":  "Splashify Pro"
}

Field	Notes
`pin`	The 6-digit two-step-verification PIN registered on this number
`new_verified_name`	Proposed display name. 1–25 characters. Must match the legal/trade name on the linked Business Verification

Response — 200


{ "success": true }

The request enters Meta’s review queue. Check status via Phone Number Details:


GET /api/v25.0/{PHONE_NUMBER_ID}?fields=name_status,verified_name

`name_status`	Meaning
`APPROVED`	Live — customers see the new name
`PENDING_REVIEW`	Meta is reviewing; old name is still shown
`DECLINED`	Rejected. The previous name stays. Reasons are NOT exposed via API — check WhatsApp Manager
`EXPIRED`	Submission timed out (rare; resubmit)

Naming rules

Meta rejects names that:

Contain emoji, special characters (other than &, ', ., -), or excessive capitalisation
Use generic terms (“Customer Care”, “Helpdesk”, “Sales”) without the brand
Imply affiliation with platforms you don’t own (“WhatsApp Support”, “Meta Verified”)
Reference a different business than the one on file in Business Verification

Errors

Body	When
`(#100) new_verified_name too short` / `too long`	Outside 1–25 chars
`(#100) Invalid character in new_verified_name`	Special chars not in the allow-list
`(#136025) Two-step verification pin mismatch`	Wrong `pin`
`(#131045) Phone number not verified`	The number is `EXPIRED` or `NOT_VERIFIED` — re-run Verification Code first
`(#136100) Name change rate-limited`	You can submit a name change once per 30 days

cURL


curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "pin":               "123456",
    "new_verified_name": "Splashify Pro"
  }'

Notes

One endpoint, two roles. /register is also how you bring a number online after onboarding — see Register / Deregister. To change ONLY the display name, send new_verified_name with the PIN. To register a number for the first time, send just the PIN.
Approved names are sticky. Once APPROVED, the new name appears immediately in the WhatsApp client (caching aside). The old name is not retrievable.