---
title: "Create a new customer"
method: POST
path: "/projects/{projectId}/customers"
tags: ["Customers"]
---

# Create a new customer

`POST /projects/{projectId}/customers`

## Path parameters

- `projectId` string, required

## Request body

- CustomerCreate
  - `displayName` string, required — Human-readable display name for the customer
  - `tenantName` string — The tenant identifier used for multi-tenancy and resource isolation. If not provided, a default value will be used
  - `region` 'eu' | 'us' — Region for the customer's resources.
  - `customerId` string, required — Unique identifier for the customer
  - `isNfr` boolean — Flag indicating if this is a Not-For-Resale (NFR) customer account.

## Response `201`

Customer created successfully

- Customer
  - `displayName` string, required — Human-readable display name for the customer
  - `tenantName` string, required — The tenant identifier used for multi-tenancy and resource isolation.
  - `region` 'eu' | 'us', required — Region for the customer's resources
  - `customerId` string, required — Unique identifier for the customer
  - `isNfr` boolean — Flag indicating if this is a Not-For-Resale (NFR) customer account
  - `createdAt` string, date-time — Timestamp when the customer was created

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Forbidden
- `404` — Not Found
- `409` — The resource has dependents (e.g. children that inherit from it) and cannot be deleted.
- `500` — Internal server error
- `503` — External service unavailable

---

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