---
title: "Create Multi-Partner Solution"
method: POST
path: "/{Version}/{Application-ID}/whatsapp_business_solution"
tags: ["Multi-Partner Solutions", "WhatsApp Business API"]
---

# Create Multi-Partner Solution

`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

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

## Path parameters

- `Version` string, required
- `Application-ID` string, required

## Headers

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

## Request body

- WhatsAppBusinessSolutionCreateRequest: Request payload for creating a Multi-Partner Solution
  - `owner_permissions` WhatsAppBusinessAccountConfigurablePermissionTask[], 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_id` string, 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_permissions` WhatsAppBusinessAccountConfigurablePermissionTask[], required: Configurable permissions granted to the partner app. Currently supports only MESSAGING permission. Use empty array if partner should not have configurable permissions.
  - `solution_name` string, required: Human-readable name for the Multi-Partner Solution. Used for identification and management purposes in partner dashboards and solution management interfaces.

## Response `200`

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

- WhatsAppBusinessSolutionCreateResponse: Successful response containing the created solution identifier
  - `solution_id` string, required: Unique identifier for the newly created Multi-Partner Solution. Use this ID for subsequent solution management operations.

## Other responses

- `400`: Bad Request - Invalid parameters provided. This includes validation failures for permission logic, malformed IDs, or constraint violations.
- `401`: Unauthorized - Authentication required or invalid access token provided.
- `403`: Forbidden - Insufficient permissions or missing required capabilities. App may lack whatsapp_business_management permission or required granular scopes.
- `404`: Not Found - Application ID not found or not accessible to the requesting entity.
- `422`: Unprocessable Entity - Request is well-formed but contains business logic violations. This includes cases where both partners have MESSAGING permission or neither has it.
- `429`: Too Many Requests - Rate limiting threshold exceeded. Implement exponential backoff retry logic.
- `500`: Internal Server Error - Unexpected server-side error occurred. These errors are typically transient and should be retried.

---

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