> ## Documentation Index
> Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage system users
# Manage System Users
Updated: Nov 14, 2025
Adding your System User to shared WhatsApp Business Accounts allows you to programmatically manage the accounts. On this guide, we go over actions BSPs may need to perform to manage their system users.
For help creating a system user, see [System Users, Create, Retrieve and Update a System User](https://developers.facebook.com/docs/marketing-api/system-users/create-retrieve-update).
For help generating your system user access token, see [System Users, Install Apps and Generate Tokens](https://developers.facebook.com/docs/marketing-api/system-users/install-apps-and-generate-tokens#generate-token).
## Retrieve System User IDs
You can cache the System User IDs for future use.
### Request
```
curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users
?access_token=<SYSTEM_USER_ACCESS_TOKEN>"
```
To find the ID of a business, go to [**Business Manager**](https://business.facebook.com/) > **Business Settings** > **Business Info**. There, you will see information about the business, including the ID.
### Response
```
\{
"data": [\
{\
"id": "1972555232742222",\
"name": "My System User",\
"role": "EMPLOYEE"\
}\
]
}
```
## Add System Users to a WhatsApp Business Account
For this API call, **you need to use the access token of a System User with admin permissions**.
### Request syntax
In the following example, use the ID for the assigned WABA.
```
curl -i -X POST "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/assigned_users
?user=<ASSIGNED_USER_ID>
&tasks=['<ASSIGNED_USERS_TASKS_AND_PERMISSIONS>']
&access_token=<SYSTEM_USER_ACCESS_TOKEN>"
```
To find the ID of a WhatsApp Business Account, go to [**Business Manager**](https://business.facebook.com/) > **Business Settings** > **Accounts** > **WhatsApp Business Accounts**. Find the account you want to use and click on it. A panel opens, with information about the account, including the ID.
For the `<ASSIGNED_USER_ID>`, use the system user ID returned from [your `/<WHATSAPP_BUSINESS_ACCOUNT_ID>/system_users` call](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-system-users#retrieve-system-user-ids).
### Permissions
| Name | Description |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MANAGE` | Provides admin access.
Users can have admin access on a WhatsApp Business Account that is shared with Admin permissions.
Note: If you are a Solution Partner trying to add a user to a WhatsApp Business Account that is shared with you via a [Multi-Partner Solution](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-partner-solutions), then you would need to account for the following scenarios:
If you are not granted `MESSAGING` permission on the solution, then you need to decide which granular tasks you need when adding the user to the shared WhatsApp Business Account: `DEVELOP`, `MANAGE_TEMPLATES`, `MANAGE_PHONE`, `VIEW_COST`, `MANAGE_EXTENSIONS`, `VIEW_PHONE_ASSETS`, `MANAGE_PHONE_ASSETS`, `VIEW_TEMPLATES`, `VIEW_INSIGHTS`, `MANAGE_USERS`, `MANAGE_BILLING`.
In such scenario, also note that `MANAGE_BILLING` is needed for sharing Line of Credit.
MANAGE will only work if you are given full access on the solution i.e. including `MESSAGING`. |
| `DEVELOP` | Provides developer access.
Users can have developer access on a WhatsApp Business Account that is shared with Standard permissions. |
### Response
```
\{
"success": true
}
```
## Retrieve assigned users
You can fetch the assigned users of the WhatsApp Business Account to verify that the user was added. This is not a required step but helps with validation.
### Request syntax
In the following example, use the ID for the assigned WABA.
```
curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/assigned_users
?business=<WHATSAPP_BUSINESS_ACCOUNT_ID>
&access_token=<SYSTEM_USER_ACCESS_TOKEN>"
```
### Response
```
\{
"data": [\
{\
"id": "1972385232742142",\
"name": "Anna Flex",\
"tasks": [\
"MANAGE"\
]\
},\
{\
"id": "1972385232752545",\
"name": "Jasper Brown",\
"tasks": [\
"DEVELOP"\
]\
}\
]
}
```
## See Also
Reference: [WhatsApp Business Account](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
Did you find this page helpful?
ON THIS PAGE
Retrieve System User IDs
Request
Response
Add System Users to a WhatsApp Business Account
Request syntax
Permissions
Response
Retrieve assigned users
Request syntax
Response
See Also
***