Skip to main content
Browse documentation

Guide

Notifications

Review durable workspace events and choose in-app or transactional email delivery by category.

On this page
  1. Prerequisites
  2. Review events
  3. Choose delivery
  4. Errors
  5. Next step

Prerequisites

Open Notifications from the console bell. Preferences belong to the current WorkOS user within the selected workspace, so changing one workspace does not overwrite another.

Review events

Team, security, billing, provider, webhook, MCP, and system events are stored with a source identity. The unread badge is calculated from persisted rows, and marking one or all items read updates that state on the server.

Choose delivery

Enable or disable in-app and email delivery for each category. Email is delivered asynchronously through Cloudflare Email Service. Transient rate limits and server failures use bounded exponential retries; validation and authentication failures stop instead of retrying forever.

Errors

  • A failed preference update leaves the previous server value in place.
  • A discarded email delivery remains operational evidence; it does not turn an already successful workspace action into a customer-visible failure.
  • WorkOS invitation email remains authoritative for accepting a team invitation.

Next step

Send a test invitation, confirm that it appears in the notification inbox, and verify the delivery category preference you intend to use in production.