Assign users by email when creating a case

Open a case with users assigned by their email addresses.

Use assignedUserEmails to assign users to the case by their email addresses when it is created. It can be combined with assignedUsers. Each email must belong to a user that can be assigned to the case.

Required scope: case-management

Request

mutation createCase($input: CreateCaseInput!) {
  createCase(input: $input) {
    ... on CaseInformation {
      caseId
      name
      assignedUsers {
        id
        name
      }
    }
    ... on ValidationErrors {
      errors {
        message
      }
    }
  }
}

Variables

{
  "input": {
    "organizationId": "3f2b8c1e9a4d4e7f8b6c5d4e3f2a1b0c",
    "officeId": "8e7d6c5b4a3f4e2d9c1b0a9f8e7d6c5b",
    "initialState": "DRAFT",
    "reference": "MAT-2026-0192",
    "individuals": [
      {
        "preferredName": {
          "firstName": "Jane",
          "lastName": "Citizen"
        },
        "emailAddress": "jane.citizen@example.com",
        "isCaseContact": true,
        "needsVerification": true
      }
    ],
    "existingIndividuals": [
      {
        "individualId": "20417"
      }
    ],
    "assignedUserEmails": [
      "sarah.mitchell@example.com",
      "tom.walker@example.com"
    ]
  }
}

Response

{
  "data": {
    "createCase": {
      "caseId": "48213",
      "name": "Jane Citizen, John Citizen",
      "assignedUsers": [
        {
          "id": "1042",
          "name": "Sarah Mitchell"
        },
        {
          "id": "1057",
          "name": "Tom Walker"
        }
      ]
    }
  }
}

---