Link a call or conversation to a case
The record must belong to your organisation. Linking the same record again answers 200 with the existing link, so a retry is safe. Available to organisations with customer cases switched on: an organisation whose business type has no cases gets 404 `TENANT_MODULE_UNAVAILABLE`, one where cases are not switched on yet gets 403 `FEATURE_NOT_AVAILABLE`. Required scope: `cases.write`.
/cases/{caseId}/linksAuthorization
ApiKeyAuth An external API key, sent as Authorization: Bearer mflo_…. Scopes are checked per route; see each operation’s description.
In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/cases/497f6eca-6276-4993-bfeb-53cbbbba6f08/links" \ -H "Content-Type: application/json" \ -d '{ "resourceType": "TELEPHONY_CALL", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "resourceType": "TELEPHONY_CALL", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6", "createdAt": "2019-08-24T14:15:22Z" }}Add an internal note to a case POST
Credited to the person who created the API key; a system key writes a system note. Available to organisations with customer cases switched on: an organisation whose business type has no cases gets 404 `TENANT_MODULE_UNAVAILABLE`, one where cases are not switched on yet gets 403 `FEATURE_NOT_AVAILABLE`. Required scope: `cases.write`.
Create a customer case POST
`title` and `categoryKey` are required. Every referenced record (contact, company, topic, assignee, tags, `links`) must belong to your organisation; an unknown one is a 422 naming the field, never a hint that it exists elsewhere. `companyId` needs an organisation that keeps companies (else 404 `TENANT_MODULE_UNAVAILABLE`). The number is allocated atomically; the case's `source` is `API`. Available to organisations with customer cases switched on: an organisation whose business type has no cases gets 404 `TENANT_MODULE_UNAVAILABLE`, one where cases are not switched on yet gets 403 `FEATURE_NOT_AVAILABLE`. Required scope: `cases.write`.