---
title: "Set Solution Migration Intent"
method: POST
path: "/{Version}/{WABA-ID}/set_solution_migration_intent"
tags: ["Solution Migration"]
---

# Set Solution Migration Intent

`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

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

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Headers

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

## Request body

- SetSolutionMigrationIntentRequest: Request payload for setting solution migration intent
  - `solution_id` string, 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_id` string: Target solution ID for migration (required for certain migration intents)
  - `migration_reason` string: Reason for the migration intent
  - `scheduled_migration_time` string, date-time: Scheduled time for migration execution (ISO 8601 format)

## Response `200`

Successfully set solution migration intent

- SetSolutionMigrationIntentResponse: Response for setting solution migration intent
  - `success` boolean, required: Indicates if the migration intent was set successfully
  - `migration_intent_id` string, required: Unique identifier for the migration intent request
  - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'SCHEDULED': Current status of the migration intent
  - `estimated_completion_time` string, date-time: Estimated completion time for the migration (ISO 8601 format)

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - WABA ID or Solution ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[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)