Create a case from existing profiles

Open a case for a previously verified entity and individual, identified by their profile IDs.

existingRootEntity and existingIndividuals accept a profileId in place of an entityId or individualId. The latest eligible entity or individual on the profile is added to the case. A profile ID from a profile that has since been merged resolves to the profile it was merged into.

Required scope: case-management

Request

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

Variables

{
  "input": {
    "organizationId": "3f2b8c1e9a4d4e7f8b6c5d4e3f2a1b0c",
    "officeId": "8e7d6c5b4a3f4e2d9c1b0a9f8e7d6c5b",
    "initialState": "DRAFT",
    "reference": "MAT-2026-0192",
    "existingRootEntity": {
      "profileId": "c7e5a3b1-9d2f-4c8e-a6b4-3f1e2d0c9b8a"
    },
    "existingIndividuals": [
      {
        "profileId": "6d1f4b2a-3c8e-4a7d-9b5f-2e1c0d9a8b7c"
      }
    ]
  }
}

Response

{
  "data": {
    "createCase": {
      "caseId": "48217",
      "name": "Citizen Family Trust",
      "entities": [
        {
          "entityId": "5102",
          "profileId": "c7e5a3b1-9d2f-4c8e-a6b4-3f1e2d0c9b8a",
          "legalName": "Citizen Family Trust"
        }
      ],
      "individuals": [
        {
          "individualId": "20417",
          "profileId": "6d1f4b2a-3c8e-4a7d-9b5f-2e1c0d9a8b7c",
          "preferredName": {
            "fullName": "John Citizen"
          }
        }
      ]
    }
  }
}