---
title: "Tenant Create"
method: POST
path: "/admin/tenants"
---

# Tenant Create

`POST /admin/tenants`

## Request

- Base URL: `https://api.nullprint.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nullprint.ai/admin/tenants`
- Auth: none declared

新建客户:账号 + 租户 + owner 走与自助注册相同的 backend._create_owner_account;7 天试用直接调 _grant_trial;
标准套餐录收款走 billing.record_order(订单 / 审计 / 提成同「录入充值」);自定义套餐(仅超管)走
billing.set_subscription 的 custom 规则。客户没有密码 → 返回一次性设置密码链接,可选同时发邮件。

## Request body

- CreateTenantBody
  - `email` string, required
  - `name` string, nullable
  - `mode` 'trial' | 'standard' | 'custom', required
  - `catalog_id` integer, nullable
  - `months` integer, nullable
  - `payment` PaymentPart
    - `amount` union, required
      - number
      - string
    - `currency` string
    - `channel` 'alipay' | 'wechat' | 'bank' | 'usdt' | 'other', required
    - `reference` string, nullable
    - `note` string, nullable
  - `plan_name` string, nullable
  - `profile_limit` integer, nullable
  - `seats` integer, nullable
  - `expires_at` string, nullable
  - `promoter_id` integer, nullable
  - `note` string, nullable
  - `contact` string, nullable
  - `send_email` boolean
  - `lang` 'en' | 'zh'
  - `confirm_self` boolean

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nullprint/apis/nullprint-backend.md) · [All operations](https://skmtc.dev/nullprint/apis/nullprint-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/nullprint/apis/nullprint-backend/revisions/51dfcef9dce2?raw)