Open a contact's inbox conversation

One contact's conversation as the inbox panel shows it: every message on their email, LinkedIn and SMS threads, oldest first, sent and unsent; the pipeline stage; open campaign steps and the unsent message each owns (step_by_message); the channels a reply can be drafted on (draft_targets); an out-of-office email pause; and opt_out, set when the contact opted out and nothing more is sent to them.

GEThttps://app.trygtm.com/api/v1/contacts/{contact_id}/conversation

Scope: read
MCP tool: get_inbox_conversation

Path parameters

contact_idstringrequired: The contact's id, from search_inbox or list_contacts.

Request

curl https://app.trygtm.com/api/v1/contacts/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/conversation \
  -H "Authorization: Bearer $TRYGTM_API_KEY"

Response

{
  "data": {
    "contact": {
      "id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
      "full_name": "Dana Whitfield",
      "email": "dana@northbeam.example",
      "title": "VP Demand Generation",
      "company_name": "Northbeam Logistics",
      "location": "Chicago, Illinois",
      "country": "United States",
      "fit_score": 4,
      "fit_reason": "Asked about routing twice this month.",
      "linkedin_url": null,
      "photo_captured_at": null
    },
    "stage": "interested",
    "agent_name": "GTM outbound",
    "messages": [
      {
        "id": "9f8e7d6c-5b4a-4392-8180-7f6e5d4c3b2a",
        "conversation_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
        "direction": "inbound",
        "status": "delivered",
        "channel": "email",
        "kind": "message",
        "subject": "Re: routing software",
        "body": "Could you do Tuesday?",
        "sent_at": null,
        "created_at": "2026-09-17T08:22:40.000Z",
        "error": null,
        "scheduled_for": null,
        "send_requested_at": null,
        "send_checked": false
      }
    ],
    "draft_targets": [
      {
        "channel": "email",
        "available": true,
        "reason": null,
        "conversation_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
        "has_pending_draft": false
      }
    ],
    "open_steps": [],
    "step_by_message": {},
    "send_window": {
      "timezone": "America/Chicago",
      "start_hour": 8,
      "end_hour": 18,
      "days": [
        1,
        2,
        3,
        4,
        5
      ]
    },
    "email_pause": null,
    "opt_out": null
  }
}