---
title: "Create Business Units"
method: POST
path: "/compliance/v1/companies/{companyId}/businessUnits"
tags: ["Business Unit"]
---

# Create Business Units

`POST /compliance/v1/companies/{companyId}/businessUnits`

> 🚧 Partner Restricted
> All background check API endpoints are restricted to background check providers that have signed a Paylocity technology partnership agreement. [Please reach out to our team](https://www.paylocity.com/contact/partner-form/) if you would like to discuss partnership opportunities.

**Summary Description**

This endpoint inserts businessUnits and their associated status by company ID for a given client

**Use Cases**

- Partner wants to send over one or multiple businessUnits for a client. This can either be when onboarding a new client, or when client wants to add new businessUnits to their company
- Partner wants to make bulk changes to  businessUnits to make them either active or inactive for a client

## Path parameters

- `companyId` string, required

## Headers

- `testMode` boolean
- `Authorization` string, required

## Request body

- AddBusinessUnitRequest — Package Organization request payload.
  - `businessUnits` BusinessUnitDto[], nullable — Array of package businessUnits.
    - `businessUnitId` string, nullable — Business Unit External ID associated with the business unit. This ID is created on the partner side for a specific company. **Allowable Values:** 150 char max
    - `businessUnitName` string, nullable — Business Unit name. **Allowable Values:** 250 char max
    - `isActive` boolean — (Optional, if not provided – TRUE) A Boolean value indicating if the business unit is active. **Allowable Values:** true, false
    - `description` string, nullable — Optional description for the business unit.

## Response `201`

Returns details of the add operation

## Other responses

- `400` — Bad Request Error - Returns the details of the error
- `401` — Unauthorized
- `415` — Unsupported Media Type - Returns the details of the error

---

[API](https://skmtc.net/paylocity/apis/assessments-api.md) · [All operations](https://skmtc.net/paylocity/apis/assessments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/assessments-api/revisions/dd22ab229153/schema)