---
title: "Create a user"
method: POST
path: "/users"
tags: ["users"]
---

# Create a user

`POST /users`

Requires **user:create** scope.

## Request body

- UserPost
  - `clientUserId` string — Optional Id specified by API client on user's creation

## Response `200`

Successful User Response

- User
  - `userId` string, required — User Id
  - `clientUserId` string, required — Id specified by API client on user's creation
  - `clientId` string, uuid, required — API client Id that created the user
  - `createdAt` string, date-time, required — The date the user was created
  - `updatedAt` string, date-time, required — The date the user was last updated
  - `scopes` string, required — Scope used when the user was created
  - `managedBy` 'user' | 'client', required — Represents how the user was created. Managed by client means that the api client created the user before hand according our second use case. Managed by user means that the user was created automatically when creating a connection according our first use case
  - `lastAccessed` string, nullable, required — The date the user was last accessed. This property gets updated everytime a token is issued for this user
  - `deletedAt` string, nullable — The date the user was deleted
  - `userType` 'test' | 'demo' | 'live', required — The type of user
  - `clientName` string — Name of the api client that created the user
  - `connectionIds` string[], required — List of connection ids for the user

## Other responses

- `400` — Unsuccessful Response - Bad request - Missing query parameters - Missing body properties
- `401` — Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
- `403` — Unsuccessful Response - Forbidden - Invalid scopes

---

[API](https://skmtc.net/moneyhubenterprise/apis/moneyhub-identity-service.md) · [All operations](https://skmtc.net/moneyhubenterprise/apis/moneyhub-identity-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhubenterprise/moneyhub-identity-service/revisions/8841721f7aae/schema)