---
title: "Add a unit (admin)"
method: POST
path: "/api/v1/organizations/{id}/units"
tags: ["Organizations"]
---

# Add a unit (admin)

`POST /api/v1/organizations/{id}/units`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/organizations/{id}/units`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- Unit: Any part of an organization — the same building block at every level, nestable up to 4 deep
  - `name` string, required
  - `kind` 'department' | 'division' | 'office' | 'team' | 'project' | 'client': only a label (client = a bookkeeper's client taxpayer)
  - `parent_id` string
  - `code` string: your cost centre / UACS code

## Response `201`

{ unit }

---

[API](https://skmtc.dev/philforms/apis/philforms-api.md) · [All operations](https://skmtc.dev/philforms/apis/philforms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/philforms/apis/philforms-api/revisions/a43bf313729c?raw)