Create a new employee

POST

/employees

Creates a new employee in the organization. Admin only.

A random password is auto-generated and hashed

A welcome email is sent with login credentials (if Resend is configured)

The employee can then log in at /auth/employee-login

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "name": "Jane Smith",
    "email": "emp1@org.com",
    "role": "Frontend Engineer",
    "department": "Engineering",
    "skills": [
        "React",
        "TypeScript",
        "Tailwind CSS"
    ],
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/employees' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Jane Smith",
    "email": "emp1@org.com",
    "role": "Frontend Engineer",
    "department": "Engineering",
    "skills": [
        "React",
        "TypeScript",
        "Tailwind CSS"
    ],
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38"
}'

Responses

🟢201

application/json

Employee created successfully

Body

Example

{
    "success": true,
    "data": {
        "id": "cm5emp001",
        "orgId": "cm5abc123def456",
        "name": "Jane Smith",
        "email": "emp1@org.com",
        "role": "Frontend Engineer",
        "department": "Engineering",
        "skills": [
            "React",
            "TypeScript",
            "Tailwind CSS"
        ],
        "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
        "roleType": "EMPLOYEE",
        "isActive": true,
        "createdAt": "2026-02-20T10:30:00.000Z",
        "updatedAt": "2026-02-20T10:30:00.000Z"
    },
    "message": "Employee created successfully"
}

🟠409

🟠400ValidationError

Modified at 2026-02-22 18:59:05

List all employees

Get my profile