Display names

Your display name appears in your WhatsApp Business profile and at the top of chat threads.

Change display name

Dashboard
API

Go to Connected numbers → select your number
Click Profile tab
Edit Display name and submit

curl -X POST 'https://api.kapso.ai/platform/v1/whatsapp/{phone_number_id}/display_names' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"display_name_request": {"new_display_name": "My Business Name"}}'

Numbers on WhatsApp Business App

Numbers connected in coexistence mode, or otherwise still on WhatsApp Business App, manage their display name in the app. Kapso rejects the change with 422 and does not create a request:

{
  "error": "Manage this number's display name in WhatsApp Business App. Display name changes through Kapso are not supported for coexistence numbers."
}

Review statuses

Meta reviews display name changes. Most complete within 24-48 hours.

Status	Meaning
`submitted`	Request sent to Meta
`pending_review`	Meta is reviewing
`approved`	Name approved and active
`available_without_review`	Approved instantly (common names)
`deferred`	Decision postponed—usually approved later without action needed
`declined`	Name rejected—see rejection reason and edit

What does “Deferred” mean?

Meta defers decisions when additional review is needed. This typically resolves to approved within a few days without action on your part. If it stays deferred for more than a week, contact Meta Business Support.

Rejection reasons

Reason	Fix
`NAME_NOT_CONSISTENT`	Name must match your website/branding
`NAME_FORMAT_UNACCEPTABLE`	Remove URLs, emails, or promotional text
`NAME_EMPLOYEE_ISSUE`	Remove personal names unless tied to branding
`NAME_ENDCLIENT_NOTRELATED`	Name must relate to your business

Guidelines

Meta requires display names to:

Accurately represent your business
Match your external branding (website, social media)
Not include “Official”, “Verified”, or Meta brand names
Not be generic terms or locations
Not contain promotional language

Meta’s display name guidelines

Getting started

WhatsApp

For your team

Onboard customers

Automations

Migrate to Kapso

Change display name

Numbers on WhatsApp Business App

Review statuses

What does “Deferred” mean?

Rejection reasons

Guidelines

​Change display name

​Numbers on WhatsApp Business App

​Review statuses

​What does “Deferred” mean?

​Rejection reasons

​Guidelines

Change display name

Numbers on WhatsApp Business App

Review statuses

What does “Deferred” mean?

Rejection reasons

Guidelines