Record the ticket a callback became (desk:write)
POST /api/desk/v1/callbacks/{id}/ticket
Module: Desk · operationId: linkCallbackTicket · Tag: Callbacks · Auth: access token (Authorization: Bearer <accessToken>)
The second step of turning a callback into a ticket: the client creates the ticket (createItem), then links it
here. The ticket must be one the caller sees (404 otherwise). The callback gets itemId and convertedAt, moves
to the first active closed status unless it is closed already, and stays read-only except its done note. The same
ticket again answers the callback unchanged (200); another ticket is 409 converted.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Request body
application/json (required)
itemId(string, required): Ticket id or numberversion(integer, required)
Example:
{
"itemId": "#2",
"version": 2
}
Responses
- 200 Converted (
application/json) - 400 Error (
application/json) - 404 Error (
application/json) - 409 version_conflict or converted (
application/json)
Fields of the 200 answer:
closed(boolean, read-only): The status carries the closed flagclosedAt(string (date-time), nullable): When the callback was closedclosedBy(string): Login (e-mail) of who closed the callbackcontact(object): Masterdata contact snapshot (only with a customer)contactName(string): Name of the person to call backconvertedAt(string (date-time), nullable): When the callback was turned into a ticketcreatedAt(string (date-time)): When the callback was createdcreatedBy(string): Login (e-mail) of who created the callbackcreatedByName(string): Name of who created the callbackcustomFields(object): Values of the fields of settings.callbacks.fields, keyed without cf.customer(object): Masterdata address snapshotcustomerMail(object): Only in the answer of a create or status change into a status with a customer mail: the draft of a manual mail; for an automatic one the mail as queued (modeauto, nomissing) or, when it was not sent, why (missing). Never on reads.desiredAt(string (date-time), nullable): When the contact wants to be called backdesiredHasTime(boolean): false: only the day of desiredAt countsdoneNote(string): Result of the callid(string (uuid)): Id of the callbackitem(ItemSummary)id(string): Id of the itemnumber(integer): Number of the itemphase(Phase): (one ofnew,active,waiting,done)spaceId(string): Space of the itemstatus(string): Status keytitle(string): TitletypeId(string): Type of the item
itemId(string, nullable): The ticket it becamenote(string): Note of the callbacknumber(integer): Per tenantorigin(string): The call it was made from in Arbeitsplatz › Aktivitäten (comms:interaction:<id>,comms:calendar:<id>); "" noneoverdue(boolean, read-only): Open and the desired time (without time: the desired day) has passedphone(string): Phone number to call backreason(string): Key of a callbackReason entry, "" = noneresponsibleName(string): Name of the person responsibleresponsibleRef(string): User ref of the person who calls back; "" = nobody yet (the pool of unassigned callbacks)status(string): Key of a callbackStatus entryupdatedAt(string (date-time)): When the callback was last changedversion(integer): Version of the callback; send it back on change (409 version_conflict when it is outdated)
Example 200 answer:
{
"closed": false,
"contact": {
"id": "6b8d0f2a-4c6e-4a8b-9d1f-3a5c7e9b1d11",
"name": "Katrin Stadler"
},
"contactName": "Katrin Stadler",
"createdAt": "2026-11-17T15:20:00Z",
"createdBy": "sophie.huber@muster-it.example",
"createdByName": "Sophie Huber",
"customFields": {},
"customer": {
"id": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c11",
"name": "Alpenhotel Seeblick GmbH \u0026 Co. KG"
},
"desiredAt": "2026-11-19T08:00:00Z",
"desiredHasTime": true,
"doneNote": "",
"id": "7b4c5d6e-8f9a-4b0c-9d2e-4f5a6b7c8d01",
"itemId": "",
"note": "Frau Stadler möchte kurz zur Kassenanbindung sprechen, bevor die Frühschicht beginnt.",
"number": 12,
"origin": "",
"overdue": false,
"phone": "+49 8652 987612",
"reason": "callback_requested",
"responsibleName": "Elias Gruber",
"responsibleRef": "elias.gruber@muster-it.example",
"status": "open",
"updatedAt": "2026-11-17T15:20:00Z",
"version": 1
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/desk/v1/callbacks/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/ticket' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"itemId":"#2","version":2}'