Update Official Business Account Status
Changed onUpdate 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
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Phone-Number-ID}/official_business_account
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
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
The user agent string identifying the client software making the request.
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Request body
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
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
- breaking