---
title: "Self-Service Tenant + Owner anlegen"
method: POST
path: "/api/onboarding"
tags: ["Tenant"]
---

# Self-Service Tenant + Owner anlegen

`POST /api/onboarding`

## Request

- Base URL: `https://knowmind.de`
- URL: `https://knowmind.de/api/onboarding`
- Auth: API key in cookie `authjs.session-token`

Wird vom Onboarding-Wizard nach dem ersten Magic-Link-Login aufgerufen. Erzeugt Tenant + setzt den eingeloggten User als Owner. Bei Bezahltarif liefert die Antwort eine Stripe-Checkout-URL.

## Request body

- object
  - `slug` string, required
  - `name` string, required
  - `plan` 'free' | 'private' | 'pro' | 'team' | 'business' | 'enterprise', required

## Response `200`

Tenant erzeugt

- object
  - `tenantId` string, uuid
  - `redirectUrl` string

## Other responses

- `402`: Tarif-Pflicht (z. B. bei API-Tarif und Stripe disabled)
- `409`: Slug bereits vergeben, oder Tenant existiert bereits
- `429`: Rate-Limit überschritten

---

[API](https://skmtc.dev/knowmind/apis/knowmind-api.md) · [All operations](https://skmtc.dev/knowmind/apis/knowmind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/knowmind/apis/knowmind-api/revisions/c369431c0e59?raw)