Sign in
latestOpenAPI 3.0.3AGPL-3.0 license2026-08-2211401.8 MB

32391e7c6322

contacts

Update a contact

Update optional Fit / not-a-fit, notes, outreach status, tags, or profile data for a person in the list. lifecycleStage, hotScore, qualificationNotes, and leadBrief are per-campaign fields: pass campaignId to scope the write to one campaign, or the request is rejected.

patch/contacts/{id}

Path parameters

idstring required

Contact ID

Query parameters

campaignIdstring

Scopes a per-campaign field write (lifecycleStage, hotScore, qualificationNotes, leadBrief) to this one campaign. Required whenever the update includes any of those fields.

Scopes a per-campaign field write (lifecycleStage, hotScore, qualificationNotes, leadBrief) to this one campaign. Required whenever the update includes any of those fields.

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

outreachStatus'none' | 'connection_sent' | 'connected' | 'dm_sent' | 'followed_up' | 'replied' | 'in_conversation' | 'meeting_booked' | 'not_interested'

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.