Skip to main content
POST
/
partner
/
customers
Create a customer
curl --request POST \
  --url https://api.prod.commenda.io/api/v1/partner/customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "founder@example.com",
  "name": "Acme Holdings"
}
'
{
  "customer": {
    "id": 77,
    "name": "Acme Holdings",
    "createdAt": "2026-04-20T19:35:00.000Z",
    "updatedAt": "2026-04-20T19:40:00.000Z"
  }
}
Create a customer record that scopes later Partner API calls. Save the returned customer.id. Use it as {customerId} when creating incorporations and when managing reusable Commenda OS resources such as people, business entities, and files. 
curl --request POST \
  --url 'https://api.prod.commenda.io/api/v1/partner/customers' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
    "email": "founder@example.com",
    "name": "Acme Holdings"
  }'

{
  "customer": {
    "id": 77,
    "name": "Acme Holdings",
    "createdAt": "2026-04-20T19:35:00.000Z",
    "updatedAt": "2026-04-20T19:35:00.000Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
email
string<email>
required

Email address for the customer owner.

Example:

"founder@example.com"

​
name
string

Optional display name for the customer record.

Example:

"Acme Holdings"

Response

Customer created successfully

​
customer
object
required