Create a case for a new entity

Open a case for an entity that has not been verified before.

Use rootEntity to create a case for an entity that has not been verified before. Use riskAssessment to set the risk level of the case.

Required scope: case-management

Request

mutation createCase($input: CreateCaseInput!) {
  createCase(input: $input) {
    ... on CaseInformation {
      caseId
      name
      entities {
        entityId
        legalName
      }
    }
    ... on ValidationErrors {
      errors {
        message
      }
    }
  }
}

Variables

{
  "input": {
    "organizationId": "3f2b8c1e9a4d4e7f8b6c5d4e3f2a1b0c",
    "officeId": "8e7d6c5b4a3f4e2d9c1b0a9f8e7d6c5b",
    "initialState": "DRAFT",
    "reference": "MAT-2026-0192",
    "rootEntity": {
      "type": "PRIVATE_COMPANY",
      "tradingName": "Harbour Holdings Limited",
      "identifier": "8374619",
      "registeredCountry": "NZ"
    },
    "riskAssessment": "MEDIUM"
  }
}

Response

{
  "data": {
    "createCase": {
      "caseId": "48214",
      "name": "Harbour Holdings Limited",
      "entities": [
        {
          "entityId": "5236",
          "legalName": "Harbour Holdings Limited"
        }
      ]
    }
  }
}

---