Skip to content

Notifications

Read notifications, set notification preferences, and see time spent in review.

Full name: campaignstack_get_notifications

notifications:read Read-only

Read notifications in a stable envelope with the unread count for the same caller. Use this when the user asks what needs attention; it does not change read state. Results are one page. When pagination reports more, say so rather than presenting the page as the whole set, and page through before counting anything.

NameTypeRequiredDefaultDescription
workspaceIdstringNo—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.
typepending_review | credits_exhausted | credits_low | trial_ending | account_risk | proxy_unreachable | connection_accepted | reply_received | workflow_notify | weekly_report | seo_weekly_advisory | signal_agent_stalled | lead_signal_alert | lead_magnet_fetch_degraded | background_job_degraded | company_fetch_degraded | meeting_bookedNo—
limitintegerNo20(min: 1, max: 100)
cursorstringNo—

Full name: campaignstack_get_review_time

notifications:read Read-only

Get the calling user’s time-in-review history: an 8-week series of minutes spent in the inbox review queue, this week’s decisions split by who made them (app, your agent via MCP, automatic), and whether minutes per decision fell from last week. Call this when the user asks how much time they’re spending reviewing drafts, or whether the queue is getting faster. Renders no series (empty weeks, distinctWeeksWithData omitted) until at least 2 weeks of data exist. Requires a USER API key (csu_); workspace keys have no user identity.

Takes no parameters.


Full name: campaignstack_edit_notifications

notifications:write

Mark notifications read by ids, or mark all notifications read for the resolved workspace. User-key and OAuth callers are restricted to their own notification rows plus legacy shared rows.

NameTypeRequiredDefaultDescription
workspaceIdstringNo—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.
idsstring[]No—
allbooleanNo—