Get conversation

One conversation with its customer, status, assignee, tags and every thread, notes included.

GET https://cotlet.dev/api/v1/help-scout/conversations/{conversation_id}

read

Returns the conversation as the thread view shows it: customer, inbox, status, assignee, tags and each thread in order, marked as customer message, reply or internal note. Attachments come back as names, not files. Use it before replying so you do not repeat what a note or a teammate already said.

Parameters

Parameters: get_conversation
NameTypeDescription
conversation_id integer required integer Conversation number from search_conversations.

Request

cURL
curl https://cotlet.dev/api/v1/help-scout/conversations/1 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("help-scout", "get_conversation", {"conversation_id":1})
Node.js
const result = await cotlet.call('help-scout', 'get_conversation', {"conversation_id":1});
CLI
cotlet call help-scout get_conversation --data '{"conversation_id":1}'

Example response

JSON

{
  "conversation_id": 48244,
  "subject": "Charged twice in October",
  "status": "active",
  "assignee": null,
  "tags": [
    "billing"
  ],
  "customer": {
    "name": "Priya Nair",
    "email": "priya@example.com"
  },
  "inbox": "Support",
  "threads": [
    {
      "type": "customer",
      "author": "Priya Nair",
      "created_at": "2026-10-16T07:55:00Z",
      "text": "Hi, my card was charged twice on 1 October. Can you check?"
    },
    {
      "type": "note",
      "author": "Maria Silva",
      "created_at": "2026-10-16T08:12:00Z",
      "text": "Looking at the invoices now."
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.