Quick Start Guide

Start with a notification preview and create your campaign draft. Connect a push provider and prepare your audience when you are ready to start sending.

1. 1

   Create your account

   Sign up at pushpilot.ai/login using Sign in with Google or Continue with email. The email option sends you a sign-in code. A workspace (organisation) is created for you automatically.

   Eligible new accounts receive a trial when a trial plan is available. No credit card is required to start. Check Settings → Billing for your current plan and trial end date.

2. 2

   Preview your first notification

   On the dashboard, the optional welcome panel asks for your website, app store link, or app ID. Choose Create my preview to generate a notification before connecting Firebase or OneSignal.

   If your workspace has no business context yet, creating the preview saves your app information there. Existing business context stays intact. You can edit it on the Business Context page.

   You can edit the preview's title and message, or choose Change app to try another source. Your brief and preview are kept in this browser for the current workspace when browser storage is available. They are not a saved campaign and do not schedule or send anything. Choose Explore workspace to skip the welcome panel and look around.

3. 3

   Create your first campaign

   Choose Continue to campaign builder after your preview, or open the AI Campaign Builder from the dashboard. Your preview can become the starting point for your draft. Describe your goal, for example "Re-engage users who haven't opened the app in 7 days." The AI will suggest a campaign strategy, write notification copy, and configure the schedule. Connect your project and choose an audience when you are ready to start the campaign.

   Alternatively, go to Campaigns → New Campaign and set up the details manually.

4. 4

   Connect a push provider

   When you are ready to start sending, go to Connections in the dashboard sidebar and connect at least one push provider. A provider is not needed to create your draft:

   • Firebase (FCM): upload your service account JSON. See Firebase setup guide →
   • OneSignal: connect via your Organisation API Key or directly with an App ID. See OneSignal guide →
5. 5

   Integrate the mobile SDK

   PushPilot delivers notifications via FCM topics (for Firebase) or OneSignal segments. Your app must subscribe devices to the correct topic/segment during initialisation.

   The minimum required step for Firebase is subscribing to the all topic on every device:

   Flutter exampleCopy

   // Add to pubspec.yaml:
   //   firebase_messaging: ^14.0.0
   
   import 'package:firebase_messaging/firebase_messaging.dart';
   
   Future<void> initPushPilot() async {
     final messaging = FirebaseMessaging.instance;
     await messaging.requestPermission(alert: true, badge: true, sound: true);
     await messaging.subscribeToTopic('all');
   }

   View SDK snippets for all platforms (Flutter, React Native, Android, iOS) →
6. 6

   Activate and send

   Review the campaign goal, audience, dates, send time, and timezone, then activatethe draft campaign. PushPilot begins generating upcoming notifications in the Scheduledstate. You can review and edit them before their send time; each message does not require a separate approval.

   Check campaign activity and notification status in the dashboard. The Analytics page shows available delivery and engagement data; open and click reporting depends on tracking events from your app.