# 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](https://docs.polymorfa.com/api/business-profiles/get-own-business-profile?playground=open). The response can include description, address, email, websites, business hours, categories, cover-photo ID, and profile options returned by WhatsApp.

[Update linked business profile](https://docs.polymorfa.com/api/business-profiles/update-linked-business-profile?playground=open) 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](https://docs.polymorfa.com/api/business-profiles/set-business-cover-photo?playground=open) and [Delete business cover photo](https://docs.polymorfa.com/api/business-profiles/delete-business-cover-photo?playground=open) for cover media.

## Linked accounts and eligibility

[Get business linked accounts](https://docs.polymorfa.com/api/business-profiles/get-business-linked-accounts?playground=open) reads linked Facebook, Instagram, advertising, and catalog identities when WhatsApp returns them.

[Get business eligibility](https://docs.polymorfa.com/api/business-profiles/get-business-eligibility?playground=open) 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](https://docs.polymorfa.com/api/business-profiles/get-business-merchant-compliance?playground=open) reads the connected account's legal entity and customer-care contacts. [Update merchant compliance](https://docs.polymorfa.com/api/business-profiles/set-business-merchant-compliance?playground=open) 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:

```bash 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"]
  }'
```

**Graph API:** Meta Cloud API Numbers: Not supported. Linked Devices Numbers: Supported.

For a Linked Devices or simulated number,
[Get business profile](https://docs.polymorfa.com/api/graph/business-profiles/get-business-profile?playground=open)
returns saved fields and
[Update saved business profile](https://docs.polymorfa.com/api/graph/business-profiles/update-saved-business-profile?playground=open)
changes them. A real Meta Cloud API Number receives capability error `131026`
from either method; the request does not read or change its WhatsApp profile.

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

- [Catalogs and commerce](https://docs.polymorfa.com/numbers/catalog)
- [Quick replies](https://docs.polymorfa.com/numbers/quick-replies)
- [Business profiles API reference](https://docs.polymorfa.com/api/business-profiles/get-own-business-profile)
