Create OBO Mobility Intent
Create a new On-Behalf-Of mobility intent for a WhatsApp Business Account. This endpoint allows authorized solution providers to initiate mobility operations on behalf of business accounts, facilitating transfers and handovers between different solution providers.
Use Cases:
- Initiate account mobility process between solution providers
- Request handover of account management
- Schedule mobility operations for future execution
- Coordinate multi-partner solution transitions
Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.
Mobility Process:
- Create mobility intent with appropriate intent type
- System validates mobility eligibility and permissions
- Intent enters PENDING status awaiting approvals
- Partner notifications and approval workflows are triggered
- Upon approval, mobility operation is scheduled or executed
- Status updates are provided throughout the process
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{WABA-ID}/obo_mobility_intent
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
WhatsApp Business Account ID. This ID identifies the WABA for which the OBO mobility intent is being created.
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
{
"solution_id": "2345678901234567",
"intent_type": "INITIATE_TRANSFER",
"target_solution_id": "3456789012345678",
"mobility_reason": "Transferring account management to new solution provider",
"scheduled_execution_time": "2024-12-01T10:00:00Z",
"metadata": {
"partner_approval_id": "approval_123456",
"business_justification": "Business restructuring"
}
}Response
Successfully created OBO mobility intent
Example response
{
"success": true,
"mobility_intent_id": "obo_mobility_123456789",
"status": "PENDING",
"estimated_completion_time": "2024-12-01T12:00:00Z",
"approval_required": true,
"next_steps": [
"Await partner approval",
"Confirm transfer details"
]
}Changes
No recorded changes to this operation across all 5 revisions of this API.