Built-in tool
Read LinkedIn conversation
Read recent messages in a LinkedIn conversation.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| limitnumber · optional | number | optional | How many messages to return, taken from the MOST RECENT end of the conversation and returned in chronological order (oldest→newest within the result, so the latest message is last). Default 200. Default: |
| offsetnumber · optional | number | optional | Skip this many of the most-recent messages before applying `limit`, to page further back through older history. Default 0 (start at the latest). Use `totalCount` in the result to know how far back you can page. Default: |
| conversationIdstring · optional | string | optional | Our internal conversation UUID for the LinkedIn chat (usually from the trigger context). Preferred. |
| contactIdentifierstring · optional | string | optional | Fallback: the contact's LinkedIn identifier or profile URL, matched against the conversation's contact. Used only when conversationId is not supplied. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId",
"contact",
"messageCount",
"totalCount",
"messages"
],
"properties": {
"contact": {
"type": [
"string",
"null"
]
},
"messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"datetime",
"sender",
"recipient",
"content",
"isFromMe",
"sent_via",
"sent_by_workflow_id",
"sent_by_workflow_name"
],
"properties": {
"sender": {
"type": "string"
},
"content": {
"type": "string"
},
"datetime": {
"type": "string"
},
"isFromMe": {
"type": "boolean"
},
"sent_via": {
"enum": [
"workflow",
"manual",
"external",
"unknown"
],
"type": "string"
},
"recipient": {
"type": "string"
},
"sent_by_workflow_id": {
"type": [
"string",
"null"
]
},
"sent_by_workflow_name": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"totalCount": {
"type": "number"
},
"messageCount": {
"type": "number"
},
"conversationId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}