---
title: "Create an Account User"
method: POST
path: "/platform/api/v1/accounts/{account_id}/account_users"
tags: ["Account Users"]
---

# Create an Account User

`POST /platform/api/v1/accounts/{account_id}/account_users`

## Request

- Base URL: `https://app.chatwoot.com`
- URL: `https://app.chatwoot.com/platform/api/v1/accounts/{account_id}/account_users`
- Auth: one of:
  - HTTP bearer
  - API key in header `api_access_token`

Create an Account User

## Request body

- AccountUserCreateUpdatePayload
  - `user_id` integer, required: The ID of the user
  - `role` string, required: whether user is an administrator or agent

## Response `200`

Success

- object
  - `account_id` integer: The ID of the account
  - `user_id` integer: The ID of the user
  - `role` string: whether user is an administrator or agent

## Other responses

- `401`: Unauthorized

## Changes

- **2026-09-23** `e0345067d3f1`: 1 info
  - the endpoint scheme security `platformAppBearerAuth` was added to the API

[Operation history](https://skmtc.dev/chatwoot/apis/chatwoot-2/changes/platform/api/v1/accounts/:account_id/account_users/post.md)

---

[API](https://skmtc.dev/chatwoot/apis/chatwoot-2.md) - [All operations](https://skmtc.dev/chatwoot/apis/chatwoot-2/llms.txt) - [OpenAPI document](https://skmtc.dev/chatwoot/apis/chatwoot-2/revisions/b05f5314267f?raw)