OBO Mobility Intent

Set OBO Mobility Intent

Set On-Behalf-Of (OBO) mobility intent for a Multi-Partner Solution associated with a WhatsApp Business Account. This endpoint enables solution providers to establish OBO relationships for managing client WhatsApp Business Accounts.

Use Cases:

  • Enable solution provider management of client WABA operations
  • Establish OBO relationships for business messaging solutions
  • Configure cross-platform mobility for WhatsApp Business messaging
  • Set up solution provider access to client accounts
  • Manage client onboarding for solution provider services

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

Caching: OBO mobility intent settings are cached for performance. Changes may take a few minutes to propagate across all systems. Implement appropriate cache invalidation strategies.

post/{Version}/{WABA-ID}/set_obo_mobility_intent

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{WABA-ID}/set_obo_mobility_intent
  • Auth
    HTTP bearer

Path parameters

Versionstring required

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

WABA-IDstring required

Your WhatsApp Business Account ID. This ID can be found in your Business Manager or through the WhatsApp Business Account management APIs.

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

waba_idstring required

WhatsApp Business Account ID for which to set OBO mobility intent

solution_idstring

Unique identifier for the Multi-Partner Solution

app_idstring

Application ID requesting OBO mobility intent

actor_idstring

Actor ID performing the OBO mobility intent operation

client_mutation_idstring

Client-provided mutation identifier for request tracking

Example request

{
  "waba_id": "1234567890123456",
  "solution_id": "2345678901234567",
  "app_id": "3456789012345678",
  "actor_id": "4567890123456789",
  "client_mutation_id": "obo_mobility_intent_mutation_123"
}

Response

Successfully set OBO mobility intent

successboolean required

Indicates if the OBO mobility intent was set successfully

intent_idstring

Unique identifier for the created OBO mobility intent

client_mutation_idstring

Client-provided mutation identifier echoed back

error_msgstring

Error message if the operation failed

Example response

{
  "success": true,
  "intent_id": "obo_intent_987654321",
  "client_mutation_id": "obo_mobility_intent_mutation_123"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.