Docs
Get API key

Conversations

List conversations

GET/conversations

Conversations the inbox shows, newest first. Inbox privacy applies.

Try itSend a real request with your API key

Your key stays in this page and goes only to Salesteam.

Query

  • limitinteger

    Defaults to 50.

  • cursorstring

    nextCursor from the previous page.

  • updatedSincestring · date-time

  • leadIdstring

  • campaignIdstring

Answer

200 OK A page of conversations.

  • dataarray of ConversationRequired
    Each item
    • idstringRequired
    • leadobject or nullRequired
      Inside it
      • idstring
      • fullNamestring
      • linkedinUrlstring
    • senderobject or nullRequired
      Inside it
      • idstring
      • namestring
    • channelstringRequired

      One of linkedin, inmail.

    • campaignsarray of objectRequired
      Each item
      • idstringRequired

        The campaign's ID.

      • namestringRequired

        The campaign's name.

    • unreadbooleanRequired
    • archivedbooleanRequired
    • tagsarray of stringRequired
    • lastMessageone ofRequired
      Inside it

      One of these shapes:

      Option 1

      • idstringRequired
      • directionstringRequired

        One of inbound, outbound.

      • textstringRequired

        Up to 500 characters.

      • sentAtstring · date-timeRequired

      Option 2

    • messageCountintegerRequired
    • updatedAtstring · date-timeRequired
    • linkstring · uriRequired

      Opens the conversation in Salesteam.

    • messagesarray of Message

      Only on GET /conversations/{conversationId}, oldest first.

      Each item
      • idstringRequired
      • directionstringRequired

        One of inbound, outbound.

      • textstringRequired
      • subjectstring

        InMail only.

      • sentAtstring · date-timeRequired
  • nextCursorstring or nullRequired

    Pass as cursor for the next page; null on the last page.

Errors

  • 400 Bad requestinvalid_request invalid_json duplicate_in_request
  • 401 Unauthorizedunauthorized
  • 429 Too many requestsrate_limited
  • 500 Server errorserver_error

Every error has the same shape. See Errors.

GET /conversations
curl "https://app.salesteam.dev/api/v1/conversations" \
  -H "Authorization: Bearer $SALESTEAM_API_KEY"
200 answer
{
  "data": [
    {
      "id": "conv_7Qm2xT9a",
      "lead": {
        "id": "lead_7Qm2xT9a",
        "fullName": "Jamie Lee",
        "linkedinUrl": "https://www.linkedin.com/in/jamie-lee-example"
      },
      "sender": {
        "id": "acc_7Qm2xT9a",
        "name": "Founders Q4"
      },
      "channel": "linkedin",
      "campaigns": [
        {
          "id": "cmp_7Qm2xT9a",
          "name": "Founders Q4"
        }
      ],
      "unread": true,
      "archived": true,
      "tags": [
        "tag"
      ],
      "lastMessage": {
        "id": "msg_7Qm2xT9a",
        "direction": "inbound",
        "text": "Thanks for connecting, Jamie.",
        "sentAt": "2026-11-12T09:00:00.000Z"
      },
      "messageCount": 25,
      "updatedAt": "2026-11-12T09:00:00.000Z",
      "link": "https://example.com",
      "messages": [
        {
          "id": "msg_7Qm2xT9a",
          "direction": "inbound",
          "text": "Thanks for connecting, Jamie.",
          "subject": "subject",
          "sentAt": "2026-11-12T09:00:00.000Z"
        }
      ]
    }
  ],
  "nextCursor": null
}