Skip to main content
GET
/
api
/
network
/
messages
List network messages
curl --request GET \
  --url https://app.puffle.ai/api/network/messages \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "id": "mm111111-1111-1111-1111-111111111111",
      "user_id": "11111111-1111-1111-1111-111111111111",
      "connection_id": "cc111111-1111-1111-1111-111111111111",
      "linkedin_conversation_id": "conv_abc",
      "conversation_title": null,
      "from_name": "Ada Lovelace",
      "from_linkedin_url": "https://www.linkedin.com/in/ada",
      "to_name": "You",
      "to_linkedin_url": "https://www.linkedin.com/in/me",
      "sent_at": "2024-01-28T18:19:15Z",
      "subject": null,
      "content": "Hello!",
      "folder": "INBOX",
      "is_from_me": false,
      "has_attachments": false,
      "is_draft": false
    }
  ],
  "count": 1,
  "page": 1,
  "limit": 50,
  "totalPages": 1
}

​
Overview

Paginated list of the caller’s LinkedIn message history, newest first. Optional connectionId query narrows to one connection. Messages whose counterpart URL doesn’t match any imported connection still exist in the table, just with connection_id: null. They appear in the full list but won’t show up when filtered by a specific connectionId.
This operation shares the URL path /api/network/messages with other verbs. See Import network messages to bulk-load from LinkedIn Messages.csv, or Delete all network messages to nuke the full history.

​
AI agent notes

Pagination cap. limit is clamped to 100 server-side — passing larger values silently gets capped, limit in the response is the effective value.Linkage is best-effort. Messages whose counterpart URL didn’t match any imported connection carry connection_id: null. The expected flow is importNetworkConnections before importNetworkMessages, in that order.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
connectionId
string<uuid>

If provided, only return messages linked to this connection id.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
page
string

1-indexed page. Defaults to 1.

​
limit
string

Page size. Defaults to 50; clamped to a max of 100.

Response

Paginated message page.

​
messages
object[]
required
​
count
integer
required
Required range: 0 <= x <= 9007199254740991
​
page
integer
required
Required range: 0 < x <= 9007199254740991
​
limit
integer
required
Required range: 0 < x <= 9007199254740991
​
totalPages
integer
required
Required range: 0 <= x <= 9007199254740991