WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

List an attendee's chats

GET/api/linkedin/gateway/chat_attendees/{attendee_id}/chats

Lists the one-on-one chats a given attendee is part of — useful for jumping straight to "the chat with this person" once you have their attendee id from a search or profile lookup.

Authentication

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

Path parameters

FieldTypeDescription
attendee_id *stringThe attendee's id, or their id on the underlying provider.

Query parameters

FieldTypeDescription
account_id *stringThe connected account this attendee belongs to. Must belong to the calling key.
beforestringOnly return chats created before this ISO 8601 datetime.
afterstringOnly return chats created after this ISO 8601 datetime.
limitintegerPage size, from 1 to 250.
cursorstringPass back the cursor from a previous response to fetch the next page.

Response fields

FieldTypeDescription
itemsarrayThe page of chats involving this attendee.
items[].idstringThe chat's id.
items[].account_typestringThe provider the chat lives on — one of WHATSAPP, LINKEDIN, SLACK, TWITTER, MESSENGER, INSTAGRAM, TELEGRAM.
items[].namestring | nullThe chat's name, for a named group; null for a 1:1 chat.
items[].unread_countnumberNumber of unread messages in the chat.
items[].archived0 | 1Whether the chat is archived.
items[].pinned0 | 1Whether the chat is pinned.
cursorstring | nullPass as the cursor query parameter to fetch the next page. Null once there are no more.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No attendee exists with that id on that account.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/chat_attendees/9fA2mZ0pQKxLR3vWtC8u1g/chats?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "ChatList",
  "items": [
    {
      "object": "Chat",
      "id": "3jvC1lZoWkyBqXn8T4uHwQ",
      "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
      "account_type": "LINKEDIN",
      "attendee_provider_id": "ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ",
      "name": null,
      "type": 0,
      "timestamp": "2026-08-21T14:02:11.000Z",
      "unread_count": 0,
      "archived": 0,
      "pinned": 0
    }
  ],
  "cursor": null
}
No key yet? Create one from Dashboard → API Keys.