partner_solutions Webhook

Field reference for WhatsApp partner_solutions webhooks: Multi-Partner Solution status changes, event and solution_status values, business portfolio entry IDs, and why Dualhook does not subscribe to it.

The partner_solutions field reports status changes of a Multi-Partner Solution, the arrangement in which a Tech Provider or Tech Partner and a Solution Partner jointly onboard business customers. It is a partner-side webhook: it describes the solution itself, not any customer's messages or account.

What partner_solutions Reports

Each event has an event, the solution_id, and the new solution_status.

eventMeaning
SOLUTION_CREATEDA solution was saved as a draft or sent as a request to a partner.
SOLUTION_UPDATEDAn existing solution was updated.
solution_statusMeaning
DRAFTDrafted; no invitation sent to a partner yet.
INITIATEDCreated and the invitation sent, but not yet accepted or rejected.
ACTIVEThe Solution Partner accepted; the solution can be used.
REJECTEDThe Solution Partner rejected the request.
PENDING_DEACTIVATIONThe owner requested deactivation; the partner has not accepted or declined yet.
DEACTIVATEDThe solution is deactivated.

When It Fires

Meta sends it when a solution is saved as a draft, sent to a partner, accepted, rejected, put up for deactivation, or deactivated.

Payload Shape

Unlike most WhatsApp fields, entry[].id is the partner's business portfolio ID, not a WABA ID.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<BUSINESS_PORTFOLIO_ID>",
      "time": 1739321024,
      "changes": [
        {
          "field": "partner_solutions",
          "value": {
            "event": "SOLUTION_CREATED",
            "solution_id": "774485461512159",
            "solution_status": "INITIATED"
          }
        }
      ]
    }
  ]
}

Dualhook Handling

Dualhook subscription: not subscribed. Dualhook's Meta app does not subscribe to partner_solutions, and Dualhook does not offer Multi-Partner Solutions, so this webhook never reaches you through a Dualhook connection. It only matters to the partners that own a solution, on their own Meta app. Meta does not list it among the fields that support Webhook Override.

Customers onboarded through a Multi-Partner Solution see its solution_id in account_update partner events, which carry solution_id and solution_partner_business_ids inside waba_info.

Implementation Notes

  • Route on entry[].id as a business portfolio ID. Do not look it up as a WABA.
  • Track the latest solution_status per solution_id; only ACTIVE solutions can onboard customers.
  • Treat PENDING_DEACTIVATION as still active until DEACTIVATED arrives.

Related

  • Webhook Subscription FieldsReference list of all 22+ WhatsApp Business Platform webhook subscription fields, what each notifies you of, required permissions, payload size limits, retry policy, and IP allowlisting.
  • account_update WebhookField reference for WhatsApp account_update webhooks: WABA lifecycle events, restrictions, partner events, pricing tiers, MM API terms, offboarding, and Dualhook handling.
  • Embedded SignupHow Dualhook uses Meta's Embedded Signup flow to connect WhatsApp Business Accounts via OAuth.
Browse more docsStart Free Trial