---
title: "Create a new user"
method: POST
path: "/companies/{companyId}/users"
tags: ["Users - company level"]
---

# Create a new user

`POST /companies/{companyId}/users`

Creates the user for the `companyId` identified in the path.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Users read and write

## Path parameters

- `companyId` string, required

## Request body

- CreateCompanyUserRequest
  - `accountGroups` string[] — The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user.
  - `associatedMerchantAccounts` string[] — The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts) associated with this user.
  - `email` string, required — The email address of the user.
  - `loginMethod` string — The requested login method for the user. To use SSO, you must already have SSO configured with Adyen before creating the user. Possible values: **Email** or **SSO**
  - `name` Name, required
    - `firstName` string, required — The first name.
    - `lastName` string, required — The last name.
  - `roles` string[] — The list of [roles](https://docs.adyen.com/account/user-roles) for this user.
  - `timeZoneCode` string — The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**.
  - `username` string, required — The user's email address that will be their username. Must be the same as the one in the `email` field.

## Response `200`

OK - the request has succeeded.

- CreateCompanyUserResponse
  - `_links` Links
    - `self` LinksElement, required
      - `href` string
  - `accountGroups` string[] — The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user.
  - `active` boolean — Indicates whether this user is active.
  - `apps` string[] — Set of apps available to this user
  - `associatedMerchantAccounts` string[] — The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts) associated with this user.
  - `email` string, required — The email address of the user.
  - `id` string, required — The unique identifier of the user.
  - `name` Name
    - `firstName` string, required — The first name.
    - `lastName` string, required — The last name.
  - `roles` string[], required — The list of [roles](https://docs.adyen.com/account/user-roles) for this user.
  - `timeZoneCode` string, required — The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**.
  - `username` string, required — The username for this user.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/versions/1089ade06e17/schema)