Subscribe users

Encourage users to subscribe for your push notifications or emails

Once the project is configured and the SDK is integrated, provide users can subscribe to your push notifications and emails โ€” otherwise, you won't be able to communicate with them.


To encourage users to opt-in for push notifications, preface the default opt-in popup of the device's OS with a custom-made in-app message. Explain the benefits that come with opting in for your push notifications โ€“ this can increase the user's willingness to subscribe to your messages.

To register users for mobile pushes, use the registerDevice API method.

To migrate the existing mobile user base to a newly created or any other project, please follow this article.


To provide your website visitors can opt-in for push notifications, implement the custom or default Subscription Prompt on your site. The prompt triggers the native subscription request pop-up in the user's browser, which, in turn, enables or blocks web push notifications for your site.

To register users for web pushes, use the registerDevice API method.

Web users cannot be imported due to technical limitations of web platform โ€” push providers use different payload formats as well as platform configuration, which makes import basically useless, as the user base would be either invalidated or would be receiving blank/wrong content.


To let users subscribe to your emails, collect their emails by custom opt-in form and use the registerEmail or registerEmailUser API method.

To import the existing email user base, upload a CSV file with users' emails.

Please note that the registerEmailUser request does not register an email address in your userbase; it should be used only to assign User IDs to emails already registered by the registerEmail call.

To associate your app users or site visitors with their email addresses, use the User IDs. That allows you to build cross-channel Customer Journeys and send emails based on user's actions in your app or on the website.

1. Get the User ID.

Each device registered for your Pushwoosh project has its User ID; by default, it's equal to the device hardware ID (HWID) and is retrieved by the registerDevice API request.

To set a custom User ID, call the registerUser method.

2. Assign the User ID to an email address.

Use the registerEmail or registerEmailUser API method to associate the User ID with an email address.

3. Thatโ€™s it!

The same User ID is assigned to a particular device and a specified email address. That means Pushwoosh considers both app user and email addressee the same person so you can reach out to them by pushes and emails within a cross-channel Customer Journey.

Last updated