Notifications
Read and acknowledge workspace notifications — list, count unread, and mark read.
Tools (4)
Section titled “Tools (4)”list_notifications
Section titled “list_notifications”Full name: campaignstack_list_notifications
List notifications for a workspace. Call this when the user asks what needs their attention. Returns paginated notifications most-recent first. Filter by type to see only specific notifications (e.g. pending_review, credits_exhausted, account_risk, reply_received). Use campaignstack_count_unread_notifications to get the unread badge count. Use campaignstack_mark_notification_read or campaignstack_mark_all_notifications_read to mark as read. 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.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. |
type | pending_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_booked | No | — | |
limit | number | No | 20 | (min: 1, max: 100) |
cursor | string | No | — |
count_unread_notifications
Section titled “count_unread_notifications”Full name: campaignstack_count_unread_notifications
Count unread notifications for a workspace. Call this when the user asks how many there are. It does not list them: campaignstack_list_notifications does that.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. |
mark_notification_read
Section titled “mark_notification_read”Full name: campaignstack_mark_notification_read
Mark a single notification as read. Call this when the user says to dismiss one specific notification. Use campaignstack_list_notifications to find notificationId values. To mark all at once, use campaignstack_mark_all_notifications_read instead.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
notificationId | string | Yes | — | (min length: 1) |
mark_all_notifications_read
Section titled “mark_all_notifications_read”Full name: campaignstack_mark_all_notifications_read
Mark all unread notifications in a workspace as read. Call this only when the user asks to clear the whole list, not just one item. Large backlogs clear asynchronously; the badge drops immediately. For a single notification, use campaignstack_mark_notification_read instead.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. |