Skip to content
Shortcut: /, ⌘K or Ctrl+K

Business profile

Read and update the business profile customers see for a Number.

View as Markdown

A business profile is what customers see when they open a business chat: description, address, hours, websites, categories and cover photo. On a WhatsApp Business app Number connected through Linked Devices, these methods read and change the account's profile directly.

The Meta-compatible business-profile methods return saved profile fields for Linked Devices Numbers and test numbers. They do not read or change the WhatsApp profile of a real Meta Cloud API Number.

Linked Business App profile#

Start with Get own business profile. The response can include description, address, email, websites, business hours, categories, cover-photo ID, and profile options returned by WhatsApp.

Update linked business profile changes only supplied fields. Empty values clear supported optional fields. Business hours use a time zone, weekday, mode, and minutes after midnight.

Profile request rules#

Fields or modeAccepted input
Profile updateAt least one supported profile field is required. An empty update is rejected.
hours.daysInclude each weekday at most once.
specific_hoursBoth openTime and closeTime are required and must be different. Each is an integer from 0 through 1439 minutes after midnight.
open_24h or appointment_onlyOmit openTime and closeTime.
websites[]Use an absolute HTTP or HTTPS URL.
Cover photoSet exactly one of url or base64. An empty request or both sources together are rejected. The decoded or downloaded image accepts at most 5 MiB.

Use Set business cover photo and Delete business cover photo for cover media.

Linked accounts and eligibility#

Get business linked accounts reads linked Facebook, Instagram, advertising, and catalog identities when WhatsApp returns them.

Get business eligibility reports upstream account eligibility. It does not grant a Polymorfa entitlement.

Both are live lookups. They do not enable background profile tracking.

Merchant compliance#

Get merchant compliance reads the connected account's legal entity and customer-care contacts. Update merchant compliance replaces the complete record.

Compliance strings are trimmed before validation. Entity names, custom entity types, and grievance-officer names accept at most 256 UTF-8 bytes; email accepts at most 254 UTF-8 bytes; landline and mobile numbers accept at most 64 UTF-8 bytes each.

WhatsApp controls whether an account and region can edit these details. An upstream rejection leaves the existing record unchanged.

Business profiles through the Graph API#

The Graph API reads and saves business-profile fields in Meta's shape:

Graph API
curl "https://api.polymorfa.com/graph/whatsapp/v26.0/$PHONE_NUMBER_ID/whatsapp_business_profile" \
  -H "Authorization: Bearer $POLYMORFA_PROJECT_TOKEN"

curl -X POST "https://api.polymorfa.com/graph/whatsapp/v26.0/$PHONE_NUMBER_ID/whatsapp_business_profile" \
  -H "Authorization: Bearer $POLYMORFA_PROJECT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "about": "Orders ship within two days",
    "websites": ["https://shop.example.com"]
  }'

Reading needs sessions:read and updating needs sessions:manage. These methods store the fields Meta's business-profile shape carries (about, address, description, email, websites, vertical and a profile picture handle). Business hours, cover photos, linked accounts and merchant compliance have no Graph method; use the methods above.

The method pages contain the request schema, responses, scopes, connection badges, and raw-request playground.

See also#