​
Integrate alerts inbox via API

Build notification inbox functionality using Dialect’s REST API. This approach provides flexibility for applications that need server-side user management, custom authentication flows, or integration with non-JavaScript environments.

​
Why Use the REST API for Integration?

​
Use-Cases

  • Server-side user subscription management
  • Custom authentication and user flows
  • Non-React or non-TypeScript applications
  • Microservices handling user notification preferences
  • Backend services managing notification history and read states

​
Key Capabilities

  • User Authentication: Wallet-based authentication with JWT tokens
  • Subscription Management: Subscribe/unsubscribe users to apps and channels
  • Topic Management: Manage notification categories and user preferences
  • Notification History: Retrieve, mark as read, clear, and manage user notifications
  • Push Notifications: Complete mobile push notification setup

​
Prerequisites

Before integrating the notification inbox API, ensure you have completed:
  • App Registration: Your app must be registered with Dialect (registration guide)
  • Client Key: Obtain your client key for API authentication

​
Integration Guide

Follow this recommended implementation flow:
  1. Authentication - Set up wallet-based user authentication using JWT tokens and client keys
  2. User Management - Understand subscription, channel, and topic management (see API tabs in each section)
  3. Notifications - Retrieve notification history and manage read states
  4. Push Notifications - Complete mobile push notification integration

​
API vs SDK vs Components

Choose the API approach when you need:
  • ✅ Server-side user management
  • ✅ Custom authentication flows
  • ✅ Non-JavaScript/React environments
  • ✅ Microservices architecture
  • ✅ Full control over user data and flows
Consider the alternatives:

​
What’s Next?

Ready to start building? Begin with Authentication to set up wallet-based user authentication, then explore the comprehensive user management capabilities in our User Management guide.