---
title: "POST /unit"
method: POST
path: "/unit"
tags: ["unit"]
---

# POST /unit

`POST /unit`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/unit`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/unit/post.ts> (a function with typed inputs; its response is checked against the schema)

create a unit

## Query parameters

- `dryRun` boolean

## Request body

- Unit
  - `id` string
  - `version` string
  - `createdDate` integer
  - `description` string
  - `lastModifiedDate` integer
  - `name` string, required
  - `timeUnitAmount` integer

## Response `201`

unit create response

- Unit
  - `id` string
  - `version` string
  - `createdDate` integer
  - `description` string
  - `lastModifiedDate` integer
  - `name` string, required
  - `timeUnitAmount` integer

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - added the new optional `query` request parameter `dryRun`

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/unit/post.md)

---

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