WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

List all chats

GET/api/linkedin/gateway/chats

Pages through an account's conversations, newest activity first, with filters for unread state and a time window.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Query parameters

FieldTypeDescription
account_id *stringWhich account's chats to list. Comma-separate several of your own account ids to combine them.
unreadbooleanRestrict to unread or read chats only.
cursorstringA cursor from a previous response, to fetch the next page.
beforestringOnly chats active before this ISO 8601 UTC timestamp.
afterstringOnly chats active after this ISO 8601 UTC timestamp.
limitnumberItems per page, 1–250.
account_typestringFilter to a specific connected channel, e.g. LINKEDIN.

Response fields

FieldTypeDescription
itemsarrayOne entry per chat: id, account_id, account_type, name, timestamp, unread_count, archived, muted_until, pinned and read_only.
cursorstring | nullPass back as cursor to fetch the next page; null once there isn't one.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/chats?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf&unread=true&limit=20" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "ChatList",
  "items": [
    {
      "object": "Chat",
      "id": "9c5e2a71-4b3f-4e8a-9c2d-9f1e6a2b7c44",
      "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
      "account_type": "LINKEDIN",
      "name": null,
      "type": 0,
      "unread_count": 2,
      "archived": 0,
      "pinned": 0,
      "read_only": 0
    }
  ],
  "cursor": "eyJvZmZzZXQiOjIwfQ=="
}
No key yet? Create one from Dashboard → API Keys.