How can I remove or clean up inactive device tokens from my application?

Cleaning inactive devices out of your audience keeps segmentation and reporting honest. Pushwoosh offers several options:

1. Automatic 90-day inactivity cleanup. If a user has not opened the app for 90 days or more, the push token is marked inactive and removed from the subscriber base (tracked via the default Last Application Open tag). If the user opens the app again, the SDK registers a new token and the device becomes reachable again. This algorithm is enabled by default for all accounts created on or after January 1, 2024; for older accounts, contact Pushwoosh support to check or request activation. Note: if you store tokens on your side or stream Pushwoosh data into your own systems, enabling the cleanup may require adjusting those processes.
2. One-off bulk cleanup for longer inactivity. For devices inactive far longer (for example 180 or 365 days), contact the Pushwoosh support team to arrange a one-time bulk cleanup.
3. Manual deregistration via API. Build a segment based on inactivity (or any other attribute) in the Control Panel, export the Hardware IDs (HWIDs), and unregister them with /bulkUnregisterDevice (many devices per request) or the single-device /unregisterDevice endpoint (parameters: application, hwid; Authorization: Token <Device API token>).

About cost: your subscription is billed on Monthly Active Users (MAU), not on the number of registered tokens. How MAU is counted depends on your plan: on push-only plans it is users who opened the app from a device with a valid push token in the 30 days before the end of the billing period; on omnichannel plans it also includes users who received an email, SMS or WhatsApp message. Each user counts once per project. Because a valid push token is part of the push MAU definition, cleanup affects billing only for users who were not active anyway; it mainly improves list hygiene, reporting and segment accuracy. See Monthly active users (MAU) for the exact definition, and review current usage in My account → Billing (Billing page). For plan questions, reach out to support or your account manager.