> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Firebase OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for Firebase in StackOne to allow users to link their accounts.

> [!WARNING]
>
> Owner or Editor access to the Firebase project is required to complete this setup.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create or select a Google Cloud project with Firebase

To use the Firebase REST APIs with OAuth 2.0, you need a Google Cloud project that has Firebase enabled.

**1. Sign in to Firebase Console**

Sign in to your [Firebase Console](https://console.firebase.google.com/).

**2. Create or select a project**

On the Firebase Console home page you can either pick an existing project from the **Projects and workspaces** list on the right (then skip to the next section), or create a new one by following the screen-by-screen wizard steps below.

<ul>
  <li>**Step 1 — Open the wizard:** on the Firebase Console home page (`console.firebase.google.com`), click the **Create a new Firebase project** card under **Get started**.</li>
  <li>**Step 2 — Enter a project name:** click the **Project name** field and type a name (for example, `StackOne Integration`).</li>
  <li>**Step 3 — Note the auto-generated project ID:** Firebase auto-generates a globally-unique project ID directly below the name (for example, `stackone-integration-e8265`). Copy this ID — you will need it for every project-scoped API call. Optionally click the pencil icon to customise it before the project is created.</li>
  <li>**Step 4 — (Alternative) Use an existing Google Cloud project:** if you already have a Google Cloud project, click **Add Firebase to Google Cloud project** at the bottom-left and pick that project instead of typing a new name.</li>
  <li>**Step 5 — Continue:** click **Continue** to advance to the next screen.</li>
  <li>**Step 6 — AI assistance:** the next screen is *AI assistance for your Firebase project*. Leave the **Enable Gemini in Firebase** toggle ON (the default) and click **Continue**.</li>
  <li>**Step 7 — Google Analytics:** the next screen is *Google Analytics for your Firebase project*. Leave the **Enable Google Analytics for this project** toggle ON (the default — required for the `get_analytics_details` action) and click **Continue**.</li>
  <li>**Step 8 — Configure Google Analytics:** the next screen is *Configure Google Analytics*. Pick a region from the **Analytics location** dropdown (default `United States` works for most users), leave the **Use the default settings for sharing Google Analytics data** checkbox ticked, then tick the **I accept the Google Analytics Terms** checkbox — this is required to enable the **Create project** button. Click **Create project**.</li>
  <li>**Step 9 — Wait for provisioning and open the project:** Firebase shows a *Preparing your project, please wait* spinner followed by *Finishing up…* (\~30–60s). When you see the green tick and **Your Firebase project is ready** message, click **Continue** to land on the **Project Overview** page.</li>
</ul>

**3. Note your Project ID**

In the left sidebar, hover over **Settings** (gear icon) to expand the submenu, then click **General**. This opens the **Project settings** page on the **General** tab — copy your **Project ID** from the **Your project** section. You will need it when calling project-scoped API endpoints.

## Enable the Firebase APIs

Navigate to **APIs & Services** > **Library**, search for each API below, click on it, then click **Enable**. If it already shows **Manage**, the API is already enabled.

<ul>
  <li>Firebase Management API</li>
  <li>Identity Toolkit API</li>
  <li>Google Cloud Firestore API</li>
  <li>Firebase Cloud Messaging API</li>
</ul>

## Configure Google Auth Platform

Before creating OAuth credentials, ensure Google Auth Platform is configured.

**1. Navigate to Google Auth Platform**

In the Google Cloud Console, go to **APIs & Services** > **OAuth consent screen**. This will open the Google Auth Platform dashboard.

**2. Start configuration**

If you have already configured Auth Platform (the OAuth Overview page with usage metrics is shown), skip this step and navigate to the **Branding** page from the sidebar. Otherwise, you will see a **Get started** button — click it to begin the configuration process.

**3. Enter app information**

Fill in the required fields for your application.

<ul>
  <li>**App name**: Enter a name for your application (e.g., StackOne Firebase Integration).</li>
  <li>**User support email**: Select an email for user inquiries.</li>
  <li>Click **Next** to continue.</li>
</ul>

**4. Select audience**

Choose the appropriate user type for your application.

<ul>
  <li>**Internal**: Only users within your Google Workspace organization can authorize (no app verification required).</li>
  <li>**External**: Any Google account can authorize (requires app verification for production use).</li>
  <li>Click **Next** to continue.</li>
</ul>

**5. Enter contact information**

Provide email addresses for Google to notify you about any changes to your project. Click **Next** to continue.

**6. Finish configuration**

Review your settings, agree to the Google API Services User Data Policy, and click **Create** to complete the setup.

## Configure scopes

In Google Auth Platform, go to **Data Access** and click **Add or Remove Scopes** to configure the OAuth scopes your application needs.

**1. Add scopes**

Enables actions: Batch Delete Users, Create Android App, Create Document, Create SHA Certificate, Create User, Create Web App, Delete Document, Delete User, Get Analytics Details, Get Android App, Get Android App Config, Get Document, Get Project, Get Web App, Get Web App Config, List Android Apps, List Available Projects, List Documents, List Projects, List SHA Certificates, List Users, List Web Apps, Lookup User, Query Users, Remove Android App, Remove Web App, Run Query, Search Apps, Send Message, Undelete Android App, Undelete Web App, Update Android App, Update Document, Update Project, Update User, Update Web App

Add the required Firebase scopes for your integration.

<ul>
  <li>
    [https://www.googleapis.com/auth/firebase](https://www.googleapis.com/auth/firebase)
  </li>

  <li>
    [https://www.googleapis.com/auth/firebase.readonly](https://www.googleapis.com/auth/firebase.readonly)
  </li>

  <li>
    [https://www.googleapis.com/auth/identitytoolkit](https://www.googleapis.com/auth/identitytoolkit)
  </li>

  <li>
    [https://www.googleapis.com/auth/datastore](https://www.googleapis.com/auth/datastore)
  </li>

  <li>
    [https://www.googleapis.com/auth/firebase.messaging](https://www.googleapis.com/auth/firebase.messaging)
  </li>

  <li>
    [https://www.googleapis.com/auth/userinfo.email](https://www.googleapis.com/auth/userinfo.email)
  </li>
</ul>

**2. Select scopes from the list**

In the **Update selected scopes** side panel that opens, check the required scopes from the list.

**3. Manually add scopes (if needed)**

If a required scope is not shown in the list, use the **Manually add scopes** section.

<ul>
  <li>Enter the full scope URL in the input field.</li>
  <li>Click **Add to table**.</li>
</ul>

**4. Apply and save**

Confirm and persist your scope configuration.

<ul>
  <li>Click **Update** to apply the selected scopes. The side panel will close.</li>
  <li>On the **Data Access** page, click **Save** to persist the scope configuration.</li>
</ul>

## Create OAuth 2.0 client credentials

Set up OAuth client credentials to authenticate with the Firebase APIs. If you already have an existing OAuth 2.0 client, you can reuse it by adding the StackOne redirect URI and generating a new secret.

**1. Navigate to Credentials**

In the Google Cloud Console, go to **APIs & Services** > **Credentials**.

**2. Option A — Create a new OAuth client**

Skip this step if you are using an existing client.

<ul>
  <li>Click **+ Create Credentials** and select **OAuth client ID**.</li>
  <li>Select **Web application** as the application type.</li>
  <li>Enter a **Name** for your OAuth client (e.g., StackOne Firebase Integration).</li>
  <li>Under **Authorized redirect URIs**, click **Add URI** and enter the **Callback URL** from your Connector Profile.</li>
  <li>Click **Create**. A dialog will display your **Client ID** and **Client Secret** — copy and store them securely.</li>
</ul>

**3. Option B — Use an existing OAuth client**

Skip this step if you created a new client above.

<ul>
  <li>Click on your existing OAuth 2.0 client ID from the list.</li>
  <li>Under **Authorized redirect URIs**, click **Add URI**, enter the **Callback URL** from your Connector Profile, and click **Save**.</li>
  <li>Under **Client secrets**, click **+ Add secret** to generate a new secret. Copy it and store it securely — it will not be shown again.</li>
  <li>Your **Client ID** is shown on the same page under **Additional information**.</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/firebase/guides/link-account/oauth-2-0.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.