---
title: "Install a wallet unit"
method: POST
path: "/units"
tags: ["WalletUnitLifecycle"]
---

# Install a wallet unit

`POST /units`

Creates the persisted Wallet Unit and wallet-account records used by
later activation, attestation, status, and signing commands. The
request may include remote key references, policy references, and party
binding evidence, but it does not make the Wallet Unit production VALID;
VALID is only reached after the production evidence gate is satisfied.

## Request body

- InstallWalletUnitHttpRequest — unresolved $ref

## Response `201`

Wallet unit installed.

- WalletUnitLifecycleResult — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `409` — unresolved $ref
- `500` — unresolved $ref

---

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