---
title: "Create and Configure Tenant (BETA)"
method: POST
path: "/services/units"
tags: ["Units"]
---

# Create and Configure Tenant (BETA)

`POST /services/units`

This method allows the calling application to create a new tenant unit with wallet config, POS Connect config and unit credentials.  
__Warning:__ This API can cause issues if used from within an existing configuration on the platform. Please contact the Eagle Eye implementation teams before using this API.

## 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

- ServicesUnitPostRequestEntity
  - `name` Name, required — unresolved $ref
  - `incomingIdentifier` IncomingIdentifier, required — unresolved $ref
  - `outgoingIdentifier` OutgoingIdentifier — unresolved $ref
  - `tags` Tags — unresolved $ref
  - `reference` Reference — unresolved $ref
  - `timezones` Timezones — unresolved $ref
  - `options` object — Additional options for the created unit.
    - `posConnect` object — Options for the POS Connect configuration for the created unit.
      - `mode` string — The POS Connect configuration template to be added to the created unit.
    - `walletConfig` object — Options for the wallet configuration for the created unit.
      - `mode` string[] — The wallet configuration template to be added to the created unit.

## Response `200`

OK.

- ServicesUnitPostResponseEntity
  - `id` Id — unresolved $ref
  - `name` Name — unresolved $ref
  - `safeName` SafeName — unresolved $ref
  - `type` Type — 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
  - `unitCodeProviders` UnitCodeProviders — unresolved $ref
  - `posConnect` PosConnect — unresolved $ref
  - `security` Security — unresolved $ref
  - `walletConfig` WalletConfig — unresolved $ref

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `405` — Method Not Allowed.
- `429` — Too Many Requests
- `500` — Server Error
- `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)