---
title: "Add User to WhatsApp Business Account"
method: POST
path: "/{Version}/{WhatsApp-Business-Account-ID}/assigned_users"
tags: ["WhatsApp Business Account Users"]
---

# Add User to WhatsApp Business Account

`POST /{Version}/{WhatsApp-Business-Account-ID}/assigned_users`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{WhatsApp-Business-Account-ID}/assigned_users`
- Auth: HTTP bearer

Add a user to the WhatsApp Business Account with specified permission tasks.
This operation grants the user access to perform specific actions on the account
based on the provided permission tasks.


**Use Cases:**
- Grant user access to WhatsApp Business Account management
- Assign specific permission tasks for granular access control
- Add new team members to WhatsApp Business Account operations
- Configure user permissions for different business roles


**Permission Tasks:**
Different permission tasks grant access to different WhatsApp Business Account features:
- MANAGE: General account management permissions
- DEVELOP: Development and API access permissions
- MANAGE_TEMPLATES: Message template management
- MANAGE_PHONE: Phone number management
- MESSAGING: Send and receive messages
- FULL_CONTROL: Complete access to all account features


**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

## Path parameters

- `Version` string, required
- `WhatsApp-Business-Account-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `user` string, required: User ID of the person to add to the WhatsApp Business Account. This must be a valid Facebook user ID.
  - `tasks` WhatsAppBusinessAccountPermissionTask[], required: Array of permission tasks to grant to the user. These tasks determine what actions the user can perform on the WhatsApp Business Account.

## Response `200`

Successfully added user to WhatsApp Business Account

- SuccessResponse: Generic success response
  - `success` boolean, required: Operation success status

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - WhatsApp Business Account ID or User ID does not exist
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)