Notification Types

AspFox creates notifications automatically from backend events. Notifications are tenant-scoped — a user only sees notifications for their currently active tenant.

Notification type reference

Type	Title	When created	Who receives it	Action URL
`MemberInvited`	Invitation sent	`InviteMemberCommand` succeeds	Tenant owner only	`/settings/members`
`MemberJoined`	New member joined	`AcceptInvitationCommand` succeeds	All tenant members	`/settings/members`
`MemberRemoved`	Member removed	`RemoveMemberCommand` succeeds	The removed user only	None
`OwnershipTransferred`	Ownership transferred	`TransferOwnershipCommand` succeeds	New owner and former owner	None
`SubscriptionUpgraded`	Subscription activated	`checkout.session.completed` webhook	All tenant members	None
`SubscriptionCanceled`	Subscription canceling	`customer.subscription.updated` webhook (cancel_at_period_end=true)	Tenant owner only	None
`SubscriptionPastDue`	Payment failed	`invoice.payment_failed` webhook	Tenant owner only	`/billing`
`SubscriptionTrialExpiring`	Trial ending soon	`TrialExpiryJob` (7-day and 1-day warnings)	Tenant owner only	`/billing`
`PaymentRecovered`	Payment successful	`invoice.payment_succeeded` webhook when previous status was PastDue	Tenant owner only	None

Who receives each notification

Tenant owner only — notifications that require action from the owner, or that contain billing information the owner needs to act on. MemberInvited, SubscriptionCanceled, SubscriptionPastDue, SubscriptionTrialExpiring, PaymentRecovered. All tenant members — notifications about workspace activity that is relevant to everyone. MemberJoined, SubscriptionUpgraded. Specific user only — notifications targeted at a single individual. MemberRemoved goes to the member who was removed. OwnershipTransferred goes to both the new owner and the former owner.

Notification payload

Each notification in the API response includes:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "type": "SubscriptionPastDue",
  "title": "Payment failed",
  "message": "Your Pro subscription payment failed. Please update your payment method.",
  "isRead": false,
  "actionUrl": "/billing",
  "createdAt": "2025-05-01T09:00:00Z"
}

actionUrl is null for notification types that do not have one. The frontend renders a clickable link when actionUrl is present.

How to add a notification type

See Notification System → How to add a new notification for the step-by-step guide.

​Notification type reference

​Who receives each notification

​Notification payload

​How to add a notification type

Notification type reference

Who receives each notification

Notification payload

How to add a notification type