getstarted.ae

Create an incorporation

POSThttps://api.getstarted.ae/v1/incorporations

Opens a draft incorporation for a customer in one jurisdiction. Nothing is filed until you submit.

Body parameters

  • customerIdstringrequired

    The customer the company is being formed for.

  • jurisdictionstringrequired

    Jurisdiction code from the catalog.

  • typestringrequired

    Incorporation type from the catalog.

  • requirementsobject

    Optional initial intake values. Same rules as PATCH intake.

  • 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.
  • 422type_unavailable The type is listed in the catalog but not yet open.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X POST "https://api.getstarted.ae/v1/incorporations" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customerId": "cus_01J9ZK4R7Q2M8X",
  "jurisdiction": "SG",
  "type": "PRIVATE_LIMITED_COMPANY",
  "metadata": {
    "internalRef": "NW-SG-01"
  }
}'
Response · 201
{
  "id": "inc_01J9ZK7C3VYB5N",
  "object": "incorporation",
  "customerId": "cus_01J9ZK4R7Q2M8X",
  "jurisdiction": "SG",
  "type": "PRIVATE_LIMITED_COMPANY",
  "status": "DRAFT",
  "stage": "draft",
  "requirementsVersion": "2026-09-01",
  "requirements": {},
  "businessEntityId": null,
  "submittedAt": null,
  "completedAt": null,
  "metadata": {
    "internalRef": "NW-SG-01"
  },
  "livemode": false,
  "createdAt": "2026-09-20T08:31:57Z",
  "updatedAt": "2026-09-20T08:31:57Z"
}