v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB

chat

Find a conversation with a specific person

Find a conversation with a specific person by profile URL or URN. Optionally returns messages from the found conversation (includeMessages: true). When following up on a previously listed conversation, extract the profile URL or URN from the earlier result and pass it here — do NOT ask the user to re-type the name.

post/chats/linkedin/find

Request body

profilestring required

Accepts full profile URLs, vanity names (e.g. marie-sandre), or profile URNs.

includeMessagesboolean

If true, also return the conversation's recent messages.

Response

Conversation found (or not)

successtrue required

foundboolean required

prevCursorinteger nullable

deliveredAt timestamp (ms) of the oldest message — pass as 'deliveredAt' to load older messages. Only present when includeMessages is true.

userProfileUrnstring

The authenticated user's profile URN. Useful for determining message direction.

creditsUsedinteger required

Credits consumed by this call (0 for free endpoints, cached results, or duplicates).

retryAfterinteger required

Seconds to wait before making another call of the same type. 0 means no wait needed.