Customer Departments

Create a new department

Create a new department for the authenticated company.

Returns 201 with the full DepartmentItem on success.

post/v1/partner/customers/{customerId}/departments

Path parameters

customerIdstring uuid required

Customer ID (UUID)

Request body

codestring nullable

Department code (optional)

namestring required

Department name (required)

descriptionstring nullable

Department description (optional)

Example request

{
  "code": "DEPT_99",
  "name": "Global Sales",
  "description": "Internal code: GS-001"
}

Response

Department created successfully

idstring uuid

Department ID (UUID).

codestring nullable

Department code

namestring

Department name

descriptionstring nullable

Department description

createdAtstring date-time

Timestamp when the department was created (ISO 8601)

Example response

{
  "id": "018e3b2a-1c4d-7f8e-9b0a-2d3e4f5a6b7c",
  "code": "DEPT_99",
  "name": "Global Sales",
  "description": "Internal code: GS-001",
  "createdAt": "2026-03-24T10:00:00Z"
}