latestOpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.8 MB

a1e86af2406d

contacts

Bulk update contacts

Update multiple contacts at once in one call instead of looping per contact. Same fields as single update, max 500 contacts per request. To discard named or picked people, set update.lifecycleStage to "rejected" (optionally with update.qualificationNotes explaining why) — discarding is reversible, it never deletes the contact, and the row still shows up in the list marked as not a fit. To undo a named not-a-fit mark, set update.lifecycleStage to "contact". A described rule is not a write: peek then propose with filter_contacts intent:"discard" or exceptContactIds. lifecycleStage, hotScore, and qualificationNotes are per-campaign fields: pass campaignId to scope the write to one campaign, or the request is rejected.

patch/contacts/bulk

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

contactIdsstring[] required

Contact IDs to update

Response

Bulk update results

successtrue required
updatedinteger required
skippedinteger required
errorsstring[] 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.