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