Skip to main content
POST
Run linkedin-extract-conversations action live
1 credit per 20 results · credit_ratio 0.05 · Credit costs No per-action quota · How limits work

Agent skill

edges-linkedin-extract-conversations — ready-made instructions for coding agents calling this endpoint.

Free with Engagement Mode

No credits required when executed with an Engagement Identity. Set type: “engagement” when creating an Identity via API.
To run LinkedIn actions, you must first create an identity and connect a LinkedIn account, either using our Chrome Extension, username/password login, or Managed Accounts to run without connecting an account.
Prefer X-Pagination-Next and X-Pagination-Previous over constructing pagination URLs yourself. Stop only when X-Pagination-Next is absent — a short page (fewer results than the previous page, or than the action’s usual page size) does not mean you are done. LinkedIn’s page length can vary from one request to the next; the result array length is not a stop condition.

Authorizations

X-API-Key
string
header
required

Query Parameters

cursor
string

Cursor value obtained from the X-Pagination-Next response header of a previous request, used to continue pagination. Cursors expire after 24 hours. If a cursor has expired or is invalid, pagination must be restarted from the beginning.

page_size
integer
default:20

Maximum number of results per page (read-only; defined by the endpoint, actual count may be lower in some cases like throttling or internal limits).

Required range: 20 <= x <= 20

Body

application/json
parameters
object
identity_ids
string<uuid>[] | null

An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.

Example:

Response

Successful response

participants
object[]
linkedin_thread_id
string
linkedin_thread_url
string<uri>
read
boolean
total_received_messages
string
created_at
string<date-time>
last_activity_at
string<date-time>
last_message
object
unread_count
integer
sponsored
boolean