Skip to main content
POST
/
projects
/
{projectId}
/
customers
Create a new customer
curl --request POST \
  --url https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "displayName": "admin",
  "tenantName": "base",
  "region": "eu",
  "customerId": "contosohospital",
  "isNfr": false
}'
{
  "displayName": "admin",
  "tenantName": "base",
  "region": "eu",
  "customerId": "contosohospital",
  "isNfr": false,
  "createdAt": "2023-10-01T12:00:00Z"
}

Authorizations

​
Authorization
string
header
required

JWT access token obtained from the /auth/token endpoint.

This Admin API is separate from the Corti API used for speech recognition, text generation, and agentic workflows. Authentication and scope for the Admin API uses email-and-password to obtain a bearer token via /auth/token. This token is only used for API administration.

Path Parameters

​
projectId
string
required

Unique identifier of your project in the Corti API Console.

To find it, open your project at console.corti.app, go to Settings, and copy the value from the Project ID field.

Example:

"consoleproject"

Body

application/json
​
displayName
string
required

Human-readable display name for the customer

Example:

"admin"

​
customerId
string
required

Unique identifier for the customer

Maximum length: 64
Example:

"contosohospital"

​
tenantName
string

The tenant identifier used for multi-tenancy and resource isolation. If not provided, a default value will be used

Maximum length: 14
Example:

"base"

​
region
enum<string>
default:eu

Region for the customer's resources.

Available options:
eu,
us
Example:

"eu"

​
isNfr
boolean

Flag indicating if this is a Not-For-Resale (NFR) customer account.

Example:

false

Response

Customer created successfully

​
displayName
string
required

Human-readable display name for the customer

Example:

"admin"

​
tenantName
string
default:base
required

The tenant identifier used for multi-tenancy and resource isolation.

Maximum length: 14
Example:

"base"

​
region
enum<string>
default:eu
required

Region for the customer's resources

Available options:
eu,
us
​
customerId
string
required

Unique identifier for the customer

Maximum length: 64
Example:

"contosohospital"

​
isNfr
boolean
default:false

Flag indicating if this is a Not-For-Resale (NFR) customer account

Example:

false

​
createdAt
string<date-time>

Timestamp when the customer was created

Example:

"2023-10-01T12:00:00Z"