How to integrate push notifications in Bubble

The simplest reliable way to add push notifications to a Bubble app is to use a third‑party service (most commonly OneSignal) together with a plugin or wrapper. Bubble cannot send native push notifications by itself. For web apps you use OneSignal’s Web Push; for mobile apps you use a native wrapper such as BDK Native or Air Native which exposes push tokens you can send notifications to.

How Push Notifications Work in Bubble

Bubble has no built‑in push engine. You must:

• Use a provider that collects the user’s device token (OneSignal or a native wrapper).
• Store this token in your Bubble database.
• Trigger a backend workflow that calls the provider’s API to send the notification.

Option A — Web Push Using OneSignal

• Install a real OneSignal Web Push plugin from the Bubble marketplace. These handle the service worker requirement (Bubble does not let you add your own service worker manually).
• In OneSignal, create an app and copy the App ID and API Key into the plugin settings.
• On page load, run the plugin’s “Register for push” action. It returns a Player ID. Save that to the Current User.
• Use the API Connector to call OneSignal’s REST API from a backend workflow.

// Example OneSignal send API body
{
  "app_id": "YOUR_ONESIGNAL_APP_ID",
  "include_player_ids": ["USER_PLAYER_ID"],
  "contents": { "en": "You have a new message!" }
}

Option B — Mobile Push Using Native Wrapper

• If your Bubble app becomes a native mobile app, use wrappers like BDK Native or Air Native.
• The wrapper plugin exposes a “Device Push Token”. Save it to the User in Bubble.
• Send notifications via the wrapper’s provided API (each wrapper gives exact API endpoints or plugin actions).

What to Store in Bubble

• Field on User: push\_token (text)
• Update it whenever the provider returns a new token.

When to Trigger Notifications

• Create a backend workflow “Send Notification”.
• Call the OneSignal API (or wrapper API) with the saved push\_token.
• Trigger that backend workflow from any event (new message, new order, etc.).