Clients

curl https://intent-weasel-655.eu-west-1.convex.site/api/v1/clients \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "ks70...",
      "name": "Acme Dental",
      "createdBy": "admin",
      "createdAt": "2026-06-08T13:22:08.565Z"
    }
  ]
}

Clients are the workspaces you resell under your brand. The API lets you list them, fetch one, and create new ones.

List clients

Returns every client in your agency, newest first.

GET /clients

curl https://intent-weasel-655.eu-west-1.convex.site/api/v1/clients \
  -H "Authorization: Bearer YOUR_API_KEY"

data

array

Show client

string

The client’s unique id.

name

string

The client’s display name.

createdBy

string

admin (you created it) or self_serve (they signed themselves up).

createdAt

string

ISO 8601 creation timestamp.

{
  "data": [
    {
      "id": "ks70...",
      "name": "Acme Dental",
      "createdBy": "admin",
      "createdAt": "2026-06-08T13:22:08.565Z"
    }
  ]
}

Get a client

GET /clients/{id}

string

required

The client id.

Returns the same shape as one item in the list above, or 404 if the client isn’t in your workspace.

Create a client

Requires the Scale plan (write access).

Creates a new client workspace. Returns the created client with a 201 status.

POST /clients

name

string

required

The client’s name (1–100 characters).

curl -X POST https://intent-weasel-655.eu-west-1.convex.site/api/v1/clients \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Dental" }'

{
  "id": "ks7a...",
  "name": "Acme Dental",
  "createdBy": "admin",
  "createdAt": "2026-07-07T09:00:00.000Z"
}

Your plan’s client limit still applies. If you’ve reached it, the request returns 400 with an invalid_request error explaining the limit.

Agents

Conversations

Getting started

Your brand

Building agents

Chat & embedding

Calendar

API

Billing your clients

Account & billing

Clients

List clients

Get a client

Create a client

​List clients

​Get a client

​Create a client

List clients

Get a client

Create a client