---
title: "department.create"
method: POST
path: "/department.create"
tags: ["Department & Team"]
---

# department.create

`POST /department.create`

Creates a department.

**Requires the [`organizationWrite`](authentication#permissions-departmentcreate) permission.**

## Request body

- DepartmentCreateRequest
  - `name` string, required — The name of the department or team
  - `externalName` string, nullable — An alternate candidate-facing name for this department that will be used on Ashby job boards
  - `parentId` string, uuid, nullable — The id of the department's parent department
  - `extraData` object, nullable — Key-value pairs for your own use and reference. Keys must be at most 100 characters, values at most 512 characters, and total size less than 1kb.

## Response `200`

Responses from the department.create endpoint

- union
  - DepartmentCreateSuccessResponse
    - `success` true, required
    - `results` Department, required
      - `id` string, required — The department's unique identifier
      - `name` string, required — The name of the department or team
      - `externalName` string, nullable, required — An alternate candidate-facing name for this department that will be used on Ashby job boards
      - `isArchived` boolean, required — Whether the department has been archived
      - `parentId` string, nullable, required — The id of the department's parent department
      - `createdAt` string, required — The timestamp when the department was created
      - `updatedAt` string, required — The timestamp when the department was last updated
      - `extraData` object, nullable, required — Key-value pairs for your own use and reference. Keys must be at most 100 characters, values at most 512 characters, and total size less than 1kb.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

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