Skip to main content
POST
/
partner
/
commenda-os
/
customers
/
{customerId}
/
business-entities
/
{businessEntityId}
/
locations
Create a location
curl --request POST \
  --url https://api.prod.commenda.io/api/v1/partner/commenda-os/customers/{customerId}/business-entities/{businessEntityId}/locations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "locationTypes": [
    "REGISTERED_OFFICE_ADDRESS"
  ],
  "address": {
    "addressLine1": "548 Market St",
    "postalCode": "94104",
    "country": "US",
    "addressLine2": "Suite 21045",
    "addressLine3": "<string>",
    "city": "San Francisco",
    "state": "CA"
  },
  "locationName": "Singapore registered office",
  "startDate": "2026-04-27",
  "employeeCount": 12
}
'
{
  "location": {
    "id": "loc_123",
    "businessEntityId": 44,
    "locationTypes": [
      "OPERATIONS"
    ],
    "address": {
      "addressLine1": "548 Market St",
      "postalCode": "94104",
      "country": "US",
      "addressLine2": "Suite 21045",
      "addressLine3": "<string>",
      "city": "San Francisco",
      "state": "CA"
    },
    "createdAt": 1735689600000,
    "updatedAt": 1735776000000,
    "_internalAddressId": 9876,
    "name": "Delaware HQ",
    "startDate": "2025-01-01",
    "employeeCount": 12
  }
}
Create a reusable Commenda OS location for a customer’s business entity. Use this endpoint when an incorporation requires a partner-provided registered office address and the customer does not already have the location in Commenda OS.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
customerId
integer
required

Commenda customer identifier.

​
businessEntityId
integer
required

Commenda business-entity identifier for the specified customer.

Body

application/json

Create a reusable Commenda OS location for a business entity. The businessEntityId is taken from the URL path.

​
locationTypes
string[]
required
Example:
["REGISTERED_OFFICE_ADDRESS"]
​
address
object
required
​
locationName
string

Optional display name. Required by some location types such as registered office and mailing address.

Example:

"Singapore registered office"

​
startDate
string<date>
Example:

"2026-04-27"

​
employeeCount
integer

Employee count for employee work locations.

Example:

12

Response

Location created successfully

​
location
object
required