---
title: "Update Official Business Account Status"
method: POST
path: "/{Version}/{Phone-Number-ID}/official_business_account"
tags: ["Official Business Account"]
---

# Update Official Business Account Status

`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

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

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- OfficialBusinessAccountUpdateRequest: Request payload for updating Official Business Account status
  - `business_website_url` string, uri, required: Official business website URL
  - `primary_country_of_operation` string, required: Primary country where the business operates
  - `primary_language` string: Primary language used by the business
  - `parent_business_or_brand` string: Parent business or brand name
  - `supporting_links` string[]: Supporting links that demonstrate business notability (minimum 5, maximum 10)
  - `additional_supporting_information` string: Additional information to support the Official Business Account application

## Response `200`

Successfully updated Official Business Account status

- OfficialBusinessAccountUpdateResponse: Response for Official Business Account status update operation
  - `success` boolean, required: Indicates if the operation was successful
  - `message` string, required: Human-readable message describing the result of the operation
  - `updated_status` OfficialBusinessAccountStatus: Official Business Account status information for a WhatsApp Business Account phone number
    - `id` string, required: Unique identifier for the WhatsApp Business Account phone number
    - `oba_status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'UNDER_REVIEW' | 'EXPIRED' | 'CANCELLED', required: Official Business Account appeal and verification status
    - `status_message` string, required: Human-readable message describing the current Official Business Account status
  - `tracking_id` string: Unique identifier for tracking the application/update request

## Other responses

- `400`: Bad Request - Invalid parameters, malformed request, or invalid state transition
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Phone number ID does not exist or is not accessible
- `409`: Conflict - Invalid state transition or conflicting request
- `422`: Unprocessable Entity - Request is valid but cannot be processed due to business rules
- `429`: Too Many Requests - Rate limit exceeded or too many application attempts
- `500`: Internal Server Error - Unexpected server error

## Changes

- **2025-12-30** (v23) `d553bfe46f22`: 2 breaking, 2 warning, 4 info
  - added the new required request property `business_website_url`
  - added the new required request property `primary_country_of_operation`
  - removed the request property `action`
  - removed the request property `application_data`
  - …4 more

[Operation history](https://skmtc.dev/meta/apis/whatsapp-business-messaging/changes/:Version/:Phone-Number-ID/official_business_account/post.md)

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)