Skip to content

Preferences

Endpoints

GET /api/v1/notification-preferences
PUT /api/v1/notification-preferences

Preference rows

A preference is a tuple of (user, channel, type, enabled). The unique constraint is (uid, channel, type), so flipping the row toggles that exact combination.

Event types

TypeTriggered by
payment.requestedManual payment proof submitted by an admin.
payment.rejectedAdmin rejects a manual payment.
subscription.activatedStripe / PayTR / Iyzico webhook reports a successful charge.
trial.endingSoon3 days before trial expiry.
trial.expiredTrial period ends.
quota.warningA workspace quota crosses 80 % used.
team.invitationAn invitation email has been sent.
marketplace.order_receivedSeller receives a new order.
newsManual broadcasts from the admin (release notes, downtime windows).

Defaults

All channels enabled for every type for new users. Toggle off the chatty ones (news, quota.warning in some workspaces) per personal preference.