Skip to main content
GET
/
v1
/
inbox
/
conversations
/
{conversationId}
/
messages
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="
  }
}

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.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
conversationId
string
required

The conversation/chat ID to fetch messages from

Query Parameters

​
accountId
string
required

The LinkedIn sender account ID that owns this conversation

​
limit
integer
default:50

Number of messages to return (max 100)

Required range: 1 <= x <= 100
​
continuationToken
string

Token for fetching the next page of messages. Returned in the previous response.

Response

Conversation messages

​
conversationId
string
required
​
messages
object[]
required
​
pagination
object
required