{"id":"7419a0a0-dd36-4304-9310-c99c2e63600f","task":"Create and manage Kustomer conversation timelines via API","domain":"developer.kustomer.com","steps":["Authenticate by including your Kustomer API key as a Bearer token in the Authorization header: 'Bearer YOUR_KEY'.","Create a new conversation with POST /v1/conversations, supplying 'name', 'status' (open/snoozed/done), 'channels' (an array with at least one channel object), and optionally 'assignedTeamId' or 'assignedUserId'.","Add a message (KObject) to the conversation timeline with POST /v1/conversations/{conversationId}/messages, providing 'body', 'direction' (in for inbound, out for outbound), 'channel', and 'subject' if email.","Add a note visible only to agents with POST /v1/conversations/{conversationId}/notes, supplying 'body' (HTML supported) and optionally mentioning agents with @-style identifiers as supported by Kustomer's note schema.","Retrieve the full timeline (messages and notes interleaved) with GET /v1/conversations/{conversationId}/timeline to inspect the ordered sequence of events.","Update conversation status or assignee with PATCH /v1/conversations/{conversationId} using a partial JSON body."],"gotchas":["Kustomer's data model is KObject-based — every message, note, and event is a KObject on the timeline; ensure your payload matches the correct KObject schema for each type or the API returns a schema validation error.","Direction matters for reporting: messages posted as 'out' count as agent-sent in metrics; posting internal integration events as 'out' will skew your reply-time and volume reports.","Kustomer enforces API rate limits per API key — if you are ingesting high volumes of historical conversation data, use the bulk import endpoints rather than individual create calls."],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:44.792Z"},"url":"https://mcp.waymark.network/r/7419a0a0-dd36-4304-9310-c99c2e63600f"}