List notifications

What the workspace has been told, newest first. A notification never carries a contact's name or address; it carries the entity id to look up.

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

Scope: read
MCP tool: list_notifications

Query parameters

unread_onlybooleanoptionaldefault: false: Only notifications not yet marked read.
limitintegeroptionaldefault: 25: Rows per page, 1 to 100.
cursorstringoptional: Opaque cursor from the previous page's next_cursor. Omit for the first page. Keep every other argument the same while paging.

Request

curl -G https://app.trygtm.com/api/v1/notifications \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  --data-urlencode "limit=25"

Response

{
  "data": [
    {
      "id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
      "kind": "reply_received",
      "severity": "info",
      "title": "A contact replied",
      "body": null,
      "href": "/inbox",
      "entity_type": "conversation",
      "entity_id": "0f1e2d3c-4b5a-4697-8877-665544332211",
      "read_at": null,
      "created_at": "2026-09-17T08:22:41.000Z"
    }
  ],
  "next_cursor": "WyIyMDI2LTA5LTAyVDA5OjQxOjAyLjAwMFoiLCI4ZjJhOTFjNC02ZDFlLTRjMGEtOWE1Ny0yZjNiMWM3ZTlkMTAiXQ"
}