Create a User

Use this endpoint to create a user access and assign it to a permission group in a single step.

POST /v1/users

Create a User

cURL

curl --request POST \
  --url https://identity.sandbox.lerian.net/v1/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]",
  "firstName": "John",
  "lastName": "Doe",
  "password": "Lerian@123456",
  "username": "johndoe",
  "groups": [
    "admin-group",
    "midaz-viewer-group"
  ]
}
'

201

Example

{
  "id": "019c96a0-0c21-71f9-a487-66a1258278a1",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[e-mail]",
  "username": "johndoe",
  "groups": [
    "admin-group",
    "midaz-viewer-group"
  ]
}

Authorizations

Authorization · string · header · required

The authorization token in the 'Bearer ' format.

Body

application/json

Information about the user.

email · string · required

User's email address.

firstName · string · required

User's first name.

lastName · string · required

User's last name.

password · string · required

User's password for authentication.

username · string · required

User's username.

groups · string[]

Array of user role groups IDs. Role groups IDs can be retrieved through the List Groups endpoint.

Response

201

application/json

Indicates that the resource was successfully created and the operation was completed as expected.

The identity details for a user, including basic info and groups.

email · string

User’s email address.

firstName · string

User’s first name.

groups · string[]

List of groups the user belongs to.

id · string

Unique identifier of the user.

lastName · string

User’s last name.

username · string

Unique username.