Conversations

Get a conversation

GET/conversations/{conversationId}

One conversation with its messages, oldest first.

Try itSend a real request with your API key

Path

conversationIdstringRequired
The conversation.

Answer

200 OK The conversation.

dataConversationRequired
Inside it
- 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

Errors

401 Unauthorizedunauthorized
404 Not foundnot_found not_in_campaign
429 Too many requestsrate_limited
500 Server errorserver_error

Every error has the same shape. See Errors.

const response = await fetch("https://app.salesteam.dev/api/v1/conversations/CONVERSATION_ID", { headers: { Authorization: `Bearer ${process.env.SALESTEAM_API_KEY}`, }, }); console.log(response.status, await response.json());

import os import requests response = requests.get( "https://app.salesteam.dev/api/v1/conversations/CONVERSATION_ID", headers={"Authorization": f"Bearer {os.environ['SALESTEAM_API_KEY']}"}, ) print(response.status_code, response.json())

{ "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" } ] } }