Getting Started
Create a Customer & Instance
Create your first customer and instance using the dashboard or the REST API.
Create Your First Customer & Instance
In Kaiten, Customers represent your end clients, and Instances represent deployments of your product for each customer.
1. Create a Customer
- Navigate to Customers in the sidebar
- Click New Customer
- Fill in:
- Name:
My Restaurant - Slug:
my-restaurant(auto-generated from name) - External Customer ID (optional): your CRM reference
- Name:
- Click Create
curl -X POST http://localhost:6000/api/customers \
-H "Authorization: Bearer <your-token>" \
-H "Content-Type: application/json" \
-d '{
"name": "My Restaurant",
"slug": "my-restaurant"
}'Response:
{
"id": "uuid-...",
"name": "My Restaurant",
"slug": "my-restaurant",
"createdAt": "2025-01-01T00:00:00Z"
}2. Create an Instance
Each customer can have one or more instances. An instance must be linked to a License (which defines what the customer can use).
- Click on your customer My Restaurant
- Go to the Instances tab
- Click New Instance
- Fill in:
- Name:
My Restaurant Production - Slug:
my-restaurant-production - Description:
Production environment - License: Select one (e.g. "Starter" from the demo data)
- Name:
- Click Create
curl -X POST http://localhost:6000/api/instances \
-H "Authorization: Bearer <your-token>" \
-H "Content-Type: application/json" \
-d '{
"name": "My Restaurant Production",
"slug": "my-restaurant-production",
"description": "Production environment",
"customerId": "<customer-id>",
"licenseId": "<license-id>"
}'The Core Chain
You've just built the fundamental Kaiten hierarchy:
Organization (your workspace)
└── Customer: "My Restaurant"
└── Instance: "My Restaurant Production"
└── License: "Starter" (defines entitlements & limits)Every operation in Kaiten — feature flag evaluation, entitlement usage tracking, webhook events — is scoped to this chain.