WhatsApp accounts and Messaging accounts

• A WhatsApp account (WAAC) holds a single business phone number and represents your business presence on WhatsApp.
• A Messaging account holds your message templates and billing details. Each partner you work with has its own Messaging account.

• The number of message templates a Messaging account can have is determined by its parent business portfolio. If the portfolio is unverified, each Messaging account is limited to 250 message templates. If the portfolio is verified⁠ and at least one of its WhatsApp accounts has a business phone number with an approved display name, each Messaging account can have up to 6,000. See Template limits for details.
• Each business phone number maps to one WhatsApp account. WhatsApp accounts can be linked together into a WhatsApp account hierarchy, letting you manage a collection of phone numbers as a group.
• Meta Business Accounts are initially limited to 2 registered business phone numbers per WhatsApp account hierarchy, but this limit can be increased to up to 20. See Registered Number Limits.
• Meta Business Accounts are initially limited to 20 WhatsApp account hierarchies.
• A WhatsApp account or a Messaging account must belong to only one business portfolio. You cannot have two or more portfolios owning the same account.
• A Messaging account’s time zone and currency cannot be edited once a line of credit has been attached to it. You cannot migrate a Messaging account from one business to another.

1. Go to https://business.facebook.com/⁠ and create a business portfolio, or sign into your existing account and select your existing portfolio if you already have one.
2. Navigate to the Settings (gear icon) > Accounts > WhatsApp accounts panel.
3. Click the blue +Add button and in the dropdown menu select Create a new WhatsApp account.
4. In the window that appears, complete the flow.

1. Go to https://business.facebook.com/⁠ and create a business portfolio, or sign into your existing account and select your existing portfolio if you already have one.
2. Navigate to the Settings (gear icon) > Accounts > Messaging accounts panel.
3. Click the blue +Add button and in the dropdown menu select Create a new Messaging account.
4. In the window that appears, complete the flow.

• Sharing a WhatsApp account gives the partner access to the business phone number it contains. You can share a WhatsApp account with up to five Solution Partners.
• Sharing a Messaging account gives the partner access to the templates and billing details it holds. You can share a Messaging account with up to two partners.

• If you are sharing your account with a Solution Partner (a type of partner who has a credit line), they must share their credit line with you before you will be able to use their app to send messages.
• The partner’s app must have Advanced access for every permission it uses on your accounts:
  • whatsapp_business_management — to access and manage your shared accounts via the API. Without Advanced access for this permission, API calls return error code 200.
  • whatsapp_business_messaging — to send messages from your business phone number and receive incoming message and status webhooks.
  See Permissions and App Review for details.

1. Ask the partner for their business portfolio ID. You will need this ID to complete the remaining steps.
2. Sign into Meta Business Suite⁠. Use the top-left dropdown menu to select the business portfolio if you have multiple portfolios.
3. Navigate to the Settings (gear icon) > Accounts panel, then open the WhatsApp accounts or Messaging accounts panel, depending on which account you are sharing.
4. In the list, select the account you want to share, or click its Details link.
5. In the details overlay that appears to the right (pictured below), click the Assign partner button.
6. In the overlay that appears, enter the partner’s business portfolio ID and use the toggles to define which permissions to grant to the partner, then click the Assign button.
7. If your account is shared with the partner successfully, a Partner added message will appear. Click the Done button to dismiss it.
8. Back in the details overlay, click the Partners tab.
9. In the Partners tab, confirm that the partner’s name appears as a partner with appropriate permissions.
10. Inform the partner that you have successfully shared your account with them (and ask them to share their credit line if appropriate; see note above).

1. Sign into Meta Business Suite⁠. Use the top-left dropdown menu to select the business portfolio if you have multiple portfolios.
2. Navigate to the Settings (gear icon) > Users > Partners panel.
3. In the list of partners, click the name of the partner, or its Details link.
4. In the details overlay that appears to the right (pictured below), click the Assign assets button.
5. In the Assign assets and permissions window that appears, click the WhatsApp accounts or Messaging accounts asset type, depending on which account you are sharing.
6. Check the checkbox next to the account you want to share, then use the toggles to define which permissions to grant to the partner and click the Assign button.
7. If successful, an Assets assigned message will appear. Click the Done button to dismiss the window.
8. Confirm that your account appears in the Assets you assigned tab with appropriate permissions.
9. Inform the partner that you have successfully shared your account with them (and to share their credit line if appropriate; see note above).

curl 'https://graph.facebook.com/v26.0/102290129340398?fields=name,status,currency,country,business_verification_status' \
-H 'Authorization: Bearer EAAJB...'

{
  "name": "Lucky Shrub",
  "status": "ACTIVE",
  "currency": "USD",
  "country": "US",
  "business_verification_status": "verified",
  "id": "102290129340398"
}

1. Sign into Meta Business Suite⁠. Use the top-left dropdown menu to select the business portfolio if you have multiple portfolios.
2. Navigate to the Settings (gear icon) > Accounts > Messaging accounts panel.
3. In the list, select your Messaging account, or click its Details link.
4. In the Summary tab, click the WhatsApp Manager button.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "whatsapp-business-account-id",
      "time": 1604703058,
      "changes": [
        {
          "field": "account_update",
          "value": {
            "phone_number": "16505551111",
            "event": "ACCOUNT_VIOLATION",
            "violation_info": {
              "violation_type": "ALCOHOL"
            }
          }
        }
      ]
    }
  ]
}