> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a partner solution migration

> Register a Meta intent to move a WhatsApp number from another Multi-partner Solution.
Kapso selects the active destination solution from your project.
Resubmit the same Meta intent with the same inputs to recover the operation ID.




## OpenAPI

````yaml /api/platform/v1/openapi-platform.yaml post /whatsapp/accounts/{waba_id}/partner_solution_migrations
openapi: 3.1.0
info:
  title: Kapso Platform API
  version: 0.2.0
  description: >
    Build WhatsApp messaging into your product. Manage customers, connect phone
    numbers, send broadcasts, and handle conversations.
servers:
  - url: https://api.kapso.ai/platform/v1
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Customers
    description: Manage customer accounts
  - name: Setup Links
    description: WhatsApp onboarding via embedded signup
  - name: Phone Numbers
    description: Connect and manage WhatsApp numbers
  - name: Webhooks
    description: Subscribe to WhatsApp events
  - name: Display Names
    description: Update WhatsApp business display names
  - name: Broadcasts
    description: |
      Send template messages at scale

      **Alpha**: This API is in alpha and subject to change
  - name: Conversations
    description: Manage conversation state
  - name: Media
    description: Upload media files for WhatsApp messaging
  - name: Users
    description: Manage project team members
  - name: Inbox Embeds
    description: Create and manage embeddable inbox access links
  - name: Webhook Deliveries
    description: View webhook delivery attempts and their status
  - name: External API Logs
    description: View logs of external API calls made by the project
  - name: Log Search
    description: Search log events across API, Meta, workflow, and webhook sources
  - name: Events
    description: Emit and query project-scoped events
  - name: Provider Models
    description: List available AI provider models
  - name: WhatsApp Flows
    description: Build interactive WhatsApp Flows for surveys and forms
  - name: Contacts
    description: Manage WhatsApp contacts
  - name: Findings
    description: Detect recurring problems in conversations and investigate them with AI
  - name: Notifications
    description: >-
      Route project alerts to shared inboxes and Slack channels connected from
      the Kapso app
  - name: WhatsApp Migrations
    description: >-
      Add existing accounts to an active Multi-partner Solution or move a number
      between solutions
  - name: WhatsApp Funding
    description: >-
      Read Kapso funding status and recorded messaging and calling usage, and
      stop portfolio funding
  - name: Business Verification
    description: >-
      Send business verification documents to Meta for a customer's business
      portfolio
paths:
  /whatsapp/accounts/{waba_id}/partner_solution_migrations:
    parameters:
      - name: waba_id
        in: path
        required: true
        description: Source Meta WhatsApp Business Account ID.
        schema:
          type: string
          pattern: ^[0-9]{1,30}$
    post:
      tags:
        - WhatsApp Migrations
      summary: Create a partner solution migration
      description: >
        Register a Meta intent to move a WhatsApp number from another
        Multi-partner Solution.

        Kapso selects the active destination solution from your project.

        Resubmit the same Meta intent with the same inputs to recover the
        operation ID.
      operationId: createWhatsappPartnerSolutionMigration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WhatsappPartnerSolutionMigrationRequest'
            examples:
              migrateBetweenSolutions:
                summary: Move a number between solutions
                value:
                  type: migrate_between_solutions
                  migration_intent_id: '123456789012345'
                  business_portfolio_id: '234567890123456'
                  phone_number: '+56912345678'
                  source_business_token: <source Meta business token>
      responses:
        '202':
          description: Migration request accepted. Poll the returned operation ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhatsappPartnerSolutionMigrationResponse'
        '400':
          description: Invalid or missing input.
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          description: The source WABA is unavailable to this project.
        '409':
          description: >-
            Conflicting migration or account state, or the source and
            destination could not be verified.
        '502':
          description: Meta could not verify the migration request.
components:
  schemas:
    WhatsappPartnerSolutionMigrationRequest:
      type: object
      required:
        - type
        - migration_intent_id
        - business_portfolio_id
        - phone_number
      properties:
        type:
          type: string
          enum:
            - migrate_between_solutions
        migration_intent_id:
          type: string
          pattern: ^[0-9]{1,30}$
          description: Intent ID returned by Meta for the destination solution.
        business_portfolio_id:
          type: string
          pattern: ^[0-9]{1,30}$
          description: Meta business portfolio ID of the WABA owner.
        phone_number:
          type: string
          pattern: ^\+[1-9][0-9]{6,14}$
          description: Source number in E.164 format.
          example: '+56912345678'
        source_business_token:
          type: string
          format: password
          writeOnly: true
          description: >-
            Source Meta business token. Required unless Kapso has an eligible
            source connection in your project. Send it from your backend before
            the business removes source access.
        customer_id:
          type: string
          format: uuid
          description: Destination Kapso customer ID. Required with Kapso infrastructure.
    WhatsappPartnerSolutionMigrationResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: object
          required:
            - migration_id
            - type
            - source_waba_id
            - business_portfolio_id
            - status
          properties:
            migration_id:
              type: string
              format: uuid
              description: Kapso migration operation ID. Use this ID to poll the operation.
            type:
              type: string
              enum:
                - migrate_between_solutions
            source_waba_id:
              type: string
            destination_waba_id:
              type:
                - string
                - 'null'
              description: Meta destination WABA ID once verified.
            business_portfolio_id:
              type: string
            migration_intent_id:
              type:
                - string
                - 'null'
              description: Meta intent ID once known.
            phone_number_id:
              type:
                - string
                - 'null'
              description: Meta destination phone number ID once known.
            status:
              type: string
              enum:
                - awaiting_customer_approval
                - preparing_destination
                - awaiting_funding
                - moving_number
                - number_move_unconfirmed
                - configuring_messaging
                - awaiting_tech_provider
                - completed
                - needs_attention
                - failed
                - expired
            funding_status:
              type:
                - string
                - 'null'
              enum:
                - funded
                - pending
                - unknown
                - not_funded
                - revoked
                - null
              description: >-
                Persisted funding evidence for the destination WABA, independent
                of migration status.
            error_kind:
              type:
                - string
                - 'null'
              description: Machine-readable reason for a stopped operation.
            next_action:
              type:
                - string
                - 'null'
              enum:
                - approve_in_meta_business_suite
                - register_number_and_subscribe_app
                - contact_support
                - null
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
  responses:
    UnauthorizedError:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.