---
title: "Create Employer"
method: POST
path: "/v1/employers"
tags: ["Employers"]
---

# Create Employer

`POST /v1/employers`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/employers`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/employers/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `name` string, required
  - `address` object, required
    - `street1` string, required
    - `street2` string
    - `city` string, required
    - `state` string, required
    - `zipCode` string, required
    - `country` string
  - `billingAddress` object
  - `phones` object[], required
    - `number` string, required
    - `type` string
    - `primary` boolean
  - `website` string
  - `email` string, email, required
  - `onsiteClinic` boolean
  - `demo` boolean
  - `employeeConsent` boolean
  - `checkr` object
    - `id` string, required
    - `status` string
  - `metadata` object

## Response `201`

Default Response

- object
  - `_id` string, required
  - `name` string, required
  - `address` object, required
  - `phones` object[], required
  - `email` string, required
  - `website` string
  - `onsiteClinic` boolean
  - `demo` boolean
  - `employeeConsent` boolean
  - `createdAt` string
  - `createdBy` string

## Other responses

- `400`: Default Response
- `401`: Default Response
- `500`: Default Response

## 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
  - …14 more

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

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)