Platform: LinkedIn only. People watchlists track LinkedIn profiles; there is no Reddit equivalent. For topic tracking on LinkedIn use
/api-keyword-watchlist, on Reddit use /api-reddit-watchlist. See Choose a watchlist type.Request Body
string
required
Watchlist ID to update
array
Profiles to start tracking. Same identifier formats as create: LinkedIn URL, profile slug, full URN, or bare URN id. An entry that is already on the watchlist is skipped rather than duplicated.
array
Profiles to stop tracking, in the same identifier formats. A profile is matched on any identifier it is known by, so a row created from a URN can be removed by the slug enrichment has since given it. Removing a profile deletes its collection tasks; posts already collected stay on the watchlist.
string
New watchlist name
boolean
Set to
true to disable the watchlist, false to enable it. Pausing stops every collection task on the watchlist and flips disabled to true on the type’s GET endpoint, with disabledAt carrying the timestamp on the list response.number
New fetch frequency. Allowed values:
1, 3, 6, 12, 24, 48, 72.string | null
Update or clear the Slack webhook URL for this watchlist. Pass
null to clear.add_profiles, remove_profiles, name, fetchFreqInHours, disable or slack_webhook_url, otherwise the request is rejected with 400 No valid update fields provided.
Editing members
Removals are counted before the caps are checked, so swapping members in one call works even on a full watchlist: sending 10 removals and 10 additions on a list of 200 is accepted. Nothing is written until both caps pass, so a request that would overflow changes nothing at all.Limits
The team allowance is the real ceiling: free 400, growth 1,000, expert 4,000, ultimate 20,000, counting every profile and company on every watchlist you own. Spreading the same people across more watchlists does not raise it, which is why the per-watchlist
400 quotes that budget instead of suggesting another list. When you need more than your plan allows, upgrade rather than sharding.
The budget sentence is dropped for teams whose plan limits are waived, so the 400 can end at “Send fewer profiles.”
Response Fields
string
Watchlist ID that was updated
string
Updated watchlist name
number
Updated fetch frequency (only present when
fetchFreqInHours was in the request).boolean
Current active/disabled status
number
Profiles this call started tracking.
0 when add_profiles was not sent.number
Profiles this call stopped tracking.
0 when remove_profiles was not sent.number
How many profiles the watchlist holds after the change. This is the true total, so use it rather than adding
added to a count you cached.array
The raw input strings that changed nothing, exactly as you sent them. An entry lands here when it could not be parsed into a LinkedIn identifier, when it appeared twice in the same request, when an addition is already on the watchlist, or when a removal is not on it. An empty array means every identifier you sent was acted on.
boolean
Whether the update was successful
string
Success message
Error Responses
Frequently Asked Questions
What properties can I update on a people watchlist?
What properties can I update on a people watchlist?
add_profiles, remove_profiles, name, fetchFreqInHours, disable and slack_webhook_url, in any combination. Everything except id is optional and omitted fields are left alone.How do I replace the whole membership?
How do I replace the whole membership?
Read the current members with
GET /api-people-watchlist?id=..., then send the ones you no longer want as remove_profiles and the new ones as add_profiles in a single call. Removals are applied before the caps, so a full swap on a full watchlist is accepted.Does updating a watchlist reset existing collected data?
Does updating a watchlist reset existing collected data?
No. Renaming, pausing, adding or removing profiles does not delete posts already collected. Removing a profile stops future collection for that person; their existing posts stay on the watchlist and remain readable through the Posts API.
What is list_id on the create endpoint for?
What is list_id on the create endpoint for?
It is the older way to add profiles to an existing list, from before this endpoint could edit members. It still works. For adding and removing on a watchlist you already have,
add_profiles and remove_profiles here are the path to use: they name the watchlist directly and tell you what actually changed.