---
title: "/employers/{employerId}/departments"
method: POST
path: "/employers/{employerId}/departments"
---

# /employers/{employerId}/departments

`POST /employers/{employerId}/departments`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/employers/{employerId}/departments`
- Auth: HTTP basic

Use this endpoint to create a new Department in the current context.

Accepts a standard Department object with no read-only values specified. The `name` of the department must be unique to the Employer, and if supplied, the `parentDepartmentId` must already exist for the specified Employer.

In the example below, we’re creating a Department called *Human Resources* which is a child of `parentDepartmentId 135`.


If successful, the endpoint responds with HTTP Status Code `201 Created` and a Department object with `departmentId` populated with the integer ID of the created Department in the response body. It also sets the **Location** header to the [location](ref:departmentsdepartmentid) of the Department.

If the specified Employer does not exist, this endpoint will return an error with HTTP Status Code `404 Not Found`.

## Path parameters

- `employerId` integer, required

## Request body

- object
  - `name` string
  - `parentDepartmentId` string

## Response `201`

201

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/employers/:employerId/departments/post.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)