Skip to content
Docs
Open Backstage
Operation

Log a call, visit or note on a customer

POST/customers/{customerId}/activities
Log a call (direction, number, duration, outcome, notes), an in-person visit (what was asked, what was done) or a note on a customer: on one of the customer's cases (caseId), or on the customer's own log when it belongs to no case. A log entry belongs to `accountId`, else your own account when you write cases on one, else the organisation; only that account and the organisation see it. Needs customers.read for the customer and cases.write for the account.

Path parameters

customerIdstringRequired
Customer ID

Headers

Idempotency-KeystringOptional
Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

Returns

Logged

Errors

400
Bad Request - Invalid input
401
Unauthorized - Authentication required
403
Forbidden - Insufficient permissions
404
Not Found - Resource not found
409
The case is closed (CASE_CLOSED) or past its reopen window (CASE_REOPEN_WINDOW_PASSED)
500
Internal Server Error

Every error names its code and links to it. All error codes

curl -X POST "https://api.ticketlayer.com/v1/customers/cus_abc123/activities" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug" \  -H "Content-Type: application/json" \  -d '{    "kind": "visit",    "asked": "Lost my tickets",    "done": "Reprinted both tickets"  }'
Response 201
{
  "activity": {
    "id": "act_W1pT0a8f3k2Lq9Zx",
    "caseId": "string",
    "customerId": "string",
    "owningAccountId": "string",
    "kind": "email_in",
    "direction": "inbound",
    "channel": "email",
    "authorKind": "customer",
    "authorId": "string",
    "body": "string",
    "tier": "internal",
    "sensitive": true,
    "metadata": {},
    "attachmentAssetIds": [
      "string"
    ],
    "occurredAt": "string",
    "createdAt": "string"
  },
  "caseReopened": true
}

Try it in test mode

Path parameters
Customer ID