Skip to content

Create New User

POST
/auth/admin/users

Create a new user account. Requires admin or superadmin role. Only superadmin can create superadmin users. Admin-created users are verified by default.

Authorizations

SessionAuth

Session ID for authenticated requests

Type
API Key (header: X-Session-ID)

Request Body

application/json
JSON
{
  
"email": "newuser@example.com",
  
"password": "SecurePass123!",
  
"name": "John",
  
"last_name": "Doe",
  
"user_name": "johndoe",
  
"user_type": "customer",
  
"phone": "+1234567890",
  
"is_verified": true
}

Responses

User created successfully

application/json
JSON
{
  
"success": true,
  
"data": {
  
  
"user": {
  
  
  
"id": "usr_abc123",
  
  
  
"email": "user@example.com",
  
  
  
"name": "John",
  
  
  
"last_name": "Doe",
  
  
  
"user_name": "johndoe",
  
  
  
"user_type": "customer",
  
  
  
"picture": "https://storage.pubflow.com/users/usr_abc123/picture.jpg",
  
  
  
"phone": "+1234567890",
  
  
  
"is_verified": true,
  
  
  
"two_factor": false,
  
  
  
"created_at": "2025-12-07T10:00:00Z",
  
  
  
"updated_at": "2025-12-07T10:00:00Z"
  
  
}
  
}
}

Playground

Server
Authorization
Body

Samples

Powered by VitePress OpenAPI