getstarted.ae

Register a participant

POSThttps://api.getstarted.ae/v1/incorporations/{incorporationId}/participants

Attaches a person or business entity to the incorporation with one or more roles.

  • Create the person or business entity first through the Entities endpoints, then reference it here.
  • INDIVIDUAL participants take a PERSON resource. CORPORATE participants take a BUSINESS_ENTITY resource.

Path parameters

  • incorporationIdstringrequired

    ID of the incorporation, e.g. inc_01J9ZK7C3VYB5N.

Body parameters

  • participantTypeenumrequired

    INDIVIDUAL or CORPORATE.

  • resourceobjectrequired

    The person or entity taking part.

    • resource.resourceTypeenumrequired

      PERSON or BUSINESS_ENTITY.

    • resource.resourceIdstringrequired

      per_… or ent_… ID.

  • rolesarrayrequired

    At least one role.

    • roles[].roleenumrequired

      DIRECTOR, SHAREHOLDER, SECRETARY, MANAGER, UBO or AUTHORISED_SIGNATORY.

    • roles[].ownershipPercentagenumber

      Required for SHAREHOLDER and UBO. 0–100, up to two decimals.

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 incorporation, person or business entity with that ID exists in this environment.
  • 409participant_exists This resource is already a participant. Update its roles instead.
  • 422role_not_allowed The role is not in the schema's participantRequirements, or the participant type is not allowed for it.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X POST "https://api.getstarted.ae/v1/incorporations/inc_01J9ZK7C3VYB5N/participants" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "participantType": "INDIVIDUAL",
  "resource": {
    "resourceType": "PERSON",
    "resourceId": "per_01J9ZKA1M4HD2T"
  },
  "roles": [
    {
      "role": "DIRECTOR"
    },
    {
      "role": "SHAREHOLDER",
      "ownershipPercentage": 100
    }
  ]
}'
Response · 201
{
  "id": "par_01J9ZKE7LB2H6J",
  "object": "participant",
  "incorporationId": "inc_01J9ZK7C3VYB5N",
  "participantType": "INDIVIDUAL",
  "resource": {
    "resourceType": "PERSON",
    "resourceId": "per_01J9ZKA1M4HD2T"
  },
  "roles": [
    {
      "role": "DIRECTOR"
    },
    {
      "role": "SHAREHOLDER",
      "ownershipPercentage": 100
    }
  ],
  "documents": [],
  "createdAt": "2026-09-20T08:45:18Z",
  "updatedAt": "2026-09-20T08:45:18Z"
}