> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Falasefemi2/companyflow/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Employee
> Create a new employee in a company
## Authentication
This endpoint requires Bearer token authentication with one of the following roles:
* `super_admin`
* `hr_manager`
## Path Parameters
The unique identifier of the company (UUID format)
## Request Body
Employee email address (must be valid email format)
Employee password (minimum 8 characters)
Employee phone number
Employee first name
Employee last name
Employee date of birth (format: YYYY-MM-DD)
Internal employee code/ID (e.g., EMP001)
Department UUID
Designation UUID
Level UUID
Role UUID
Manager UUID (optional)
Employee status. Must be one of:
* `active`
* `inactive`
* `on_leave`
* `terminated`
* `probation`
Employment type. Must be one of:
* `full_time`
* `part_time`
* `contract`
* `intern`
Employee hire date (format: YYYY-MM-DD)
Employee gender (optional)
Employee address (optional)
Emergency contact name (optional)
Emergency contact phone number (optional)
Profile image URL (optional)
## Response
Indicates if the request was successful
Employee UUID
Company UUID
Employee email address
Employee phone number
Employee first name
Employee last name
Internal employee code
Department UUID
Designation UUID
Level UUID
Role UUID
Manager UUID
Employee status
Employment type
Date of birth (ISO 8601 format)
Hire date (ISO 8601 format)
Termination date (ISO 8601 format)
Employee gender
Employee address
Emergency contact name
Emergency contact phone
Profile image URL
Last login timestamp (ISO 8601 format)
Creation timestamp (ISO 8601 format)
Last update timestamp (ISO 8601 format)
```bash cURL theme={null}
curl -X POST https://api.companyflow.com/companies/123e4567-e89b-12d3-a456-426614174000/employees \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "john.doe@example.com",
"password": "SecurePass123",
"phone": "+1234567890",
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"employee_code": "EMP001",
"department_id": "dept-uuid-here",
"designation_id": "desig-uuid-here",
"level_id": "level-uuid-here",
"role_id": "role-uuid-here",
"manager_id": "manager-uuid-here",
"status": "active",
"employment_type": "full_time",
"hire_date": "2024-01-01",
"gender": "Male",
"address": "123 Main St, City, State",
"emergency_contact_name": "Jane Doe",
"emergency_contact_phone": "+1987654321"
}'
```
```json 201 Success theme={null}
{
"success": true,
"data": {
"id": "emp-uuid-here",
"company_id": "123e4567-e89b-12d3-a456-426614174000",
"email": "john.doe@example.com",
"phone": "+1234567890",
"first_name": "John",
"last_name": "Doe",
"employee_code": "EMP001",
"department_id": "dept-uuid-here",
"designation_id": "desig-uuid-here",
"level_id": "level-uuid-here",
"role_id": "role-uuid-here",
"manager_id": "manager-uuid-here",
"status": "active",
"employment_type": "full_time",
"date_of_birth": "1990-01-15T00:00:00Z",
"hire_date": "2024-01-01T00:00:00Z",
"termination_date": null,
"gender": "Male",
"address": "123 Main St, City, State",
"emergency_contact_name": "Jane Doe",
"emergency_contact_phone": "+1987654321",
"profile_image_url": "",
"last_login_at": null,
"created_at": "2024-03-03T10:00:00Z",
"updated_at": "2024-03-03T10:00:00Z"
}
}
```
```json 400 Bad Request theme={null}
{
"success": false,
"message": "invalid request body"
}
```
```json 401 Unauthorized theme={null}
{
"success": false,
"message": "insufficient role"
}
```