Delete Users
How to bulk delete users
This guide explains how to delete user records from OneSignal. If you want to delete segments without the user records see Deleting Segments.
Automatic User Deletion
OneSignal may delete users in apps that are deemed as being “inactive,” in-line with our Data Access and Retention Policy located in the OneSignal Privacy Policy
Deleting users cannot be reversed!
Once you delete users, there is no way to get them back. Deleted users can only get push again once they:
- Web: Clear browser cookies, then return to your site
- Mobile: Open the app again. We recommend being up to date on the latest version of OneSignal's SDK in the app.
Deleted users can only get email and sms again once you add their email address or phone number back into OneSignal.
WARNING: DO NOT DELETE ALL USERS
Be very careful when following these steps, make sure you do not delete all users.
Delete Users with the OneSignal API
To delete users with our API, see the Delete Users API Reference.
You can use the external_id, onesignal_id or any other alias you have set.
Delete Users with the OneSignal Dashboard
Navigate to Audience > Users.
Search for the External User ID you want to delete.
Next to each Subscription record, select the Options > Delete.
Bulk Delete Users within the OneSignal Dashboard
This guide details on how to delete multiple users and/or delete multiple subscriptions for a user within the OneSignal dashboard.
Create a Segment
See Segments for details on creating segments.
If you have a list of users, upload a CSV to add tags for segmentation.
If you want to delete older, inactive subscriptions, we recommend using the "Last Session" filter with greater than 4321 hours (6 months). Make sure to select greater than and NOT "less than".
Before deletion, we also recommend sending 2 notifications to this segment to try winning those users back.
View the Segment
When ready, select Options > View Users
In Audience > Users:
- Check that the correct Segment is selected.
- Select the arrow next to 'Update/Import Users' to reveal the dropdown
- Select Delete Users In Segment
A confirmation screen will appear showing how many users will be deleted and require you to input the name of the segment to confirm deletion.
WARNING: POINT OF NO RETURN!
Once you press Delete Users your users will be deleted.
This cannot be undone.
After clicking Delete Users a confirmation screen will appear and you will be sent an email confirming the deletion.
You cannot delete more than 1 segment at a time per app.
Updated over 1 year ago