Search the inbox board

The inbox as its board shows it: one card per contact and channel with the pipeline stage, one status, attention flags and the next send. view picks the tab (attention, replies, drafts, failed, all, pipeline); contacts who opted out are only in all and pipeline. query searches names, emails, companies and message text. 50 cards a page, numbered from 0.

GEThttps://app.trygtm.com/api/v1/inbox

Scope: read
MCP tool: search_inbox

Query parameters

viewstringoptionaldefault: attention: Which tab of the board.attentionrepliesdraftsfailedallpipeline
querystringoptional: Text to find in the contact's name, email, company or messages.
channelstringoptional: Only this channel. The pipeline view defaults to email.emaillinkedinsms
pageintegeroptionaldefault: 0: Page number, from 0.

Request

curl -G https://app.trygtm.com/api/v1/inbox \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  --data-urlencode "query=Texas"

Response

{
  "data": {
    "data": [
      {
        "contact_id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
        "channel": "email",
        "name": "Dana Whitfield",
        "title": "VP Demand Generation",
        "company": "Northbeam Logistics",
        "location": null,
        "email": "dana@northbeam.example",
        "linkedin_url": null,
        "fit_score": 4,
        "stage": "interested",
        "last_activity_at": "2026-09-17T08:22:40.000Z",
        "preview": "Could you do Tuesday?",
        "row_preview": "Could you do Tuesday?",
        "sent_count": 2,
        "reply_count": 1,
        "needs_reply": true,
        "needs_review": false,
        "send_failed": false,
        "opted_out": false,
        "status": "awaiting_reply",
        "next_send_at": null,
        "hold_reason": null,
        "awaiting_return": false,
        "agent_id": null,
        "agent_name": null
      }
    ],
    "page": 0,
    "page_size": 50,
    "next_page": null
  }
}