Create a new department

Creates a new department in the company.

Business Rules:

  • name: Required. Maximum 300 characters.
  • type: Required. Must be a valid department type (e.g., DEPARTMENT).
  • externalCode: Required. Maximum 50 characters. Must be unique within the company.
  • description: Optional. Maximum 900 characters.
  • costCenter: Optional. If provided, the cost center must exist in the company.

Validation:

  • All required fields must be provided and not empty.
  • The externalCode must not already exist for another department in the same company.
  • If a costCenter is specified, it must be found by its externalCode.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 300

organization unit name

string
enum
required

organization unit type

Allowed:
string
required
length ≤ 50

organization unit external code

string
required
length ≤ 900

organization unit description

costCenter
object
required
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json