Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns messages for a specific conversation with pagination support using continuation tokens.

Request

X-API-Key
string
required
Your API key
conversationId
string
required
The conversation/chat ID to fetch messages from
accountId
string
required
The LinkedIn sender account ID that owns this conversation
limit
integer
default:"50"
Number of messages to return (max: 100)
continuationToken
string
Token for fetching the next page of messages. Returned in the previous response.

Response

conversationId
string
The conversation ID
messages
array
Array of message objects
pagination
object
Pagination metadata
curl "https://api.sendpilot.ai/v1/inbox/conversations/2-OVp-y-UNyFXBYvx0FqmQ/messages?accountId=sender_abc123&limit=50" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "conversationId": "2-OVp-y-UNyFXBYvx0FqmQ",
  "messages": [
    {
      "id": "msg_abc123",
      "content": "Hi John! Thanks for connecting. I wanted to follow up on our conversation about your company's growth plans.",
      "sender": {
        "id": "jane-smith-12345",
        "name": "Jane Smith",
        "profileUrl": "https://www.linkedin.com/in/jane-smith"
      },
      "recipient": {
        "id": "john-doe-67890",
        "name": "John Doe",
        "profileUrl": "https://www.linkedin.com/in/john-doe"
      },
      "direction": "sent",
      "sentAt": "2024-02-24T14:00:00.000Z",
      "readStatus": "read",
      "contentType": "TEXT"
    },
    {
      "id": "msg_def456",
      "content": "Thanks for reaching out! I'd love to discuss this further. Are you available for a call next week?",
      "sender": {
        "id": "john-doe-67890",
        "name": "John Doe",
        "profileUrl": "https://www.linkedin.com/in/john-doe"
      },
      "recipient": {
        "id": "jane-smith-12345",
        "name": "Jane Smith",
        "profileUrl": "https://www.linkedin.com/in/jane-smith"
      },
      "direction": "received",
      "sentAt": "2024-02-24T15:30:00.000Z",
      "readStatus": "unread",
      "contentType": "TEXT"
    }
  ],
  "pagination": {
    "hasMore": true,
    "continuationToken": "eyJjb250aW51YXRpb24iOiIxNzA4Nzg0MjAwMDAwIn0="
  }
}
The accountId parameter is required to verify that the conversation belongs to a LinkedIn account in your workspace.
Use the continuationToken from the response to fetch older messages. Pass it as a query parameter in subsequent requests.