Skip to Content
CallMitraDocs
API referenceTickets

Create a ticket

Opens a ticket for `leadId` (or the lead behind `waConversationId`). Category and source decide its team; the team's rules may assign it automatically.

POST
/api/v1/tickets/

Opens a ticket for leadId (or the lead behind waConversationId). Category and source decide its team; the team's rules may assign it automatically.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.

Lengthlength <= 255

Request Body

application/json
  1. body
assignedToUserId?|

Assign one team member (user id).

assignedUserIds?array<string>|

Assign several team members; wins over assignedToUserId.

categoryId?|

Category id from GET /tickets/categories.

description?Description

Details.

Lengthlength <= 20000
Default""
dueAt?|

Resolution due time (ISO 8601).

leadId?|

The lead (customer) the ticket is about.

priority?|

low, normal, high or urgent. Default: the category's priority, else normal.

sourceCallId?|

The call this ticket came from.

subject*Subject

One-line summary.

Length1 <= length <= 512
tags?array<string>|

Up to 20 tags.

type?Type

support or sales_followup.

Default"support"
waConversationId?|

Open it from a WhatsApp conversation instead; its contact's lead is used.

Response Body

OK

application/json
  1. response
success*Success

Always true on a 2xx response.

ticket*
[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/tickets/' \  -H 'Content-Type: application/json' \  -d '{  "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56",  "description": "Customer says the parcel was marked delivered but never arrived.",  "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8",  "subject": "Order #1042 not delivered",  "tags": [    "order-1042"  ]}'
Example Response
{  "success": true,  "ticket": {    "activities": [      {        "activityType": "created",        "actorName": "Priya Nair",        "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",        "createdAt": "2026-01-15T09:30:00+00:00",        "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",        "payload": {          "category": "Delivery",          "priority": "normal",          "subject": "Order #1042 not delivered",          "team": "Customer care",          "type": "support"        },        "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90"      }    ],    "activityCount": 1,    "assignedToUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "assigneeEmail": "[email protected]",    "assigneeName": "Priya Nair",    "assigneeNames": [      "Priya Nair"    ],    "assignees": [      {        "assignedAt": "2026-01-15T09:30:02+00:00",        "email": "[email protected]",        "name": "Priya Nair",        "userId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f"      }    ],    "canEdit": true,    "canManageAssignees": true,    "canReopenClosed": false,    "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56",    "categoryName": "Delivery",    "createdAt": "2026-01-15T09:30:00+00:00",    "createdByUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "description": "Customer says the parcel was marked delivered but never arrived.",    "dueAt": "2026-01-16T09:30:00+00:00",    "hasOlderActivities": false,    "id": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90",    "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8",    "leadName": "Asha Verma",    "leadPhone": "+919812345678",    "merchantId": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",    "overdue": false,    "priority": "normal",    "ref": "T-5F0C9A3E",    "sla": {      "firstResponse": {        "dueAt": "2026-01-15T13:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-15T12:30:00+00:00"      },      "paused": false,      "resolution": {        "dueAt": "2026-01-16T09:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-16T05:30:00+00:00"      }    },    "source": "manual",    "status": "open",    "subject": "Order #1042 not delivered",    "tags": [      "order-1042"    ],    "teamId": "e7a1c3d5-9b2f-4d68-8a0c-2e4f6a8b0c1d",    "teamName": "Customer care",    "type": "support",    "updatedAt": "2026-01-15T09:30:00+00:00",    "version": 1  }}