---
title: "Add tenant to customer account"
method: POST
path: "/accounts/{zrn}/tenants"
tags: ["Customer Accounts (MTA)"]
---

# Add tenant to customer account

`POST /accounts/{zrn}/tenants`

Adds a tenant to an existing customer account

## Path parameters

- `zrn` string, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- AddTenantToCustomerAccountBody
  - `participant_code` string, 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.

## Response `202`

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

- object — Empty JSON object.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)