Create a user

Admin only. Creates a user against an active branch with a hashed password. The role must be admin or pharmacist, the email unique, and no password hash is returned.

POST/api/v1/users

Authorization

AuthorizationBearer token (JWT) · headerrequired

JWT from POST /api/v1/auth/login sent as Authorization Bearer.

Request body

requiredapplication/json

full_namestringrequired

emailstringrequired

passwordstringrequired

rolestringrequired

branch_idstringrequired

phonestring

Responses

201

User created

idstringrequired

branch_idstringrequired

emailstringrequired

full_namestringrequired

phonestringrequired

rolestringrequired

is_activebooleanrequired

last_login_atstring | nullrequired

created_atstringrequired

updated_atstringrequired

branch_namestring | nullrequired

400

A required field is missing or invalid, the branch does not exist or is inactive, or the email is already in use

detailstringrequired

401

Not authenticated

detailstringrequired

403

Caller is not an admin

detailstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Bodyapplication/json

full_namestring*emailstring*passwordstring*rolestring*branch_idstring*phonestring

Request

curl -X POST 'http://localhost:8000/api/v1/users' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "full_name": "string",
  "email": "string",
  "password": "string",
  "role": "string",
  "branch_id": "string",
  "phone": "string"
}'

const response = await fetch("http://localhost:8000/api/v1/users", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"full_name\": \"string\",\n  \"email\": \"string\",\n  \"password\": \"string\",\n  \"role\": \"string\",\n  \"branch_id\": \"string\",\n  \"phone\": \"string\"\n}"
});

import requests

response = requests.post(
    "http://localhost:8000/api/v1/users",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"full_name\": \"string\",\n  \"email\": \"string\",\n  \"password\": \"string\",\n  \"role\": \"string\",\n  \"branch_id\": \"string\",\n  \"phone\": \"string\"\n}",
)

Response

{
  "id": "string",
  "branch_id": "string",
  "email": "string",
  "full_name": "string",
  "phone": "string",
  "role": "string",
  "is_active": true,
  "last_login_at": "string",
  "created_at": "string",
  "updated_at": "string",
  "branch_name": "string"
}

{
  "detail": "string"
}

{
  "detail": "string"
}

{
  "detail": "string"
}