Skip to main content
POST
/
partner
/
commenda-os
/
companies
/
{companyId}
/
persons
Create a person
curl --request POST \
  --url https://api.prod.commenda.io/api/v1/partner/commenda-os/companies/{companyId}/persons \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "firstName": "Jane",
  "lastName": "Founder",
  "email": "jane@acme.com",
  "dateOfBirth": "1990-04-18",
  "countryOfCitizenship": "SG"
}
'
{
  "id": 12
}
Create a reusable Commenda OS key person under a partner-accessible company. Use this endpoint when an incorporation participant does not already exist in Commenda OS. After creation, pass the returned id as the participant resource id: 
{
  "participantType": "individual",
  "resource": {
    "resourceType": "keyPerson",
    "resourceId": "12"
  },
  "roles": [{ "role": "director" }]
}
Use incorporation participant and document endpoints for incorporation-specific roles and documents. This endpoint only creates the reusable person record.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
companyId
integer
required

Commenda company identifier accessible to the authenticated partner.

Body

application/json

Create a reusable Commenda OS key person under a partner-accessible company. This uses the same person-create semantics as the internal Commenda OS API, with companyId taken from the URL path.

​
firstName
string
required
Example:

"Jane"

​
lastName
string
Example:

"Founder"

​
email
string<email>
Example:

"jane@acme.com"

​
phoneNumber
string
Example:

"+14155550123"

​
locations
object[]

Person addresses using the same shape as the internal Commenda OS person create API.

​
employmentStartDate
string<date>
Example:

"2025-01-01"

​
dateOfBirth
string<date>
Example:

"1990-04-18"

​
countryOfCitizenship
string
Example:

"SG"

​
ssn
string

SSN or ITIN, when applicable.

Example:

"123-45-6789"

​
hasNoSSN
boolean
Example:

false

​
directorIdentificationNumber
string

Director Identification Number (DIN) assigned to Indian directors.

Example:

"00012345"

Response

Person created successfully

​
id
integer
required

Updated Commenda OS person identifier.

Example:

12