Sign in

v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB
contacts

Update a contact

Update lifecycle stage, hot score, notes, outreach status, follow-up date, tags, or profile data for a contact..

patch/contacts/{id}

Path parameters

idstring required

Contact ID

Request body

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

Promote to new stage (forward-only, except rejected)

hotScoreinteger
qualificationNotesstring
leadBriefstring

Human-readable lead summary 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' | 'converted' | 'not_interested'

Manual outreach status override

nextFollowUpAtstring date-time nullable

When agent should follow up (null to clear)

doNotContactboolean

Flag contact as do-not-contact

Response

Updated contact

successtrue required
creditsUsedinteger required

Credits consumed by this call (always 0 for contacts queries).

retryAfterinteger required

Seconds to wait before next call of the same type (always 0 for contacts queries).