---
title: "Changes to Add new employer to the existing order"
method: POST
path: "/v1/orders/{id}/employers/"
---

# Changes to Add new employer to the existing order

`POST /v1/orders/{id}/employers/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-08-13** `85556e62dac3` — 1 info
- **2026-07-27** `f7c013875516` — 28 warning, 37 info
- **2026-07-26** `e58688835e25` — 3 breaking, 1 info

## Changes

- **2026-08-13** `85556e62dac3` — 1 info
  - added the optional property `employments/items/employed_in_role` to the response with the `201` status
- **2026-07-27** `f7c013875516` — 28 warning, 37 info
  - the `company_address/city` request property's maxLength was set to `64`
  - the `company_address/state` request property's maxLength was set to `32`
  - the `company_address/street` request property's maxLength was set to `255`
  - the `company_address/zip` request property's maxLength was set to `10`
  - the `company_domain` request property's maxLength was set to `128`
  - the `company_logo` request property's maxLength was set to `512`
  - the `company_mapping_id` request property's maxLength was set to `64`
  - the `company_name` request property's maxLength was set to `128`
  - the `suborder_number` request property's maxLength was set to `512`
  - added the new `C` enum value to the `employments/items/statements/items/basis_of_pay` response property for the response status `201`
  - added the new `account_locked` enum value to the `last_task_status` response property for the response status `201`
  - added the new `config_error` enum value to the `last_task_status` response property for the response status `201`
  - added the new `done` enum value to the `last_task_status` response property for the response status `201`
  - added the new `error` enum value to the `last_task_status` response property for the response status `201`
  - added the new `full_parse` enum value to the `last_task_status` response property for the response status `201`
  - added the new `login` enum value to the `last_task_status` response property for the response status `201`
  - added the new `login_error` enum value to the `last_task_status` response property for the response status `201`
  - added the new `mfa` enum value to the `last_task_status` response property for the response status `201`
  - added the new `mfa_error` enum value to the `last_task_status` response property for the response status `201`
  - added the new `new` enum value to the `last_task_status` response property for the response status `201`
  - added the new `no_data` enum value to the `last_task_status` response property for the response status `201`
  - added the new `not_supported` enum value to the `last_task_status` response property for the response status `201`
  - added the new `parse` enum value to the `last_task_status` response property for the response status `201`
  - added the new `session_expired` enum value to the `last_task_status` response property for the response status `201`
  - added the new `switch_deposit` enum value to the `last_task_status` response property for the response status `201`
  - added the new `unable_to_reset` enum value to the `last_task_status` response property for the response status `201`
  - added the new `unavailable` enum value to the `last_task_status` response property for the response status `201`
  - added the new `undefined` enum value to the `last_task_status` response property for the response status `201`
  - the `employments/items/annual_income_summary/items/bonus` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/commission` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/gross_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/net_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/other_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/overtime` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/annual_income_summary/items/regular` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/bank_accounts/items/deposit_value` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/income` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/pay_rate` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - the `employments/items/profile/ssn` response's property pattern `^(\d{4}|\d{9})$` was added for the status `201`
  - the `employments/items/statements/items/bonus` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `201`
  - …25 more
- **2026-07-26** `e58688835e25` — 3 breaking, 1 info
  - the response property `employments/items/profile/full_name` became nullable for the status `201`
  - the response property `employments/items/profile/ssn` became nullable for the status `201`
  - the response property `provider/id` became nullable for the status `201`
  - added the optional property `last_task_status` to the response with the `201` status

---

[Operation](https://skmtc.dev/truv/apis/truv-api/docs/v1/orders/:id/employers/post.md) · [API](https://skmtc.dev/truv/apis/truv-api.md) · [Page](https://skmtc.dev/truv/apis/truv-api/changes/v1/orders/:id/employers/post)
