Create Organisation

/organisations

Creates a new organisation.

Request parameters

{
  "name": "Acme Inc.",
  "status": "ACTIVE",
  "features": [
    [
      "CHAT",
      "MEDIPLAN"
    ]
  ],
  "metadata": {
    "title": "Welcome to your benefits page",
    "schema": "light",
    "setupStage": null,
    "billingContactEmail": "billing@acme.com"
  },
  "initialAdminEmail": "jane.doe@ajg.com"
}

Responses

{
  "id": "019e4c12-0e1b-7bca-97ed-7f64a5a267f9",
  "name": "Acme Inc.",
  "status": "ACTIVE",
  "features": [
    "CHAT",
    "MEDIPLAN"
  ],
  "deletedAt": null,
  "metadata": {
    "title": "Welcome to your benefits page",
    "schema": "light",
    "setupStage": null
  }
}

{
  "error": "Request body is empty or contains malformed JSON."
}

{
  "errors": {
    "status": [
      "Status \"PENDING\" is invalid."
    ],
    "features": [
      "Feature \"POPUP\" is invalid.",
      "Feature \"FAQ\" is invalid."
    ],
    "name": [
      "This name is already in use."
    ]
  }
}

Initial Administrator

initialAdminEmail is required when creating an organisation. It nominates the first administrator for the new organisation and must be a Gallagher corporate address ending in @ajg.com; the check is case-insensitive, so Jane.Doe@AJG.com is accepted. Addresses on look-alike domains (notajg.com) or subdomains (user@eu.ajg.com) are rejected.

Metadata Constraints

When providing the metadata object, the following strict rules apply:

Keys: Must be between 3 and 255 characters. Must be in strict camelCase format: start with a lowercase letter and contain only alphanumeric characters (no underscores, dashes, spaces, or dots).
Values: Must be either a string or null. String values cannot exceed 16,383 characters.

01 September 2026