Push notifications let you reach and re-engage users even when they aren't actively using your app. The Connect SDK for Cordova integrates with Apple Push Notification service (APNs) on iOS and Firebase Cloud Messaging (FCM) on Android. Your marketing team can author push content - thumbnail images, expandable rich content and actionable notifications - from Connect without any code changes per campaign.

Language: JavaScript, with TypeScript definitions

Availability: Pro, Premium and Ultimate

Choose your guide

Setup is platform-specific, so each has its own guide:

Prerequisites common to both guides

Connect app key that supports push notifications. Push requires an app key from a Mobile app integration created after April 2026 - earlier "Web and mobile" integrations don't support push. For instructions, see Connect mobile apps in the Connect user guide.
The Connect Cordova plugin integrated in your project. If you haven't yet, see Integrate the Connect SDK into a Cordova app first.

Platform-specific prerequisites - a Firebase project for Android, an Apple Developer Program membership for iOS - are covered in each individual guide.

Push modes

Platform	Automatic	Manual
iOS	✓ (default)	✓ - your app owns `UNUserNotificationCenter.delegate` and forwards events via `AcousticConnect.push.didReceiveNotification()` / `didReceiveResponse()`.
Android	✓ (default and only mode)	Not supported. `enable()` rejects `'manual'` on Android with `ACOUSTIC_INVALID_ARGS` ("Android only supports automatic mode").

Set the mode for iOS with iOSPushMode in ConnectConfig.json ('automatic' or 'manual'). Android always uses automatic mode regardless of this setting.

After setup

Push delivery on its own sends to anonymous contacts. To target push notifications at known users, identify them - see Identify users at sign-in and Identify users at registration.

Once push is set up, Connect records signals for each notification automatically, with no extra code: Mobile push send, delivery, open and failure. Delivery and open appear only after the push setup in your platform guide is complete. An open is a tap on a notification that opens your app or the phone dialer. On iOS, the Notification Service Extension from the iOS guide records deliveries that are dismissed without a tap. To use these signals in segments, see Segment by customer actions.