---
title: "Onboard Partners to MM Lite"
method: POST
path: "/{Version}/{Business-ID}/onboard_partners_to_mm_lite"
tags: ["MM Lite Onboarding"]
---

# Onboard Partners to MM Lite

`POST /{Version}/{Business-ID}/onboard_partners_to_mm_lite`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Business-ID}/onboard_partners_to_mm_lite`
- Auth: HTTP bearer

Send a request from the partner to onboard an end business to MM Lite.
This creates a business agreement request and sets OBO mobility intents
on eligible WhatsApp Business Accounts.


**Business Flow:**
1. Validates partner business and app permissions
2. Checks end business eligibility for MM Lite
3. Identifies eligible shared WABAs and OBO WABAs
4. Sets mobility intents on eligible OBO WABAs (BSPs only)
5. Creates business agreement request
6. Returns request ID for tracking


**BSP vs TP Behavior:**
- BSPs (Business Solution Providers): Can create OBO WABAs and set mobility intents
- TPs (Technology Partners): Can only create onboarding requests, no OBO WABA management


**Rate Limiting:**
Subject to business partner integrations use case throttling limits.
Use appropriate retry logic with exponential backoff.


**Idempotency:**
If a pending request already exists between the same partner and end business,
the existing request ID is returned instead of creating a duplicate.

## Path parameters

- `Version` string, required
- `Business-ID` string, required

## Query parameters

- `solution_id` string

## Headers

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

## Response `200`

Successfully created MM Lite onboarding request

- MMLiteOnboardingRequest: MM Lite onboarding request details
  - `request_id` string, required: Unique identifier for the MM Lite onboarding request

## 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 - Business 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

## Changes

- **2025-11-07** (v23) `c7148d5e2aef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meta/apis/whatsapp-business-messaging/changes/:Version/:Business-ID/onboard_partners_to_mm_lite/post.md)

---

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