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@olive.sl",
"password": "SecureP@ss123",
"first_name": "New",
"last_name": "User",
"phone_number": "+23277123456",
"role": "support_user",
"pep_access_authorized": false
}'
{
"success": true,
"user_id": "123",
"message": "User created successfully",
"user": {
"id": "123",
"email": "newuser@olive.sl",
"first_name": "New",
"last_name": "User",
"role": "support_user",
"status": "active"
}
}
{
"success": false,
"error": "User with email already exists",
"code": "USER_EXISTS"
}
Admin
Create User
Create a new system user
POST
/
admin
/
users
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@olive.sl",
"password": "SecureP@ss123",
"first_name": "New",
"last_name": "User",
"phone_number": "+23277123456",
"role": "support_user",
"pep_access_authorized": false
}'
{
"success": true,
"user_id": "123",
"message": "User created successfully",
"user": {
"id": "123",
"email": "newuser@olive.sl",
"first_name": "New",
"last_name": "User",
"role": "support_user",
"status": "active"
}
}
{
"success": false,
"error": "User with email already exists",
"code": "USER_EXISTS"
}
Create a new admin/system user with specified role. Only system administrators can create users.
Request
string
required
Bearer <token> - System Admin JWTBody Parameters
string
required
Email address for login
string
required
Password (min 8 chars, uppercase, lowercase, number, special char)
string
required
First name
string
required
Last name
string
Phone number for notifications
string
required
User role (see valid roles below)
boolean
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
boolean
Whether user was created
string
New user ID
string
Status message
object
Created user details
Examples
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@olive.sl",
"password": "SecureP@ss123",
"first_name": "New",
"last_name": "User",
"phone_number": "+23277123456",
"role": "support_user",
"pep_access_authorized": false
}'
{
"success": true,
"user_id": "123",
"message": "User created successfully",
"user": {
"id": "123",
"email": "newuser@olive.sl",
"first_name": "New",
"last_name": "User",
"role": "support_user",
"status": "active"
}
}
{
"success": false,
"error": "User with email already exists",
"code": "USER_EXISTS"
}
Notes
- Credentials are sent via WhatsApp if phone_number is provided
- Password must meet security requirements
- Only
system_adminrole 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 |
Authorizations
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Body
application/json
User details
⌘I