MEmeta
WhatsApp Business Profile

Update WhatsApp Business Profile

Changed on

Update WhatsApp Business Profile information including business details, contact information, and profile settings.

Use Cases:

  • Update business description and contact information
  • Modify business address and website information
  • Change business vertical classification
  • Update profile picture using Resumable Upload API
  • Update profile picture and about section

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Profile Picture Updates: To update the profile picture, first use the Resumable Upload API to obtain a profile_picture_handle, then include it in the request.

post/{Version}/{Phone-Number-ID}/whatsapp_business_profile

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/whatsapp_business_profile
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Phone-Number-IDstring required

Your WhatsApp Business phone number ID. This ID represents the phone number status entity and can be obtained from your WhatsApp Business Account phone numbers list.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Request body

messaging_product'whatsapp' required

The messaging service used for the request

aboutstring

The text to display in business profile's About section

addressstring

The address of the business

descriptionstring

Description of the business

emailstring email

The contact email address of the business

profile_picture_handlestring

The handle of the profile picture generated from Resumable Upload API

websitesstring[]

URLs associated with the business

vertical'OTHER' | 'AUTO' | 'BEAUTY' | 'APPAREL' | 'EDU' | 'ENTERTAIN' | 'EVENT_PLAN' | 'FINANCE' | 'GROCERY' | 'GOVT' | 'HOTEL' | 'HEALTH' | 'NONPROFIT' | 'PROF_SERVICES' | 'RETAIL' | 'TRAVEL' | 'RESTAURANT' | 'ALCOHOL' | 'ONLINE_GAMBLING' | 'PHYSICAL_GAMBLING' | 'OTC_DRUGS'

The industry type of the business

Example request

{
  "messaging_product": "whatsapp",
  "about": "Welcome to our business! We provide excellent service.",
  "address": "123 Business Street, City, State 12345",
  "description": "We are a leading provider of quality products and services.",
  "email": "contact@business.com",
  "profile_picture_handle": "4:VGVzdC5wbmc=:aW1hZ2UvanBlZw==:ARat4Mt-L09JON3f30SmDkdyPSuyBkDDYiB4TFXuXISjdgHoNp2b7j882_9Jzr2tPrdKxi92UygyVzTivJiOvmebMpZ6MIjTik3gTyI3ZCQAgQ:e:1659995302:2022308451254161:636685196:ARZf1ftR5N6-qSLtklU",
  "websites": [
    "https://www.business.com",
    "https://www.facebook.com/business"
  ],
  "vertical": "RESTAURANT"
}

Response

Successfully updated WhatsApp Business Profile

successboolean

Indicates whether the update was successful

Example response

{
  "success": true
}

Changes

  • v23c7148d5e2aefRevision changes
    • info

      api operation id updateWhatsAppBusinessProfile removed and replaced with updateWhatsAppBusinessProfileInformation