POST/api/users

Criar usuário

Criar usuário

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
acceptOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)

Parâmetros

nameOBRIGATÓRIO
Tipo:string
Nome do usuário
emailOBRIGATÓRIO
Tipo:string
Email do usuário

Este parâmetro representa o endereço de email do usuário que será criado. O email deve ser uma string válida e único no sistema.

Atenção: Caso o email fornecido já exista no sistema, a API retornará um erro 500 Internal Server Error.

passwordOBRIGATÓRIO
Tipo:string
Senha do usuário
phoneOPCIONAL
Tipo:string
Telefone do usuário
rolesIdsOPCIONAL
Tipo:array
IDs dos perfis (roles) do usuário

Este parâmetro representa os IDs dos perfis (roles) que serão associados ao usuário. Deve ser um array de números inteiros.

Observação: Para encontrar os IDs dos perfis, para acessar a página de buscar todas as permissões.

Request URL

https://api-dev.imagemais.com/api/users
curl -X 'POST' \
  'https://api-dev.imagemais.com/api/users' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjExLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NjE2MTM4OSwiZXhwIjoxNzY2MTY0OTg5LCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.hypr7N8OKt-MdNP5vxp1YpSzGju4aKqqoLII_Ofl8Sg' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  "password": "Senha@123",
  "phone": "(81) 98888-7777",
  "rolesIds": [1]
}'
{
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  ...
{
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  "password": "Senha@123",
  "phone": "(81) 98888-7777",
  "rolesIds": [
    1
  ]
}

Respostas

{
  "id": 34,
  "name": "João da Silva",
  ...
{
  "id": 34,
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  "pictureId": null,
  "phone": "(81) 98888-7777",
  "statusId": 1,
  "createdAt": "2025-12-19T16:54:28.208Z",
  "updatedAt": "2025-12-19T16:54:28.208Z",
  "deletedAt": null,
  "lastLogin": null,
  "accountId": 1,
  "status": {
    "id": 1,
    "name": "active"
  },
  "roles": []
}
{
  "id": 47,
  "name": "rutenildo",
  ...
{
  "id": 47,
  "name": "rutenildo",
  "email": "rutinelde.ruti@gmail.com",
  "pictureId": null,
  "phone": "(81) 98888-7777",
  "statusId": 1,
  "createdAt": "2025-12-19T19:01:13.637Z",
  "updatedAt": "2025-12-19T19:01:13.637Z",
  "deletedAt": null,
  "lastLogin": null,
  "accountId": 1,
  "status": {
    "id": 1,
    "name": "active"
  },
  "roles": [
    {
      "id": 1,
      "name": "ADMIN",
      "accountId": 1,
      "createdAt": "2025-04-03T14:18:42.788Z",
      "updatedAt": "2025-12-16T23:04:10.207Z",
      "deletedAt": null
    }
  ]
}
{
  "message": [
    "É necessário pelo menos 1 Grupo de usuário",
  ...
{
  "message": [
    "É necessário pelo menos 1 Grupo de usuário",
    "rolesIds must be an array"
  ]
}
{
  "message": [
    "name should not be empty",
  ...
{
  "message": [
    "name should not be empty",
    "name must be longer than or equal to 5 characters",
    "name must be a string"
  ]
}
{
  "message": [
    "Esse email já está cadastrado",
  ...
{
  "message": [
    "Esse email já está cadastrado",
    "email must be an email",
    "email should not be empty",
    "email must be longer than or equal to 5 characters",
    "email must be a string"
  ]
}
{
  "message": [
    "password is not strong enough",
  ...
{
  "message": [
    "password is not strong enough",
    "password should not be empty",
    "password must be longer than or equal to 8 characters",
    "password must be a string"
  ]
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}