/departments

POST https://{subdomain}.workable.com/spi/v3/departments

Creates a department in your account. Required scope: w_departments. Accessible with all token types.

Request

An example of the request body:

JSON

{
    "name": "Commercial",
    "parent_id": null
}

Results

Calling the POST /departments endpoint will create a new department and return the newly created department for the account for the account. An example of the response follows:

JSON

{
    "id": "3ff4d641",
    "name": "Commercial",
    "parent_id": null,
    "sample": false
}

Each department will have the following keys:

key	type	description
id	string	The department identifier
name	string	The name of the department
parent_id	string	The department identifier of the parent department or null if it is a top level department
sample	boolean	Indicates whether the department is a sample created department