Employee Enrollment

POST

/employees/upsert

This API creates a new employee record or updates an existing one based on the provided identifier (externalEmployeeId and email).
If the employee already exists, their information is updated. If not, a new record is created.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK

text/plain

Bodytext/plain

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.skillsintelligence.imocha.io/employees/upsert' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data '[
  {
    "email": "string",
    "firstName": "string",
    "lastName": "string",
    "jobCode": "string",
    "employeeHRMSInfo": {
      "externalEmployeeId": "string",
      "department": "string",
      "location": "string",
      "managerEmail": "string",
      "hireDate": "2025-07-31T05:53:20.004Z",
      "exitDate": "2025-07-31T05:53:20.004Z",
      "employmentType": "string",
      "grade": "string",
      "band": "string",
      "customFieldWithValue": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  }
]'

Response Example

{
    "failed": [
        {
            "email": "string",
            "employeeId": 0,
            "errors": "string"
        }
    ],
    "successful": [
        {
            "email": "string",
            "employeeId": 0,
            "errors": "string"
        }
    ]
}

Modified at 2026-06-19 06:44:15

Get Employee Skills by employeeId

Get Employee Certificates