---
title: "Add a Department"
method: POST
path: "/v1/departments"
tags: ["Departments"]
---

# Add a Department

`POST /v1/departments`

Adds a new department record to the system.

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- DepartmentDTO
  - `compId` integer, required — The identifier for company.
  - `departmentName` string, required — The name of the department.
  - `officeId` integer — The identifier for the office.
  - `statusId` integer — The identifier for the status.
  - `parentDepartmentId` integer — The identifier for the parent department.
  - `street1` string — Street address line 1 for the department.
  - `street2` string — Street address line 2 for the department.
  - `city` string — City for the department.
  - `stateProvince` string, required — Province, state, or region for the department.
  - `postalCode` string — ZIP/postal code for the department.
  - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the department country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `geoCode` string — Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address.
  - `departmentPhone` string — Phone number of the branch.
  - `defaultJobOwnerIDs` integer[] — User IDs of the default job owners of the department.
  - `origin` string — The origin of the department.
  - `weekEndDate` string — Week End Date for the department. Allowed values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
  - `payPeriod` string — Pay Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
  - `payCycle` string — Pay Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
  - `billingPeriod` string — Billing Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
  - `billingCycle` string — Billing Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
  - `originRecordId` string — The identifier for the origin of the department from partner database.

## Response `201`

The created department.

- Department
  - `companyExternalId` string, nullable — The unique system-defined identifier for the Company.
  - `companyGuid` string, uuid, nullable — The Back Office unique identifier for the Company, formatted as a UUID.
  - `departmentExternalId` string, nullable — The unique system-defined identifier for the Company Department.
  - `departmentGuid` string, uuid, nullable — The Back Office unique identifier for the Department, formatted as a UUID.
  - `departmentName` string — The name of the company department.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `409` — Operation could not be completed due to conflict.
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/versions/846b33e4e71b/schema)