Remove FCM Token

​

Overview

• User logs out
• User disables push notifications
• App is uninstalled (if possible to detect)

​

Use Cases

• User Logout: Remove device token to stop receiving notifications
• Disable Notifications: User opts out of push notifications in settings
• Device Cleanup: Remove old/unused device registrations

​

Important Notes

​

Example Usage

​

React Native/Expo

import * as Device from "expo-device";

// On logout
async function handleLogout() {
  // Remove FCM token
  await fetch("/api/notifications/remove-fcm-token", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      deviceId: Device.deviceId,
    }),
  });

  // Continue with logout...
}

​

Using React Hook

import { useRemoveFCMToken } from '@/hooks/notifications/useFCMTokenRegistration';

function LogoutButton() {
  const { mutate: removeToken } = useRemoveFCMToken();

  const handleLogout = () => {
    removeToken(Device.deviceId, {
      onSuccess: () => {
        console.log('Token removed successfully');
        // Continue with logout
      },
    });
  };

  return <Button onPress={handleLogout}>Logout</Button>;
}

​

Behavior

1. Device token is deleted from user’s fcmTokens map in Firestore
2. Device will no longer receive push notifications
3. Other registered devices remain active and continue receiving notifications
4. Operation is idempotent - safe to call multiple times

​

Related Endpoints

• Register FCM Token - Register device for notifications
• Update FCM Token Usage - Track active devices

​

See Also

• FCM Push Notifications Guide - Complete implementation guide
• Token Lifecycle Documentation - Token management best practices