Update FCM Token Usage

Documentation Index

Fetch the complete documentation index at: https://docs.traza.com.au/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Use Cases

• Activity Tracking: Monitor which devices are actively in use
• Token Cleanup: Identify stale tokens that haven’t been used in a while
• Analytics: Track user engagement across multiple devices
• Token Management: Maintain accurate device activity records

​

When to Call

• App launch (update token usage on startup)
• Periodic background tasks (e.g., once per day)
• After receiving push notifications (device is active)

​

Example Usage

​

Basic Usage

import * as Device from "expo-device";

// Update token usage on app startup
async function updateTokenUsage() {
  await fetch("/api/notifications/update-fcm-token-usage", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      deviceId: Device.deviceId,
    }),
  });
}

​

Using React Hook

import { useUpdateFCMTokenUsage } from '@/hooks/notifications/useFCMTokenRegistration';
import { useEffect } from 'react';

function App() {
  const { mutate: updateUsage } = useUpdateFCMTokenUsage();

  useEffect(() => {
    // Update usage on app mount
    updateUsage(Device.deviceId);
  }, []);

  return <YourApp />;
}

​

Periodic Updates

import { useEffect } from "react";
import { AppState } from "react-native";

function useTokenUsageTracking(deviceId: string) {
  const { mutate: updateUsage } = useUpdateFCMTokenUsage();

  useEffect(() => {
    // Update when app comes to foreground
    const subscription = AppState.addEventListener("change", (nextAppState) => {
      if (nextAppState === "active") {
        updateUsage(deviceId);
      }
    });

    return () => subscription.remove();
  }, [deviceId, updateUsage]);
}

​

Behavior

1. Only the lastUsed timestamp is modified
2. Token itself and other metadata remain unchanged
3. Operation is idempotent - safe to call frequently
4. Fails silently if token doesn’t exist (returns success anyway)

​

Future Use Cases

• Automatic Cleanup: Remove tokens not used in 90+ days
• Analytics Dashboard: Show active devices per user
• Security Monitoring: Detect unusual device activity
• User Notifications: Alert users about unrecognized devices

​

Related Endpoints

• Register FCM Token - Register device for notifications
• Remove FCM Token - Remove token on logout

​

See Also

• FCM Push Notifications Guide - Complete implementation guide
• Token Management Best Practices - Token lifecycle documentation