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

# Create Business Units

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

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/compliance/v1/companies/{companyId}/businessUnits`
- Auth: API key in header `Authorization`

> 🚧 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

This endpoint only creates new business units. To change the status of an existing business unit, use the Update Business Unit endpoint (PUT).

## Path parameters

- `companyId` string, required

## Headers

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

## Request body

- AddBusinessUnitRequest: Package Organization request payload.
  - `businessUnits` BusinessUnitDto[], nullable: Array of new business units to create. Business units whose ID or name already exists for the company are rejected with 400 Bad Request; to change the status of an existing business unit, use the Update Business Unit endpoint (PUT).
    - `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 create 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.dev/paylocity/apis/background-check-api.md) - [All operations](https://skmtc.dev/paylocity/apis/background-check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/background-check-api/revisions/8d585de5e05e?raw)