contacts

Discard or restore people, in bulk

Mark people not a fit, or bring them back, in one call instead of looping per person. Max 500 people 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. The write lands on this conversation's own list; you never need to name one.

patch/contacts/bulk

Query parameters

campaignIdstring

Scopes the write to one list. Omit it: a chat turn writes to the list of the conversation it is in.

Scopes the write to one list. Omit it: a chat turn writes to the list of the conversation it is in.

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.

Changes