Skip to main content
POST
/
public
/
company
Create a company
curl --request POST \
  --url https://api.prod.commenda.io/api/v1/public/company \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "founder@example.com",
  "name": "Acme Holdings"
}
'
{
  "companyId": 77
}
Creates a new company for incorporation and entity management workflows. A company is the Commenda account-level container for the customer you are onboarding. It is not the incorporated legal entity itself.
Partner API callers should use Create a customer, which returns customerId for incorporation and Commenda OS calls.
After creating the company, call GET /partner/incorporation/jurisdiction-catalog and GET /partner/incorporation/requirements to choose the incorporation jurisdiction and understand the required data.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
email
string<email>
required

Email address for the new company owner.

Example:

"founder@example.com"

​
name
string

Optional display name used when creating a new company.

Example:

"Acme Holdings"

Response

Company created successfully

​
companyId
integer
required

Internal Commenda company identifier.

Example:

77