Skip to main content
GET
/
v1
/
inbox
/
conversations
curl "https://api.sendpilot.ai/v1/inbox/conversations?accountId=sender_abc123&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "conversations": [
    {
      "id": "2-OVp-y-UNyFXBYvx0FqmQ",
      "accountId": "sender_abc123",
      "participants": [
        {
          "id": "john-doe-12345",
          "name": "John Doe",
          "profileUrl": "https://www.linkedin.com/in/john-doe",
          "profilePicture": "https://media.licdn.com/dms/image/..."
        }
      ],
      "lastMessage": {
        "content": "Thanks for reaching out! I'd love to discuss...",
        "sentAt": "2024-02-24T15:30:00.000Z",
        "direction": "received"
      },
      "lastActivityAt": "2024-02-24T15:30:00.000Z",
      "unreadCount": 1,
      "createdAt": "2024-02-20T10:00:00.000Z",
      "updatedAt": "2024-02-24T15:30:00.000Z"
    }
  ],
  "pagination": {
    "continuationToken": "eyJjb250aW51YXRpb24iOiIxNzA4Nzg0MjAwMDAwIn0=",
    "limit": 20,
    "hasMore": true
  }
}

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 all conversations for LinkedIn accounts in your workspace. Optionally filter by a specific LinkedIn account.

​
Request

​
X-API-Key
string
required
Your API key
​
accountId
string
Filter by specific LinkedIn sender account ID. If not provided, returns conversations from all accounts.
​
limit
integer
default:"20"
Number of conversations per page (max: 100)
​
continuationToken
string
Token for fetching the next page of conversations. Returned in the previous response.

​
Response

​
conversations
array
Array of conversation objects
​
pagination
object
Pagination metadata
curl "https://api.sendpilot.ai/v1/inbox/conversations?accountId=sender_abc123&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "conversations": [
    {
      "id": "2-OVp-y-UNyFXBYvx0FqmQ",
      "accountId": "sender_abc123",
      "participants": [
        {
          "id": "john-doe-12345",
          "name": "John Doe",
          "profileUrl": "https://www.linkedin.com/in/john-doe",
          "profilePicture": "https://media.licdn.com/dms/image/..."
        }
      ],
      "lastMessage": {
        "content": "Thanks for reaching out! I'd love to discuss...",
        "sentAt": "2024-02-24T15:30:00.000Z",
        "direction": "received"
      },
      "lastActivityAt": "2024-02-24T15:30:00.000Z",
      "unreadCount": 1,
      "createdAt": "2024-02-20T10:00:00.000Z",
      "updatedAt": "2024-02-24T15:30:00.000Z"
    }
  ],
  "pagination": {
    "continuationToken": "eyJjb250aW51YXRpb24iOiIxNzA4Nzg0MjAwMDAwIn0=",
    "limit": 20,
    "hasMore": true
  }
}
Use the continuationToken from the response to fetch older response. Pass it as a query parameter in subsequent requests.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Query Parameters

​
accountId
string

Filter by specific LinkedIn sender account ID. If not provided, returns conversations from all accounts.

​
limit
integer
default:20

Number of conversations per page (max 100)

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

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

Response

List of conversations

​
conversations
object[]
required
​
pagination
object
required