Sign in
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, duplicates, and for every query that does not touch LinkedIn.

retryAfterinteger required

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

Changes

Changed in 3 of the 11 revisions of this API.1111

  • 62bf7284843d1See the full diff
    • ▲

      removed the required property _meta/credits/accountPlan from the response with the 200 status

      response-required-property-removed

  • d5f1141f87e311See the full diff
    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 409

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 410

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 422

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 502

      response-property-enum-value-added

    • ●

      added the new pacing enum value to the error/quotaKind response property for the response status 503

      response-property-enum-value-added

  • 1ad91026000b1See the full diff
    • ○

      added the optional property _meta to the response with the 200 status

      response-optional-property-added

Of the 11 revisions, 1 has no diff computed.