---
title: "Branch connection guide"
slug: "branch-connection-guide"
description: "Connect your Branch data to Supermetrics with our guide. Learn about permissions, query types, and connection instructions for seamless data integration."
updated: 2026-05-06T11:43:02Z
published: 2026-05-06T13:26:01Z
---

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

# Branch connection guide

This guide contains all permissions and requirements for connecting your Branch data to Supermetrics.

You can connect to data sources from the [Data sources page on the Supermetrics Hub](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-authentication-link) to connect to a data source you don't have direct access to.

After you connect to the data source on the Hub, you can use the data source connection in [all available destinations](/v1/docs/branch-connection-guide#connection-instructions).

## Required permissions

To connect Supermetrics to your Branch account, you'll need a Branch key and secret. Get the key and key secret from **Branch Dashboard → Account Settings → Profile**.

To access the Query API, you need to have both Aggregate Data and Export access. [Learn more about the Query API in Branch help](https://help.branch.io/developers-hub/reference/query-api).

## Query types

Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data:

- **Summary (total)**: Get the raw organic data for app analytics from the Branch summary dashboard.
- **Summary (unique)**: Get the unique data for app analytics from the Branch summary dashboard.

[Learn more about the Branch dashboard and the relevant query types and filters to use with Supermetrics](/v1/docs/about-api-rate-limits-and-discrepancies-in-branch).

## Connection instructions

When connecting to Branch, you need to provide your Branch key and secret.

1. Select the Branch data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. Enter your Branch key and secret.
3. Give your login a name to recognize the login later in case you have multiple logins.
4. If prompted, choose to make this connection [shared or private](/v1/docs/about-shared-and-private-connections).
5. Click **Start**.
6. In your data destination, select the query type to use.

See detailed instructions on [how to connect to a data source from the Supermetrics Hub.](/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub)

You can also connect to Branch from these destinations:

- Google Sheets: [How to log in to a Supermetrics data source in Google Sheets](/v1/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets)
- Excel: [How to connect data sources to Excel with Supermetrics](/v1/docs/how-to-connect-data-sources-to-excel-with-supermetrics)
- Power BI: [How to create your first Supermetrics query for Power BI](/v1/docs/how-to-create-your-first-supermetrics-query-for-power-bi)
- The Supermetrics API: [How to use the Query Manager](/v1/docs/how-to-use-the-query-manager)
- Data warehouse and cloud storage (Hub): [How to create a transfer](/v1/docs/how-to-create-a-transfer)
- BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](/v1/docs/how-to-create-a-bigquery-marketplace-transfer)

## More resources

- [About API rate limits and discrepancies in Branch](/v1/docs/about-api-rate-limits-and-discrepancies-in-branch)
- [How to reauthenticate a data source in Google Sheets, Looker Studio, Excel, or Power BI](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-google-sheets-looker-studio-excel-power-bi-and-supermetrics-hub)
- [How to reauthenticate a data source in data warehouse, API, or cloud storage platform](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-data-warehouse-destinations-or-the-supermetrics-api)
- [How to manage data source connections on the Supermetrics Hub](/v1/docs/how-to-manage-data-source-connections-on-supermetrics-hub)