Official Business Account

Update Official Business Account Status

Changed on

Update or modify the Official Business Account (OBA) status for a WhatsApp Business Account phone number. This endpoint allows businesses to submit new applications, withdraw existing applications, or resubmit after addressing rejection reasons.

Use Cases:

  • Submit initial Official Business Account application
  • Withdraw pending OBA application
  • Resubmit OBA application after addressing rejection feedback
  • Update application data for pending applications

Application Data Requirements: When submitting or resubmitting an OBA application, certain business information may be required depending on the current status and previous submissions.

Rate Limiting: Standard Graph API rate limits apply with additional restrictions on application submissions to prevent abuse. Use appropriate retry logic with exponential backoff.

Status Transitions:

  • Applications can only be submitted when no active application exists
  • Withdrawals are only allowed for pending applications
  • Resubmissions are only allowed after rejection
post/{Version}/{Phone-Number-ID}/official_business_account

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/official_business_account
  • 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.

Request body

business_website_urlstring uri required

Official business website URL

primary_country_of_operationstring required

Primary country where the business operates

primary_languagestring

Primary language used by the business

parent_business_or_brandstring

Parent business or brand name

supporting_linksstring[]

Supporting links that demonstrate business notability (minimum 5, maximum 10)

additional_supporting_informationstring

Additional information to support the Official Business Account application

Example request

{
  "business_website_url": "https://www.meta.com",
  "primary_country_of_operation": "US",
  "primary_language": "en_US",
  "parent_business_or_brand": "Acme Corporation Ltd",
  "supporting_links": [
    "https://www.example.com/press1",
    "https://www.example.com/press2",
    "https://www.example.com/press3",
    "https://www.example.com/press4",
    "https://www.example.com/press5"
  ],
  "additional_supporting_information": "Leading provider of innovative business solutions"
}

Response

Successfully updated Official Business Account status

successboolean required

Indicates if the operation was successful

messagestring required

Human-readable message describing the result of the operation

tracking_idstring

Unique identifier for tracking the application/update request

Example response

{
  "success": true,
  "message": "Official Business Account application submitted successfully",
  "updated_status": {
    "id": "1234567890123456",
    "oba_status": "PENDING",
    "status_message": "Your Official Business Account application is under review"
  },
  "tracking_id": "oba_req_1234567890abcdef"
}

Changes

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property