Create user

POST

/v1/users

Creates a new user and associates the user with one or more accounts.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Created

Bodyapplication/json

🟠400

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/users' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accounts": [
        1,
        2
    ],
    "name": "Jack Doe",
    "email": "jack.doe@visma.com",
    "city": "Tromsø",
    "country": "NO",
    "street_address": "Stakkevolvegen 41",
    "state": "State",
    "zip": "9000",
    "phone": "+4746404000",
    "password": "YOUR_PASSWORD"
}'

Response Example

201 - response

{
    "data": {
        "id": "98d94657-00f6-428e-a278-1370b35ab67a",
        "name": "Jack Doe",
        "email": "jack.doe@visma.com",
        "address": {
            "city": "Tromsø",
            "country": "NO",
            "street_address": "Stakkevolvegen 41",
            "state": "State",
            "zip": "9000",
            "phone": "+4746404000"
        },
        "created_at": "2021-12-15 11:01:04",
        "updated_at": "2021-12-15 11:01:04",
        "accounts": [
            {
                "id": 40,
                "name": "Account",
                "email": "account@gmail.com",
                "onboarding_token": "YOUR_ONBOARDING_TOKEN",
                "created_at": "2020-07-28 23:21:53",
                "updated_at": "2021-12-13 12:17:09"
            }
        ],
        "is_two_factor_enabled": false
    }
}

Modified at 2026-09-25 07:15:05

List all users

Retrieve user