---
title: "Changes to Create Employer"
method: POST
path: "/v1/employers"
---

# Changes to Create Employer

`POST /v1/employers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 55 revisions.

- **2026-10-16** `a8bcbdf02e33`: 1 warning
- **2026-09-11** `84d0927cff07`: 1 info
- **2025-10-03** `2e0dd34abf24`: 6 breaking, 12 warning

## Changes

- **2026-10-16** `a8bcbdf02e33`: 1 warning
  - removed the optional property `status` from the response with the `201` status
- **2026-09-11** `84d0927cff07`: 1 info
  - added the optional property `status` to the response with the `201` status
- **2025-10-03** `2e0dd34abf24`: 6 breaking, 12 warning
  - the `createdAt` response's property format changed from `date-time` to no format for status `201`
  - removed the required property `address/city` from the response with the `201` status
  - removed the required property `address/state` from the response with the `201` status
  - removed the required property `address/street1` from the response with the `201` status
  - removed the required property `address/zipCode` from the response with the `201` status
  - removed the required property `phones/items/number` from the response with the `201` status
  - removed the request property `billingAddress/city`
  - removed the request property `billingAddress/country`
  - removed the request property `billingAddress/state`
  - removed the request property `billingAddress/street1`
  - removed the request property `billingAddress/street2`
  - removed the request property `billingAddress/zipCode`
  - removed the optional property `address/country` from the response with the `201` status
  - removed the optional property `address/street2` from the response with the `201` status
  - removed the optional property `billingAddress` from the response with the `201` status
  - removed the optional property `checkr` from the response with the `201` status
  - removed the optional property `phones/items/primary` from the response with the `201` status
  - removed the optional property `phones/items/type` from the response with the `201` status

---

[Operation](https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/employers/post.md) - [API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [Page](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/employers/post)