post https://{subdomain}.workable.com/spi/v3/departments
Creates a department in your account. Required scope: w_departments. Accessible with all token types.
Log in to see full request history
| time | status | user agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request
An example of the request body:
{
"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:
{
"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 |
Responses