Hanzo
OpenapiWallet

Opens a named wallet account for the caller's org.

Opens a named wallet account for the caller's org.

POST /v1/wallet/accounts

Addresshttps://api.hanzo.ai/v1/wallet/accounts
MethodPOST
Operationpost_wallet_accounts
AuthAuthorization: Bearer $HANZO_API_KEY

Opens a named wallet account for the caller's org. An account is a GROUPING of wallets, not a key or a balance: wallets are created under one and can be listed by it. The org is stamped by the server from the validated principal, so a request can never open an account in another tenant.

Request

1 field, body application/json (required).

FieldInTypeRequiredDescription
namebodystringName is the account's label.

Response

StatusBodyMeaning
200WalletAccountok

200 body — 4 fields.

FieldInTypeAlwaysDescription
createdAtbodyintegerCreatedAt is when the account was opened, Unix seconds.
idbodystringID is the account id, minted by the server as "acct_" + 24 hex.
namebodystringName is the label given at creation, trimmed and required.
orgbodystringOrg is the tenant that owns the account, stamped from the validated principal rather than taken from the request.

Failure carries the platform error shape — see Errors.

Examples

hanzo wallets accounts create

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page