👤 Managing Users

The Users section of the NotificationAPI dashboard provides a comprehensive interface to view, search, and manage your application’s end-users. It allows you to inspect complete logs of all notifications a user has received, manage notification preferences, manage the suppression list, and delete user data, all from a single dashboard.

Key Features

  • User List & Search: Instantly view all users who have interacted with your notifications. Use the search bar to filter users by ID, email, or phone number.
  • Environment Selection: Switch between different environments (e.g., Production, Staging) to view users specific to each environment.
  • Suppressed Users Filter: Use the “Show Only Suppressed Users” checkbox to filter and display only users who are currently suppressed from receiving emails.
  • Suppression Reason: View the reason for a user’s email suppression directly in the table.
  • Remove Suppression: For suppressed users, use the “Remove Suppression” button to clear their suppression status and allow them to receive emails again.
  • User Preferences: Open a user’s notification preferences in a popup to view or update their channel and notification settings.
  • Push Status: See at a glance which users have enabled push notifications on web or mobile (Chrome, Apple, Android icons).
  • User Data Deletion: Permanently delete a user’s data, including their in-app notifications and preferences.

How It Works

  • Automatic User Creation: Users are automatically added when you send them a notification or when they open apps (React, mobile) you have integrated with NotificationAPI.
  • Manual Management: You can also manage users directly via our APIs. Learn more in the User Management APIs section below.

User Management APIs

Users can be managed through multiple API actions:

  • Identify User: Create or update user information including email, phone number, and other properties
  • Delete User Data: Permanently delete all user data including notifications and preferences
  • Remove from Suppression List: Remove users from the email suppression list to allow them to receive emails again

Best Practices

  • Before removing a user from the suppression list, verify and correct the underlying issue that caused the suppression (such as fixing an invalid email address or confirming the user wants to receive emails). Only remove suppression if you are confident the user can and wants to receive your emails. In the dashboard, use the “Remove Suppression” button for the user after resolving the issue.
  • Use the environment selector to avoid accidental changes in production.
  • Deleting a user is irreversible — use with caution.

FAQ

Why are some users’ emails suppressed?

Users’ emails may be suppressed if previous delivery attempts to their address have failed (e.g., due to invalid email addresses, hard bounces, or repeated soft bounces), or if they have unsubscribed or marked your emails as spam. Suppression helps maintain your sender reputation and ensures compliance with email best practices.