> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp access tokens and permissions in Flowella

> The access tokens and permissions behind every WhatsApp Business Platform request, what Flowella holds for you, and what to do when access stops working.

Every request to the WhatsApp Business Platform carries an **access token**, and the **permissions** granted with that token decide what the request can do. A business that calls the API from its own app creates its own token. Software that many businesses connect, such as Flowella, receives a token for each business when that business finishes Meta's sign-up popup. With Flowella, you never create, copy or paste a Meta token.

> [!NOTE]
>
> **In Flowella.** Supported. You grant Flowella four permissions in Meta's popup. Flowella stores the token it receives encrypted, never shows it, and checks every hour that it still works. When the token stops working or is close to expiring, Flowella emails your organisation's owners and admins a link to reconnect. Keys for the [Flowella REST API](https://knowledge.flowella.io/settings/api-keys.md) are separate from Meta's tokens.

## Meta's token types

| Token | Who uses it | How long it lasts |
| - | - | - |
| **System user token** | A business calling the API with its own app, for its own accounts | Long-lived. You choose an expiry when you generate it in **Business settings → System users**. |
| **Business integration system user token** ("business token") | Software companies acting for businesses that connect through Embedded Signup. Each token is scoped to one business. | Long-lived, so automated work doesn't need the business to sign in again |
| **User token** | Developers testing from the App Dashboard or Graph API Explorer | Short. Meta's own guidance is to switch to a system user or business token. |

When you finish the popup, Meta returns a code to Flowella, and Flowella exchanges it for a long-lived token for your business. See [Meta's sign-up popup](https://knowledge.flowella.io/whatsapp/accounts/embedded-signup.md).

## Permissions

Meta gates each endpoint by permission. Flowella asks for all four of these.

| Permission | What Meta needs it for |
| - | - |
| `whatsapp_business_management` | Account details, templates, phone numbers, analytics and account-level webhooks |
| `whatsapp_business_messaging` | Sending any message, and receiving incoming messages and delivery statuses |
| `business_management` | Reading the business portfolio directly, for example its verification status |
| `whatsapp_business_manage_events` | Sending events to Meta, which Flowella uses to report [Click to WhatsApp ad](https://knowledge.flowella.io/campaigns/click-to-whatsapp-ads.md) leads |

For what each permission lets Flowella do, see [The permissions you grant](https://knowledge.flowella.io/whatsapp/accounts/embedded-signup.md#the-permissions-you-grant). Accept every permission Meta lists in the popup. If one is missing, the features that depend on it fail.

Before customers can grant a permission to a software company's app, Meta must have approved that app for **Advanced access** to it through App Review. That is Flowella's responsibility. Your business doesn't need App Review to use Flowella.

## People in your business portfolio

Your colleagues' access to WhatsApp Manager is separate from Flowella's access. Meta now splits each account into a **WhatsApp account** and a **Messaging account**, and you give people access to each one in Meta Business Suite.

1. In [Meta Business Suite](https://business.facebook.com), open your business portfolio's **Settings**.
2. Go to **Accounts → WhatsApp accounts**, select the account, open **People** and select **Add people**.
3. Repeat under **Accounts → Messaging accounts**. Meta Business Suite doesn't copy access from one to the other.

For who can do what inside Flowella, see [Team](https://knowledge.flowella.io/settings/team.md). For the two account types, see [Messaging accounts and WhatsApp accounts](https://knowledge.flowella.io/whatsapp/accounts/whatsapp-business-account.md#messaging-accounts-and-whatsapp-accounts).

## When access stops working

Flowella loses access when its token expires, when Meta revokes it, or when someone removes Flowella's access or a permission in Meta. Flowella can still show WhatsApp as **Connected** while this happens.

| What you see | What it means | What to do |
| - | - | - |
| An email from Flowella asking you to reconnect WhatsApp | Flowella's hourly check found the token no longer works, or will expire soon | [Reconnect the number](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| The banner "WhatsApp needs reconnecting. Template sends are held until the connection is restored." | Flowella is holding template sends until access is back | [Reconnect the number](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md#reconnect-the-number). Flowella then sends what it was holding. |
| Error `190` | The token has expired or been revoked | [Reconnect the number](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| Error `3`, `10` or `200` to `299` | A permission Flowella needs wasn't granted or was removed | In Meta Business Settings, open **Connected apps** and select **Flowella** to see which assets it can reach. Then reconnect and accept every permission. |

> [!WARNING]
>
> Don't remove the number in Flowella to fix a connection. Removing a number deletes its conversations, notes and opt-out list in Flowella.

See [Access and permissions errors](https://knowledge.flowella.io/whatsapp/errors/error-codes.md#access-and-permissions) for the full list.

## Remove Flowella's access

There are two levels, and they do different things.

| Action | Where | What happens |
| - | - | - |
| Stop using one number | **Remove** in **Settings → WhatsApp (Meta)** | Flowella deletes that number's conversations, notes and opt-out list. Flowella's access at Meta stays, and the number stays registered. See [Remove a number](https://knowledge.flowella.io/account/meta-integration.md#remove-a-number). |
| Withdraw Flowella's access completely | Meta Business Settings, **Connected apps**, **Flowella** | Flowella can no longer send or receive on the account. Your conversations and contacts stay in Flowella until you remove the numbers or ask Flowella to delete your data. |

If you are leaving Flowella, keep a copy of anything you need, remove the numbers in Flowella, then withdraw access in Meta. To have the rest of your data deleted, contact [Flowella support](https://flowella.io/support). See [Data retention and deletion](https://knowledge.flowella.io/security/data-security.md#data-retention-and-deletion).

## Related

> [card] [Meta's sign-up popup](https://knowledge.flowella.io/whatsapp/accounts/embedded-signup.md)
>
> Each screen of the popup and the permissions you grant.

> [card] [WhatsApp connection problems](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md)
>
> Signs the connection has dropped, and how to reconnect.

> [card] [Data security](https://knowledge.flowella.io/security/data-security.md)
>
> What Flowella stores and how it is protected.

> [card] [API keys](https://knowledge.flowella.io/settings/api-keys.md)
>
> Keys for the Flowella REST API.

Checked against Meta's documentation on 18 November 2026: [Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens) and [Permissions](https://developers.facebook.com/documentation/business-messaging/whatsapp/permissions).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.