Create User

POST/admin/usersOpen in the API playground →

Info

Create a new admin/system user with specified role. Only system administrators can create users.

Request

Authorizationstringheaderrequired

Bearer <token> - System Admin JWT

Body Parameters

emailstringbodyrequired

Email address for login

passwordstringbodyrequired

Password (min 8 chars, uppercase, lowercase, number, special char)

first_namestringbodyrequired

First name

last_namestringbodyrequired

Last name

phone_numberstringbody

Phone number for notifications

rolestringbodyrequired

User role (see valid roles below)

pep_access_authorizedbooleanbody

Grant access to PEP accounts

---

Valid Roles

Role	Description
system_admin	Full system access
compliance_user	Compliance monitoring
support_user	Customer support
sales_user	Sales operations
audit_user	Audit/reporting access
super_agent	Agent network manager
sub_agent	Field agent

---

Response

successboolean

Whether user was created

user_idstring

New user ID

messagestring

Status message

userobject

Created user details

---

Examples

Request

cURL

curl -X POST "https://demo.api.vultlocal.com/api/v1/admin/users" \
  -H "Authorization: Bearer ADMIN_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@smartpay.sl",
    "password": "SecureP@ss123",
    "first_name": "New",
    "last_name": "User",
    "phone_number": "+23277123456",
    "role": "support_user",
    "pep_access_authorized": false
  }'

Response

201 Created

{
  "success": true,
  "user_id": "123",
  "message": "User created successfully",
  "user": {
    "id": "123",
    "email": "newuser@smartpay.sl",
    "first_name": "New",
    "last_name": "User",
    "role": "support_user",
    "status": "active"
  }
}

409 Conflict

{
  "success": false,
  "error": "User with email already exists",
  "code": "USER_EXISTS"
}

---

Notes

Warning

• Credentials are sent via WhatsApp if phone_number is provided
• Password must meet security requirements
• Only system_admin role can create new users

---

Errors

Status	Code	Description
400	INVALID_REQUEST	Invalid request or weak password
403	FORBIDDEN	Not authorized to create users
409	USER_EXISTS	User with email already exists