---
title: "Add items to a job"
method: POST
path: "/v1/eligibility/jobs/{job-id}/items"
tags: ["Jobs"]
---

# Add items to a job

`POST /v1/eligibility/jobs/{job-id}/items`

## Request

- Base URL: `https://api.clients.wellhub.com`
- URL: `https://api.clients.wellhub.com/v1/eligibility/jobs/{job-id}/items`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wellhub/apis/integrations-api/docs/v1/eligibility/jobs/:job-id/items/post.ts> (a function with typed inputs; its response is checked against the schema)

Adds a batch of employee records to an existing draft job. Each item represents a single employee operation (CREATE, UPDATE, or DELETE). A request must contain between 1 and 500 items. The `company_tax_id` and `operation` fields are required per item.

## Path parameters

- `job-id` string, uuid, required

## Request body

- CreateJobItem[]
  - `operation` 'CREATE' | 'UPDATE' | 'DELETE', required: The operation to perform for this employee record.
  - `company_tax_id` string, required: The tax ID of the company this employee belongs to.
  - `email` string: Employee's email address.
  - `full_name` string: Employee's full name.
  - `employee_id` string: Client-defined employee identifier.
  - `national_id` string: Employee's national identifier.
  - `payroll_id` string: Payroll identifier for the employee.
  - `employee_segment` string: Identifies the employee's segment for NR01. Alphanumeric, may include special characters, no length limit.
  - `department` string: Department the employee belongs to.
  - `office_zip_code` string: ZIP code of the employee's office location.
  - `cost_center` string: Cost center associated with the employee.
  - `mobile_number` string: Employee's mobile phone number.
  - `discount_subset_id` string: Identifier for the discount subset applicable to this employee.
  - `eligible_to_payroll` boolean: Whether the employee is eligible for payroll deduction.
  - `custom_fields` object: Optional map of additional custom attributes for the employee. Values are not validated by the platform.

## Response `204`

No Content. All items were successfully added to the job.

## Other responses

- `400`: Bad Request. Possible causes: 1. Invalid `job-id` format. 2. Request body is empty or contains more than 500 items. 3. One or more items failed validation (missing `operation` or `company_tax_id`, invalid `operation` value).
- `401`: Unauthorized. Missing or invalid Bearer token.
- `403`: Forbidden.
- `404`: Not Found. No job found with the given ID.
- `413`: Request Entity Too Large. The request payload exceeds the allowed size limit.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/wellhub/apis/integrations-api.md) - [All operations](https://skmtc.dev/wellhub/apis/integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wellhub/apis/integrations-api/revisions/3e6a46a18a2e?raw)