getstarted.ae

Create a business entity

POSThttps://api.getstarted.ae/v1/customers/{customerId}/business-entities

Creates an existing company, used as a corporate participant such as a holding-company shareholder.

  • Companies formed through GetStarted get a business entity automatically when they are incorporated.

Path parameters

  • customerIdstringrequired

    ID of the customer, e.g. cus_01J9ZK4R7Q2M8X.

Body parameters

  • legalNamestringrequired

    Registered legal name.

  • entityTypestring

    e.g. PRIVATE_LIMITED_COMPANY, LLC, C_CORPORATION.

  • countryOfIncorporationstringrequired

    ISO 3166-1 alpha-2 country code.

  • registrationNumberstring

    Number issued by the registry the entity is incorporated in.

  • dateOfIncorporationstring (date)

    YYYY-MM-DD.

  • emailstring

    Contact email for the entity.

  • metadataobject

    Up to 20 string key-value pairs for your own use.

Responses

  • 201Created. Returns the object shown in the example.
  • 400unknown_field The body contains a key the endpoint does not accept.
  • 404resource_not_found No customer with that ID exists in this environment.
  • 422invalid_value A value fails type or format validation.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X POST "https://api.getstarted.ae/v1/customers/cus_01J9ZK4R7Q2M8X/business-entities" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "legalName": "Northwind Holdings Ltd",
  "entityType": "PRIVATE_LIMITED_COMPANY",
  "countryOfIncorporation": "GB",
  "registrationNumber": "14820391",
  "dateOfIncorporation": "2023-02-09",
  "email": "legal@northwindlabs.com"
}'
Response · 201
{
  "id": "ent_01J9ZKC5TR8F4K",
  "object": "business_entity",
  "customerId": "cus_01J9ZK4R7Q2M8X",
  "legalName": "Northwind Holdings Ltd",
  "entityType": "PRIVATE_LIMITED_COMPANY",
  "countryOfIncorporation": "GB",
  "registrationNumber": "14820391",
  "dateOfIncorporation": "2023-02-09",
  "email": "legal@northwindlabs.com",
  "createdAt": "2026-09-20T08:22:40Z",
  "updatedAt": "2026-09-20T08:22:40Z"
}