MEmeta
Solution Migration

Set Solution Migration Intent

Set migration intent for a Multi-Partner Solution associated with a WhatsApp Business Account. This endpoint allows solution partners to initiate, schedule, confirm, or cancel migration processes for their solutions.

Use Cases:

  • Initiate migration process for solution transitions
  • Schedule migration for a specific time
  • Confirm pending migration requests
  • Cancel previously set migration intents

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

Migration Process:

  1. Set migration intent with INITIATE_MIGRATION
  2. System validates migration eligibility
  3. Migration intent enters PENDING status
  4. Partner can schedule or confirm migration
  5. Migration executes at scheduled time or immediately upon confirmation
post/{Version}/{WABA-ID}/set_solution_migration_intent

Request

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

WhatsApp Business Account ID. This ID identifies the WABA for which the solution migration intent is being set.

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

solution_idstring required

Unique identifier for the Multi-Partner Solution

migration_intent'INITIATE_MIGRATION' | 'CANCEL_MIGRATION' | 'CONFIRM_MIGRATION' | 'SCHEDULE_MIGRATION' required

Intent for solution migration

target_solution_idstring

Target solution ID for migration (required for certain migration intents)

migration_reasonstring

Reason for the migration intent

scheduled_migration_timestring date-time

Scheduled time for migration execution (ISO 8601 format)

Example request

{
  "solution_id": "1234567890123456",
  "migration_intent": "INITIATE_MIGRATION",
  "target_solution_id": "2345678901234567",
  "migration_reason": "Migrating to new solution provider for enhanced features",
  "scheduled_migration_time": "2024-12-01T10:00:00Z"
}

Response

Successfully set solution migration intent

successboolean required

Indicates if the migration intent was set successfully

migration_intent_idstring required

Unique identifier for the migration intent request

status'PENDING' | 'APPROVED' | 'REJECTED' | 'SCHEDULED'

Current status of the migration intent

estimated_completion_timestring date-time

Estimated completion time for the migration (ISO 8601 format)

Example response

{
  "success": true,
  "migration_intent_id": "migration_intent_123456789",
  "status": "PENDING",
  "estimated_completion_time": "2024-12-01T12:00:00Z"
}

Changes

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