Skip to main content

Account Setup Guide

This guide walks you through the process of setting up your SuperFCM account and integrating with Firebase Cloud Messaging to enable push notifications for your mobile applications.

1. Creating a SuperFCM Account​

  1. Visit SuperFCM and click on the Get Started button in the top-right corner
  2. Enter your email address and hit Sign in with E-Mail (or use the Login with Google)
  3. You will receive a magic link via e-mail - you do not need a password.
  4. Click on the Sign In button in the e-mail. Your account is now created and you are already signed-in.
tip

SuperFCM does not require or store any passwords and we will never prompt you to input any password.

2. Setting Up Your Organization​

Once you are signed in, you will need to set up your organization.

  1. Log in to the SuperFCM Dashboard
  2. You'll be prompted to create a new organization. Hit Create Organization
  3. Enter a name for your organization (you can change it again later)
  4. Click Save to proceed

Your organization serves as a container for all your apps and team members. This structure allows you to:

  • Manage multiple applications under a unified account
  • Invite and manage team members with different access levels (*)
  • Simplify billing and subscription management (*)

(* not available during early access)

3. Creating Your First App​

Once your organization is set up:

  1. From the Organization Dashboard, click Add First App
  2. Enter a descriptive name for your application (you can change it again later)
  3. Click Save to proceed
tip

You will require the App ID for integrating with the SDK or REST API. You can find and copy it from your app settings in the dashboard.

4. Firebase Cloud Messaging Integration​

warning

SuperFCM relies on Firebase Cloud Messaging (FCM) as the underlying delivery mechanism for push notifications. SuperFCM cannot work without FCM.

tip

The below setup steps need to completed, regardless of platform your app is running on. All messages are sent through your Firebase project.

To connect your app with FCM:

4.1. Create or Configure a Firebase Project​

Go to the Firebase Console

  • If you don't have a project yet, click Add project and follow the setup steps.
  • If you already have a project, select it and move to the next steps.

4.2 Ensure Firebase Cloud Messaging (FCM) API v1 is enabled​

  1. Click the gear icon (⚙️) next to Project Overview to access Project settings.
  2. Go to the Cloud Messaging tab.
  3. If the Firebase Cloud Messaging API (V1) shows as disabled, click the 3-dot menu > Open in Cloud Console.
  4. In the Cloud Console, click Enable (you may need to wait a few minutes for the action to propagate to Firebase systems).

4.3 Obtain Firebase Service Account Credentials​

To allow SuperFCM to communicate with Firebase on your behalf:

  1. Within the Firebase Console click the gear icon (⚙️) next to Project Overview to access Project settings.
  2. Select the Service accounts tab.
  3. Under Firebase Admin SDK, click Generate new private key.
  4. Confirm by clicking Generate key in the popup dialog
  5. A JSON file will be downloaded automatically - this contains your service account credentials.
  6. Store this file securely as it contains sensitive authentication information.
danger

Never commit this file to version control or share it publicly. It provides administrative access to your Firebase project.

4.4 Upload Firebase Service Account Credentials to SuperFCM​

Once you have your service account credentials file, it's time to upload it to SuperFCM to enable sending messages:

  1. From the Organization Dashboard pick the app you would like to upload credentials for.
  2. Via the apps' main menu on the left hand side go to Settings.
  3. Scroll down to Service Account Credentials and hit Add.
  4. In the dialog paste the contents of your service account credentials file (don't worry about extra keys in the file).
  5. Hit Save.
  6. Back on the settings page, scroll to Enable Sending and flip the switch.
warning

Early Access: At present, we do not validate the service account connection at this stage in the process.

success

You are now ready to send messages via Firebase. Switch over to Quickstart Guide to continue with the SDK integration in your Flutter app.

Need Help?​

If you encounter any issues or have questions, please contact us at info@superfcm.com or visit our GitHub repository for the Flutter SDK.