Version 5

Updated: Oct 27, 2026

Copy for LLM

Embedded Signup v2 and v3 will be deprecated on October 15, 2026, including their public preview versions. Migrate your integration to v4 before that date to avoid disruption. See Versions for the full upgrade path.

Release date: October 20, 2026.

v5 makes two changes to Embedded Signup. WhatsApp Business app onboarding is on by default, and the session info object uses version 5 instead of version 3. Everything else works as in v4: products come from your Facebook Login for Business configuration.

Overview of v5 changes

	v4	v5
WhatsApp Business app onboarding	Opt in with `featureType: "whatsapp_business_app_onboarding"`	On by default; opt out in `features`
`sessionInfoVersion`	Ignored; always 3	Ignored; always 5
Session info object	`waba_id`	`messaging_account_ids`, `primary_waac_ids`, `is_on_biz_app`

Extras configuration

extras: {
    version: "v5"
}

Opt out of WhatsApp Business app onboarding

extras: {
    version: "v5",
    features: [
      {
        name: "whatsapp_business_app_onboarding",
        enabled: false
      }
    ]
}

The opt-out applies even if you also pass featureType: "whatsapp_business_app_onboarding".

Session info

v5 always returns this object when the flow finishes. sessionInfoVersion is ignored if you pass it. The event is FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING when is_on_biz_app is true, and FINISH when it is false.

{
  "data": {
    "phone_number_id": "<PHONE_NUMBER_ID>",
    "is_on_biz_app": true,
    "messaging_account_ids": ["<MESSAGING_ACCOUNT_ID>"],
    "primary_waac_ids": [],
    "page_ids": [],
    "catalog_ids": [],
    "dataset_ids": [],
    "business_id": "<BUSINESS_PORTFOLIO_ID>",
    "instagram_account_ids": []
  },
  "type": "WA_EMBEDDED_SIGNUP",
  "event": "FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING"
}

Messaging accounts and WhatsApp accounts

The v5 session info uses the new WhatsApp Business account model:

Messaging account: holds templates, billing and webhook subscriptions. Existing WABA IDs are Messaging account IDs, so messaging_account_ids returns the IDs waba_id returned before. See Messaging account.
WhatsApp account (WAAC): holds the business phone number and profile. A primary WAAC can have linked WAACs, and sharing the primary shares the whole set. See WhatsApp account (WAAC).

For how Embedded Signup creates these accounts, see Onboarding changes.

Field	Description
`messaging_account_ids`	Messaging accounts shared with you. Replaces `waba_id`.
`primary_waac_ids`	Primary WhatsApp account (WAAC) IDs. Empty until WhatsApp account IDs are available in the Graph API.
`is_on_biz_app`	`true` when the business onboarded a WhatsApp Business app number.

Cancel and error events are unchanged from session info version 3.