---
title: "POST /v1/organisations/{organisationId}/units"
method: POST
path: "/v1/organisations/{organisationId}/units"
---

# POST /v1/organisations/{organisationId}/units

`POST /v1/organisations/{organisationId}/units`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-admin-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-admin-functions.azurewebsites.net/api/v1/organisations/{organisationId}/units`
- Auth: none declared

Create an organisation unit.

## Path parameters

- `organisationId` string, uuid, required: Id of the organisation to which the unit will belong to.

## Request body

- object
  - `name` string, required: Name of the organisation unit.
  - `acronym` string, required: Acronym of the organisation unit.

## Response `200`

The organisation unit has been created.

- object
  - `id` string, uuid, required

## Other responses

- `400`: Bad request.
- `401`: The user is not authorized to create an organisation unit.
- `500`: An error occurred while creating the organisation unit.

## Changes

- **2024-11-07** `bf0b42ebdc02`: 1 warning, 1 info
  - removed the optional property `unitId` from the response with the `200` status
  - added the required property `id` to the response with the `200` status

[Operation history](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service/changes/v1/organisations/:organisationId/units/post.md)

---

[API](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service/revisions/97dbf652314e?raw)