Skip to content

Signal Agents

Create and manage signal agents (audiences) — the engagement-intelligence feature that watches posts/events and turns engagers into scored leads.

Full name: campaignstack_list_signal_agents

signals:read Read-only Idempotent

List all signal agents (audience intelligence watchers) for a workspace. Signal agents monitor LinkedIn profiles or company feeds and detect engagements. Returns agents with status, type, target info, and counters. Use campaignstack_get_signal_agent for full details, or campaignstack_get_signal_agent_stats for dashboard metrics.

NameTypeRequiredDefaultDescription
workspaceIdstringNo(min length: 1)
includeArchivedbooleanNo

Full name: campaignstack_get_signal_agent

signals:read Read-only Idempotent

Get a single signal agent with full details including status, target info, account assignments, response mode, and counters (posts watched, signals total). Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)

Full name: campaignstack_get_signal_agent_stats

signals:read Read-only Idempotent

Get dashboard metrics for a signal agent: total signals, signals in the last 24h, leads created, posts watched, and breakdown by priority (P0/P1/P2). Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)

Full name: campaignstack_list_signal_agent_leads

signals:read Read-only Idempotent

List leads discovered by a signal agent from its associated lead list. Returns lead records with entry metadata (status, createdAt) sorted newest first. Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)
limitnumberNo50(min: 1, max: 200)

Full name: campaignstack_create_signal_agent

signals:write

Create a new signal agent that monitors a LinkedIn profile, company feed, group, or post for engagements. Auto-generates a template workflow and lead list. target specifies what to watch: { platform: ‘linkedin’, kind: ‘profile’, urn: ’…’ } for profile/company feeds, { platform: ‘linkedin’, kind: ‘group’, url: ’…’, groupId: ’…’ } for groups, or { platform: ‘linkedin’, kind: ‘post’, url: ’…’, activityId: ’…’ } for specific posts. accountIds are the accounts that observe the feed; actAccountIds are the accounts that act on signals. Use campaignstack_list_accounts to find account IDs.

NameTypeRequiredDefaultDescription
workspaceIdstringNo(min length: 1)
namestringYes(min length: 1)
typeprofile_feed | company_feed | group_watch | post_engagementYes
targetobject | object | objectYes
targetNamestringYes(min length: 1)
responseModeauto_send | review_firstYes
accountIdsstring[]Yes
actAccountIdsstring[]Yes
publicReplyConfigobjectNo

Full name: campaignstack_update_signal_agent

signals:write Idempotent

Update a signal agent’s configuration. Only provided fields are updated. Can change name, response mode (auto_send / review_first), observing account list (accountIds), acting account list (actAccountIds), or public reply configuration. Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)
namestringNo(min length: 1)
responseModeauto_send | review_firstNo
accountIdsstring[]No
actAccountIdsstring[]No
publicReplyConfigobjectNo

Full name: campaignstack_pause_signal_agent

signals:write Idempotent

Pause a signal agent, stopping feed polling and workflow execution. The agent and its data are preserved — use campaignstack_resume_signal_agent to resume. Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)

Full name: campaignstack_resume_signal_agent

signals:write Idempotent

Resume a paused signal agent, re-enabling feed polling and workflow execution. Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)

Full name: campaignstack_delete_signal_agent

signals:write Destructive Idempotent

Archive (soft-delete) a signal agent. Stops polling, pauses the linked workflow, disables all watched posts, and clears competitor watch linkage. Data (signals, leads, posts) is preserved for audit. Use campaignstack_list_signal_agents to find agent IDs.

NameTypeRequiredDefaultDescription
agentIdstringYes(min length: 1)