WhatsApp Business Account Users

Add User to WhatsApp Business Account

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.

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

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

WhatsApp-Business-Account-IDstring required

Your WhatsApp Business Account ID. This ID is provided when you create the account and can be found in your Business Manager or through account management APIs.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body application/x-www-form-urlencoded

userstring required

User ID of the person to add to the WhatsApp Business Account. This must be a valid Facebook user ID.

tasksWhatsAppBusinessAccountPermissionTask[] required

Array of permission tasks to grant to the user. These tasks determine what actions the user can perform on the WhatsApp Business Account.

Example request

{
  "user": "2345678901234567",
  "tasks": [
    "MANAGE",
    "DEVELOP",
    "MANAGE_TEMPLATES"
  ]
}

Response

Successfully added user to WhatsApp Business Account

successboolean required

Operation success status

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 5 revisions of this API.