Create user

POST /api/usuario Creates a new user record. If a Base64-encoded image is provided, it is uploaded to Cloudinary before the record is inserted. The password is hashed with bcrypt (10 salt rounds) before storage.

Request body

string

required

Username for the new account.

number

required

Profile (role) ID. Must reference an existing record in the perfil table.

string

required

Plain-text password. Hashed with bcrypt before being stored — never persisted in plain text.

string

required

Email address. Must be unique across all users.

string

Phone number. Optional — stored as null if omitted.

boolean

default:"true"

Active status of the account. true = active, false = inactive.

string

Base64-encoded image string (must start with data:image). When provided, the image is uploaded to the usuarios_corp Cloudinary folder (resized to a maximum width of 1000 px, quality auto-optimized) and the resulting secure URL is stored as imagenUrl. Omit this field if no image is needed.

Response

boolean

required

true when the user is created successfully.

object

required

The newly created user record as returned by the database.

Show properties

number

Auto-generated primary key.

string

Username.

number

Profile ID.

string

Bcrypt hash of the password.

string

Email address.

string | null

Phone number.

boolean

Active status.

string | null

Cloudinary URL of the uploaded image, or null if no image was provided.

Error responses

Status	Cause
`500`	Cloudinary upload failed, the image payload is too large, or a database constraint was violated (e.g., duplicate `strCorreo`).

strCorreo has a unique constraint in the database. Attempting to create a user with an email that already exists will result in a 500 error from the database driver.

Examples

curl --request POST \
  --url https://your-domain.com/api/usuario \
  --header 'Content-Type: application/json' \
  --cookie 'auth_token=<your-jwt>' \
  --data '{
    "strNombreUsuario": "jdoe",
    "idPerfil": 2,
    "strPwd": "secret123",
    "strCorreo": "jdoe@example.com",
    "strNumeroCelular": "555-9876",
    "idEstadoUsuario": true
  }'

const response = await fetch('/api/usuario', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    strNombreUsuario: 'jdoe',
    idPerfil: 2,
    strPwd: 'secret123',
    strCorreo: 'jdoe@example.com',
    strNumeroCelular: '555-9876',
    idEstadoUsuario: true,
    // imagenBase64: 'data:image/png;base64,...', // optional
  }),
});

const { success, data } = await response.json();

Success response

200

{
  "success": true,
  "data": {
    "id": 12,
    "strNombreUsuario": "jdoe",
    "idPerfil": 2,
    "strPwd": "$2b$10$...",
    "strCorreo": "jdoe@example.com",
    "strNumeroCelular": "555-9876",
    "idEstadoUsuario": true,
    "imagenUrl": null
  }
}

Authentication

Users

Profiles

Modules

Permissions

Request body

Response

Error responses

Examples

Success response

​Request body

​Response

​Error responses

​Examples

​Success response

Request body

Response

Error responses

Examples

Success response