Create Employee

Register a new employee in your organisation. The employee will be available for policy enrolment.

Endpoint

POST /v1/client/employees

Request

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer YOUR_ACCESS_TOKEN

Body

{
  "employee_id": "EMP001",
  "name": "Ravi Kumar",
  "email": "ravi.kumar@company.com",
  "phone_number": "9876543210",
  "date_of_birth": "1990-04-15",
  "gender": "GENDER_MALE",
  "designation": "Software Engineer",
  "department": "Engineering",
  "date_of_joining": "2022-01-10",
  "address": "123 MG Road, Bengaluru, Karnataka 560001",
  "personal_email": "ravi@personal.com",
  "personal_phone_number": "9123456789",
  "status": "EMPLOYEE_STATUS_ACTIVE"
}

Fields

Field	Type	Required	Description
employee_id	string	Yes	Your internal employee identifier
name	string	Yes	Full name of the employee
email	string	Yes	Official email address (must be a valid email)
phone_number	string	Yes	Official phone number
date_of_birth	string	Yes	Date of birth in YYYY-MM-DD format
gender	string	Yes	GENDER_MALE, GENDER_FEMALE, or GENDER_OTHER
designation	string	No	Job title / designation
department	string	No	Department the employee belongs to
date_of_joining	string	No	Date of joining in YYYY-MM-DD format
address	string	No	Residential address
personal_email	string	No	Personal email address
personal_phone_number	string	No	Personal phone number
status	string	Yes	EMPLOYEE_STATUS_ACTIVE, EMPLOYEE_STATUS_INACTIVE, or EMPLOYEE_STATUS_INACTIVE_ONGOING_CLAIM

Response

Success (200 OK)

{
  "payload": {
    "employee_id": "ba_emp_01jwz3k...",
    "message": "Employee created successfully",
    "success": true
  }
}

Response Fields

Field	Type	Description
employee_id	string	BizzAssure-assigned internal employee ID
message	string	Human-readable result message
success	boolean	true if the employee was created

Error Responses

Validation Error (400 Bad Request)

{
  "type": "VALIDATION_ERROR",
  "title": "Validation Failed",
  "detail": "email: must be a valid email address",
  "instance": "/v1/client/employees"
}

Duplicate Employee (409 Conflict)

{
  "type": "ALREADY_EXISTS",
  "title": "Employee Already Exists",
  "detail": "An employee with the given employee_id already exists for this client",
  "instance": "/v1/client/employees"
}

Unauthorized (401 Unauthorized)

{
  "type": "UNAUTHORIZED",
  "title": "Unauthorized",
  "detail": "Missing or invalid access token",
  "instance": "/v1/client/employees"
}