POST
/
key-persons
/
{id}
curl --request POST \
  --url http://staging.api.commenda.io/api/v1/key-persons/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "firstName": "Bill",
  "lastName": "Lumbergh",
  "phoneNumber": "+13021234567",
  "email": "yaacov@commenda.io",
  "countryOfNationality": "US",
  "countryOfResidence": "US",
  "dateOfBirth": "1995-10-22",
  "countrySpecificInfo": {
    "IN": {
      "addressProofFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "aadharCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "panCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "hasDigitalSignatureCertificate": true,
      "hasDirectorIdNumber": true,
      "directorIdNumber": "12345678"
    }
  }
}'
{
  "firstName": "Bill",
  "lastName": "Lumbergh",
  "phoneNumber": "+13021234567",
  "email": "yaacov@commenda.io",
  "countryOfNationality": "US",
  "countryOfResidence": "US",
  "dateOfBirth": "1995-10-22",
  "countrySpecificInfo": {
    "IN": {
      "addressProofFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "aadharCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "panCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
      "hasDigitalSignatureCertificate": true,
      "hasDirectorIdNumber": true,
      "directorIdNumber": "12345678"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Unique identifier of the key person.

Body

application/json

Information about a key person associated with a company, potentially linked to incorporation requests or corporations.

​
firstName
string

The first name of the key person.

Example:

"Bill"

​
lastName
string

The last name of the key person.

Example:

"Lumbergh"

​
phoneNumber
string

Phone number in E.164 format.

Example:

"+13021234567"

​
email
string

Email address of the key person.

Example:

"yaacov@commenda.io"

​
countryOfNationality
string

Country of citizenship.

Example:

"US"

​
countryOfResidence
string

Country of tax residence.

Example:

"US"

​
dateOfBirth
string

Date of birth in ISO-8601 format.

Example:

"1995-10-22"

​
countrySpecificInfo
object

Information about the key person required by a specific incorporation jurisdiction.

Response

200
application/json
Key person updated successfully.

Information about a key person associated with a company, potentially linked to incorporation requests or corporations.

​
firstName
string

The first name of the key person.

Example:

"Bill"

​
lastName
string

The last name of the key person.

Example:

"Lumbergh"

​
phoneNumber
string

Phone number in E.164 format.

Example:

"+13021234567"

​
email
string

Email address of the key person.

Example:

"yaacov@commenda.io"

​
countryOfNationality
string

Country of citizenship.

Example:

"US"

​
countryOfResidence
string

Country of tax residence.

Example:

"US"

​
dateOfBirth
string

Date of birth in ISO-8601 format.

Example:

"1995-10-22"

​
countrySpecificInfo
object

Information about the key person required by a specific incorporation jurisdiction.