APIMatic Adyen APIs
Sign Up to APIMatic
HomeSDKsAPI ReferenceContext Plugin
ManagementUsersUsers merchant level

Create a new user

POST
/merchants/{merchantId}/users

Creates a user for the merchantId specified in the path.

To make this request, your API credential must have the following role:

  • Management API—Users read and write

Authorization

AuthorizationBasic <token>

In: header

Path Parameters

merchantId*string

Unique identifier of the merchant.

Request Body

application/json

accountGroups?array<string>

The list of account groups associated with this user.

email*string

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: Username & account, Email, or SSO

name*

The user's full name.

Allowed length: 1—80 characters.

Length1 <= length <= 80
roles?array<string>

The list of roles for this user.

timeZoneCode?string

The tz database name of the time zone of the user. For example, Europe/Amsterdam.

username*string

The user's email address that will be their username. Must be the same as the one in the email field.

Length1 <= length <= 255

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/merchants/string/users" \  -H "Content-Type: application/json" \  -d '{    "name": {      "firstName": "John",      "lastName": "Smith"    },    "username": "johnsmith",    "email": "john.smith@example.com",    "loginMethod": "Email",    "timeZoneCode": "Europe/Amsterdam",    "roles": [      "Merchant standard role"    ]  }'

Example response after creating a user on the merchant level

{  "id": "S2-3B3C3C3B22",  "name": {    "firstName": "John",    "lastName": "Smith"  },  "email": "john.smith@example.com",  "timeZoneCode": "Europe/Amsterdam",  "username": "johnsmith",  "roles": [    "Merchant standard role"  ],  "active": true,  "_links": {    "self": {      "href": "https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT/users/S2-3B3C3C3B22"    }  }}

Get a list of users GET

Returns a list of users associated with the `merchantId` specified 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

Get user details GET

Returns user details for the `userId` and the `merchantId` specified 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