chat

Find a conversation with a specific person

Changed on

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

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/chats/linkedin/find
  • Auth: HTTP bearer

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 this call spent, net of anything given back. 0 when nothing was charged: a free read, a cached answer, nothing delivered.

retryAfterinteger required

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

Changes