/departments

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

post/departments

Request

  • Base URL
    https://subdomain.workable.com/spi/v3
  • URL
    https://subdomain.workable.com/spi/v3/departments
  • Auth
    API key in header Authorization

Path parameters

subdomainstring required

The account subdomain

Request body

namestring required

The name of the new department

parent_idstring

The department identifier of the parent department if it is a top level department

Response

200

idstring
namestring
parent_idstring
sampleboolean

Example response

{
  "id": "3ff4d641",
  "name": "Commercial"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.