---
title: "Create Unit (BETA)"
method: POST
path: "/units"
tags: ["Units"]
---

# Create Unit (BETA)

`POST /units`

This method allows the calling application to create a Banner or a Store/Outlet unit.

## Headers

- `X-EES-AUTH-CLIENT-ID` string, string, required
- `X-EES-AUTH-HASH` string, string, required
- `Accept-Encoding` '' | 'gzip' | 'deflate' | 'gzip,deflate'
- `X-EES-TRANSACTION-ID` string, string
- `X-EES-RETRY` string, string

## Request body

- UnitPostRequestEntity
  - `name` Name, required — unresolved $ref
  - `incomingIdentifier` IncomingIdentifier, required — unresolved $ref
  - `outgoingIdentifier` OutgoingIdentifier — unresolved $ref
  - `type` Type, required — unresolved $ref
  - `status` Status, required — unresolved $ref
  - `tags` Tags — unresolved $ref
  - `parentUnitId` ParentUnitId, required — unresolved $ref
  - `reference` Reference — unresolved $ref
  - `timezones` Timezones — unresolved $ref

## Response `200`

OK.

- UnitPostResponseEntity
  - `id` Id — unresolved $ref
  - `name` Name — unresolved $ref
  - `safeName` SafeName — unresolved $ref
  - `type` Type — unresolved $ref
  - `unitRelations` UnitRelations — unresolved $ref
  - `status` Status — unresolved $ref
  - `reference` Reference — unresolved $ref
  - `tags` Tags — unresolved $ref
  - `incomingIdentifier` IncomingIdentifier — unresolved $ref
  - `outgoingIdentifier` OutgoingIdentifier — unresolved $ref
  - `timezones` Timezones — unresolved $ref

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `405` — Method Not Allowed.
- `429` — Too Many Requests
- `500` — Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.dev/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)