latestOpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.8 MB

a1e86af2406d

contacts

Update a contact

Update optional Fit / not-a-fit, notes, outreach status, tags, or profile data for a person in the list.

patch/contacts/{id}

Path parameters

idstring required

Contact ID

Request body

lifecycleStage'contact' | 'lead' | 'qualified' | 'rejected'

Optional Fit / not-a-fit filter. Not an outreach gate. Fit still requires notes and a brief.

hotScoreinteger

qualificationNotesstring

leadBriefstring

Short brief for sales prep

notesstring

namestring

Update contact name

{"stackTrail":"paths:/contacts/{id}:patch:requestBody:content:application/json:schema:properties:profileData","oasType":"schema","type":"unknown","description":"Full LinkedIn profile snapshot (JSON)"}

profileUpdatedAtstring date-time

When profileData was last refreshed

{"stackTrail":"paths:/contacts/{id}:patch:requestBody:content:application/json:schema:properties:conversationData","oasType":"schema","type":"unknown","description":"DM history (JSON: historySummary + recentMessages)"}

conversationUpdatedAtstring date-time

When conversationData was last synced

Manual outreach status override

doNotContactboolean

Flag contact as do-not-contact

Response

Updated contact

successtrue required

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.