Prerequisites
Before managing notifications, ensure you have:- App Registration: Your app must be registered with Dialect (registration guide)
- User Authentication: Users must be authenticated with JWT tokens (authentication guide)
Best Practices
Performance
Use pagination (25-50 per page), cache data, and implement virtual scrolling for large lists.
User Experience
Show unread counts, βmark all readβ buttons, and relative timestamps with graceful empty states.
Real-time Updates
Poll summary endpoint periodically and update local state optimistically when marking as read.
Notification History
Get Full Notification History
Retrieve paginated notification history for the authenticated user:appId
(optional): Filter notifications for a specific applimit
(optional): Number of notifications to return (default: 25, max: 50)cursor
(optional): Base64-encoded cursor for pagination
Pagination Example
Get Notification Summary
Get unread count and summary information without full notification data:appId
(optional): Filter summary for a specific app
Mark Notifications as Read
Mark all notifications as read for the authenticated user:appId
(optional): If provided, only marks notifications from this app as read
Clear Notification History
Clear all notifications for the authenticated user. This is a global action that applies across all clients:appId
(optional): Single app ID, array of app IDs, or omitted to clear notifications from all apps
Next Steps
With notification management in place, you can:- Setup Push Notifications - Enable mobile push notifications for your inbox
- Explore User Management - Manage user subscriptions and preferences