post

POST /v2/cases — Create a support case

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Creates a new support case in Jira Service Management, linked to an order. Field requirements for the case are driven by the JSM request type — use GET /v2/jira-apis/request-type-groups and GET /v2/jira-apis/request-types to find the requestTypeId and its fields (GET /v2/cases/actions/getCaseTypes is deprecated for this purpose).

Required role

affiliate_super_admin, affiliate_admin, or affiliate_agent

Request body

FieldTypeRequiredDescription
requestTypeIdstringYesJSM request type ID — the externalCaseTypeIdentifier from GET /v2/jira-apis/request-types
orderIdstringYesOrder this case is linked to
fieldsobjectNoMap of externalSystemIdentifier → value for the request type's fields. Any required field left out is auto-resolved from an order/patient variable where possible; if it still can't be resolved, the request fails with 422

Response 201

{
  "success": true,
  "missingRequiredFields": [],
  "data": {
    "_id": "case::abc123",
    "ticketId": "SUPPORT-43",
    "ticketName": "Patient Support Request",
    "ticketStatus": "open",
    "ticketStatusLabel": "Open",
    "relatedOrder": "order::abc123",
    "reporter": null,
    "createdBy": {
      "displayName": "Jane Doe",
      "email": "[email protected]",
      "user_id": "usr::abc123"
    },
    "createdAt": "2026-05-30T14:00:00.000Z",
    "resolvedAt": null,
    "reopenedAt": null,
    "firstResponseTime": null,
    "priority": null,
    "updatedAt": "2026-05-30T14:00:00.000Z",
    "externalCaseUrl": "https://telegramd.atlassian.net/servicedesk/customer/portal/1/SUPPORT-43"
  }
}

There is no top-level jiraRequest, case, requestFieldValues, summary, jiraKey, status, or priority field on the response — use data.ticketId (the Jira issue key) and data.ticketStatus/data.ticketStatusLabel. The raw JSM request and case document are no longer returned; only success, missingRequiredFields, and data are.

Errors

StatusCodeDescription
422INVALID_FIELDrequestTypeId or orderId missing, or a required JSM field couldn't be resolved (see missingRequiredFields in the error body)
404Request type, order, or patient not found
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!