API Reference

Create department

post
https://harvest.greenhouse.io/v3/departments

Create a department in the caller's organization. Supply parent_id (or external_parent_id) to nest the new record under an existing department; omit both to create a top-level department. Set external_id to keep the new Greenhouse department mapped to the matching record in your HRIS or other external system.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 255

Display name of the department. Required.

integer

Id of an existing department to nest the new department under. Omit to create a top-level department. Use parent_id when you already have the Greenhouse id; use external_parent_id to reference the parent by its external id instead.

string
length ≤ 255

Partner-supplied identifier for the new department, typically the matching id from an HRIS or other external system. Use this to keep Greenhouse departments mapped to your source of truth without maintaining a separate id table.

string
length ≤ 255

external_id of an existing parent department to nest the new department under. Useful when you only have external ids on hand; ignored if parent_id is also supplied.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Updated 3 months ago

Did this page help you?
Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?