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.
Opens a ticket for leadId (or the lead behind waConversationId). Category and source decide its team; the team's rules may assign it automatically.
X-API-Key<token>Create in the console: Settings → API & webhooks.
Idempotency-Key?stringAny unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.
length <= 255application/json- 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?DescriptionDetails.
length <= 20000""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*SubjectOne-line summary.
1 <= length <= 512tags?array<string>|Up to 20 tags.
type?Typesupport or sales_followup.
"support"waConversationId?|Open it from a WhatsApp conversation instead; its contact's lead is used.
OK
application/json- response
success*SuccessAlways true on a 2xx response.
ticket*[key: string]?anycurl -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" ]}'{ "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 }}