Get conversation

One conversation with its messages, channel and assignee.

MCP tool podium_read → get_conversation

read

Returns the messages of one conversation in the order Podium shows them, with who sent each (the contact or a teammate), the channel and the current assignee. Use it to read the whole thread before you reply or assign it. Reading does not change the conversation.

Parameters

Parameters: get_conversation
NameTypeDescription
conversation_id string required string Conversation ID from list_conversations.
limit integer integer How many rows to return in one call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "podium_read",
    "arguments": {
      "operation": "get_conversation",
      "arguments": {
        "conversation_id": "conversation_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "conv_91d3",
    "channel": "text",
    "contact": {
      "contact_id": "ct_4410",
      "name": "Priya Nair"
    },
    "assigned_to": null,
    "messages": [
      {
        "from": "contact",
        "body": "Hi, can I move my cleaning to Friday?",
        "sent_at": "2026-10-22T16:41:00Z"
      }
    ]
  },
  "isError": false
}

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.