v1

latestOpenAPI 3.1.02026-07-261770816.7 KB

Users

Bulk update users

Update up to the bulk-endpoint cap of users in a single request. Pass an array of user payloads in data; each entry must include the target id plus the same patchable fields accepted by PATCH /v3/users/{id}. Each row is processed independently and the response reports per-row success or failure. Use for HRIS-driven backfills of employee_id, office/department reassignments, or job title updates across many users.

patch/v3/users/bulk

Request body

callback_urlstring

Optional HTTPS URL Greenhouse will POST to when every row in data has finished. Omit to poll GET /v3/bulk_requests/{bulk_action_uuid} instead.

Response

Accepted

bulk_action_uuidstring

UUID assigned to the new bulk request. Use this with GET /v3/bulk_requests/{bulk_action_uuid} to monitor progress and retrieve per-row results.

statusstring

Initial lifecycle state of the new bulk request, typically building immediately after creation. See the bulk request response schema for the full set of values.

status_urlstring

Relative path that returns the current status of the bulk request. Append this to your Harvest base URL to fetch the latest state.