Skip to main content
POST
/
projects
/
{projectId}
/
customers
/
{customerId}
/
users
Create a new user and add it to the customer
curl --request POST \
  --url https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers/{customerId}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "password": "My$ecureP@ssw0rd123!"
}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "emailVerified": true,
  "enabled": true,
  "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"

​
customerId
string
required

The unique identifier for a Customer

Example:

"contosohospital"

Body

application/json
​
email
string<email>
required

User's email address

Example:

"user@example.com"

​
firstName
string
required

User's first name

Example:

"John"

​
lastName
string
required

User's last name

Example:

"Doe"

​
password
string

User's initial password.

Required string length: 16 - 64
Example:

"My$ecureP@ssw0rd123!"

Response

User created successfully

​
email
string<email>
required

User's email address

Example:

"user@example.com"

​
firstName
string
required

User's first name

Example:

"John"

​
lastName
string
required

User's last name

Example:

"Doe"

​
enabled
boolean
default:true
required

Flag indicating if the user account is active

Example:

true

​
id
string<uuid>

Unique identifier for the user

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
emailVerified
boolean
default:false

Flag indicating whether the user's email address has been verified

Example:

true

​
createdAt
string<date-time>

Timestamp when the user was created

Example:

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