Multi-Partner Solutions
WhatsApp Business API

Create Multi-Partner Solution

Create a new Multi-Partner Solution that defines permission distribution between a solution owner app and a partner app for WhatsApp Business messaging collaboration.

Permission Logic:

  • Only one partner (owner or partner app) can have MESSAGING permission
  • At least one partner must have MESSAGING permission
  • Both partners automatically receive default solution partner permissions
  • Empty permission arrays indicate no configurable permissions for that partner

Solution Lifecycle:

  • Solutions are created with INITIATED status
  • Require subsequent activation workflow through solution management
  • Can be managed through Partner Dashboard or solution management APIs

Rate Limiting: Standard Graph API rate limits apply with WhatsApp Business Management throttling. Use appropriate retry logic with exponential backoff for rate-limited requests.

Validation:

  • Partner app must be accessible and have proper capabilities
  • Permission combinations are validated against business logic rules
  • Solution names must meet length and content requirements
post/{Version}/{Application-ID}/whatsapp_business_solution

Request

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

Path parameters

Versionstring required

Graph API version to use for this request. Determines API behavior and available features. Use the latest stable version for new integrations.

Application-IDstring required

Your Facebook Application ID that will serve as the solution owner. This application will be the primary owner of the created solution.

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

owner_permissionsWhatsAppBusinessAccountConfigurablePermissionTask[] required

Configurable permissions granted to the solution owner app. Currently supports only MESSAGING permission. Use empty array if owner should not have configurable permissions.

partner_app_idstring required

Facebook Application ID of the partner app that will participate in this solution. Must be a valid application ID accessible to the requesting entity.

partner_permissionsWhatsAppBusinessAccountConfigurablePermissionTask[] required

Configurable permissions granted to the partner app. Currently supports only MESSAGING permission. Use empty array if partner should not have configurable permissions.

solution_namestring required

Human-readable name for the Multi-Partner Solution. Used for identification and management purposes in partner dashboards and solution management interfaces.

Example request

{
  "owner_permissions": [
    "MESSAGING"
  ],
  "partner_app_id": "9876543210987654",
  "partner_permissions": [],
  "solution_name": "E-commerce Integration Solution"
}

Response

Multi-Partner Solution created successfully. The solution is created with INITIATED status and can be managed through subsequent API calls or Partner Dashboard.

solution_idstring required

Unique identifier for the newly created Multi-Partner Solution. Use this ID for subsequent solution management operations.

Example response

{
  "solution_id": "1234567890123456"
}

Changes

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