Business profile
Read and update the business profile customers see for a Number.
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 mode | Accepted input |
|---|---|
| Profile update | At least one supported profile field is required. An empty update is rejected. |
hours.days | Include each weekday at most once. |
specific_hours | Both openTime and closeTime are required and must be different. Each is an integer from 0 through 1439 minutes after midnight. |
open_24h or appointment_only | Omit openTime and closeTime. |
websites[] | Use an absolute HTTP or HTTPS URL. |
| Cover photo | Set 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:
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.