Competitor Watches

Watch competitors’ LinkedIn posts and turn the people engaging with them into leads.

Tools (3)

get_competitor_watches

Full name: campaignstack_get_competitor_watches

competitors:read Read-only

Get competitor watches with optional ids, filters, pagination, and a bounded latestPosts include. Use this before changing a watch so the named target and current state can be read back.

Parameters

Name	Type	Required	Default	Description
ids	string[]	No	—	Optional competitor watch ids to fetch.
filters	object	No	—
filters.workspaceId	string	No	—	Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too.
filters.status	active | paused	No	—
filters.entityType	company | influencer	No	—
include	object	No	—
include.latestPosts	object	No	—	Include the latest posts for each returned competitor watch.
limit	integer	No	50	Maximum items to return, capped at 100. (min: 1, max: 100)
cursor	string	No	—	Opaque pagination cursor. (min length: 1, max length: 1000)

---

edit_competitor_watch

Full name: campaignstack_edit_competitor_watch

competitors:write

Create competitor watches, pause/resume them, or assign LinkedIn accounts used by CampaignStack to observe those competitors. Call this for reversible competitor watch changes. It does not delete watches; use campaignstack_delete_competitor_watch for removal. Batch edits are bounded. Return one result per requested item, and report partial failures instead of describing the whole batch as successful.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	No	—	Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too.
operations	operation[]	Yes	—	One or more operations, see below.

Operations (operations[].mode)

create

Name	Type	Required	Default	Description
linkedinUrl	string	Yes	—	(min length: 1)
name	string	Yes	—	(min length: 1)
entityType	company | influencer	Yes	—
linkedinAccountIds	string[]	No	—	Reads with: LinkedIn account IDs that open watched competitor pages and collect engagers. Defaults to backend automatic selection.
sendAccountIds	string[]	No	—	Sends from: LinkedIn account IDs the engagers hear from when the watch creates a new signal agent. Omit to collect engagers without contacting anyone.

set_status

Name	Type	Required	Default	Description
watchId	string	Yes	—	(min length: 1)
status	active | paused	Yes	—

set_accounts

Name	Type	Required	Default	Description
watchId	string	Yes	—	(min length: 1)
linkedinAccountIds	string[]	Yes	—

---

delete_competitor_watch

Full name: campaignstack_delete_competitor_watch

competitors:write Destructive Needs confirmation

Delete competitor watches and disable their scheduled automations. Call this only after the user confirms the exact watches to remove. This permanently deletes a root record. Before calling it, name exactly what will be deleted, explain that it cannot be undone, and wait for an explicit yes. Batch edits are bounded. Return one result per requested item, and report partial failures instead of describing the whole batch as successful.

Parameters

Name	Type	Required	Default	Description
workspaceId	string	No	—	Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too.
watchIds	string[]	Yes	—
confirmed	boolean	Yes	—	This permanently deletes a root record. Before calling it, name exactly what will be deleted, explain that it cannot be undone, and wait for an explicit yes.

---