| Field | Value |
|---|---|
| Method | POST |
| Endpoint | https://{{host}}/caseManagement/api/public/analytics/{{streamId}}/createCase |
| Content Type | application/json |
| Authorization | auth: {{JWT}} See How to generate the JWT Token. |
| API Scope | Case Management Configuration |
Path Parameters
| Parameter | Required | Description |
|---|---|---|
host | Required | Environment URL. For example, https://platform.kore.ai. |
streamId | Required | Bot identifier or Stream identifier. Access it from the General Settings page of the bot. For example, st-084d3c5e-376a-559f-9987-a012bb2bxxxx. |
Header Parameters
| Parameter | Required | Description |
|---|---|---|
accountId | Optional | The account identifier associated with the API request. For example, 6639f7bd58c97ffac03bxxxx. |
Sample Request
curl --location 'https://{{host}}/caseManagement/api/public/analytics/{{streamId}}/createCase' \
--header 'AccountId: {{accountId}}' \
--header 'auth: {{jwt-code}}' \
--header 'Iid: st-adad1d73-99af-52b3-a85d-0791763bxxxx' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'bot-language: en' \
--header 'app-language: en' \
--data-raw '{
"caseTmp": "ctm-d4e6152-4255-4c5c-ba6c-91dac5cdxxxx",
"name": "This is demo case",
"desc": "Demo case",
"userInfo": {
"_id": "u-fd371c0a-3168-5a02-83dd-f4ba5597xxxx",
"name": "John"
},
"emailId": "john.doe@example.com",
"phoneNumber": "902398xxxx",
"dueDate": "2026-09-04T14:15:00.000Z",
"source": "rtm"
}'
Request Body Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
caseTmp | Required | String | Unique case template identifier. |
name | Required | String | Name or title of the case. |
desc | Required | String | Case description. |
userInfo | Required | Object | User information object containing user details. |
userInfo._id | Optional | String | Unique user identifier. If not provided, you must include either emailId or phoneNumber. |
userInfo.name | Optional | String | User’s name. |
emailId | Required | String | User’s email address. Mandatory if userInfo._id isn’t present. |
phoneNumber | Required | String | User’s phone number. Mandatory if userInfo._id isn’t present. |
source | Required | String | Source of the case. For example, rtm. |
dueDate | Required | String | Due date of the case. |
Sample Response
{
"_id": "ci-6b83ac7-8245-4e5e-ac8c-9695b531xxxx",
"caseTmp": "Sales",
"name": "This is demo case",
"lname": "this is demo case",
"tags": [],
"userInfo": {
"_id": "u-fd371c0a-3168-5a02-83dd-f4ba5597xxxx",
"name": "John",
"emailId": "john.doe@example.com"
},
"sessIds": [],
"accountId": "{{accountId}}",
"iId": "st-d140086f-4d0a-59fa-9d28-b5fc23e9xxxx",
"orgId": "o-734f0871-3217-515b-bd5f-36abef3cxxxx",
"convIds": [],
"status": {
"_id": "sts-599163e-b869-4532-bbb3-c76a3d08xxxx",
"name": "Open",
"statusCategory": "open"
},
"source": "rtm",
"language": "en",
"conversationType": "CASE",
"fields": [
{
"_id": "fd-3380ddb-a87d-4b25-8db6-5002e5c8xxxx",
"show": true,
"displayName": "Description",
"lname": "description",
"desc": "Transcription based on the conversation summary",
"isEnabled": true,
"isActive": true,
"metaData": {
"type": "textarea",
"displayName": "Description",
"name": "description",
"description": "Transcription based on the conversation summary",
"placeholder": "Enter description",
"readOnly": false,
"tooltipText": "Transcription based on the conversation summary"
},
"type": "system",
"required": true,
"dataType": "textarea",
"selectedValue": ""
},
{
"_id": "fd-7ab71aa-5da2-4cd1-a7ec-0e2468b8xxxx",
"show": true,
"displayName": "Due Date",
"lname": "due date",
"desc": "Date/time to complete a case",
"isEnabled": true,
"isActive": true,
"metaData": {
"type": "datetime",
"displayName": "Due Date",
"name": "dueDate",
"description": "Date/time to complete a case",
"placeholder": "Enter date",
"readOnly": false,
"tooltipText": "Date/time to complete a case"
},
"type": "system",
"required": true,
"dataType": "datetime"
},
{
"_id": "fd-a165979-63b6-498b-85b8-c48098edxxxx",
"show": true,
"displayName": "Title",
"lname": "title",
"desc": "Title of the field",
"isEnabled": true,
"isActive": true,
"metaData": {
"type": "input",
"displayName": "Title",
"name": "title",
"description": "Title of the field",
"placeholder": "Enter title",
"readOnly": false,
"tooltipText": "Title of the field"
},
"type": "system",
"required": true,
"dataType": "input"
}
],
"participants": [
{
"agentId": "u-320fa237-51be-5c46-a046-14e97c77xxxx",
"aId": "a-005c549-c9a4-441e-adc2-781a3a01xxxx",
"name": "John",
"pStatus": "ACTIVE",
"assignedAt": "2025-06-03T10:51:59.792Z"
}
],
"priority": {
"_id": "pr-6189896-de68-4e02-8d56-813a68bdxxxx",
"name": "Medium",
"color": "#16A34A",
"score": 10
},
"refId": "CS00xxxx",
"assigneeType": "agent",
"currAssignee": {
"aId": "a-005c549-c9a4-441e-adc2-781a3a01xxxx",
"name": "John",
"agentId": "u-320fa237-51be-5c46-a046-14e97c77xxxx"
},
"tasks": [],
"isActive": true,
"taskIds": [],
"attachments": [],
"feedback": [],
"createdBy": {
"name": "John",
"_id": "u-320fa237-51be-5c46-a046-14e97c77xxxx",
"profImage": "no-avatar"
},
"updatedBy": {
"name": "John",
"_id": "u-320fa237-51be-5c46-a046-14e97c77xxxx",
"profImage": "no-avatar"
},
"timestampValue": 1748947919675,
"activityIds": [],
"commentIds": [],
"resolutionCmts": [],
"isBreached": false,
"supportCustomTasks": true,
"queues": [],
"channel": [],
"createdAt": "2025-06-03T10:51:59.779Z",
"updatedAt": "2025-06-03T10:51:59.794Z",
"ETA": "2025-09-04T14:15:00.000Z"
}