v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Customer Accounts (MTA)

Add tenant to customer account

Adds a tenant to an existing customer account

post/accounts/{zrn}/tenants

Path parameters

zrnstring required

The ZRN of the customer account to add tenant to. The ZRN must be in the format: zrn:zh:eu:account:customer:<uuid>

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required

Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

participant_codestring required

Tenants are the second owners of the account and have the same permissions as the primary account holder. Each tenant must be an onboarded participant to zerohash and not the same as the primary account holder.

Example request

{
  "participant_code": "PART01"
}

Response

Request to add the tenant to the customer account accepted. The change is applied asynchronously.

object required

Empty JSON object.