Skip to content

Notifications

Read and acknowledge workspace notifications — list, count unread, and mark read.

Full name: campaignstack_list_notifications

notifications:read Read-only Idempotent

List notifications for a workspace. 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.

NameTypeRequiredDefaultDescription
workspaceIdstringNo
typepending_review | credits_exhausted | credits_low | trial_ending | account_risk | proxy_unreachable | connection_accepted | reply_received | workflow_notify | weekly_reportNo
limitnumberNo20(min: 1, max: 100)
cursorstringNo

Full name: campaignstack_count_unread_notifications

notifications:read Read-only Idempotent

Count unread notifications for a workspace. Returns the total number of unread notifications — useful for badge counts. Use campaignstack_list_notifications to see the actual notifications.

NameTypeRequiredDefaultDescription
workspaceIdstringNo

Full name: campaignstack_mark_notification_read

notifications:write Idempotent

Mark a single notification as read. Use campaignstack_list_notifications to find notificationId values. To mark all notifications read at once, use campaignstack_mark_all_notifications_read.

NameTypeRequiredDefaultDescription
notificationIdstringYes(min length: 1)

Full name: campaignstack_mark_all_notifications_read

notifications:write Idempotent

Mark all unread notifications in a workspace as read. Large backlogs are cleared asynchronously; the unread badge drops immediately. To mark a single notification read, use campaignstack_mark_notification_read instead.

NameTypeRequiredDefaultDescription
workspaceIdstringNo