---
title: "Braze connection guide"
slug: "braze-connection-guide"
description: "Connect your Braze data to Supermetrics with our guide on permissions, API keys, and query types for seamless data integration and analysis."
tags: ["Marketing automation"]
updated: 2026-08-06T06:13:18Z
published: 2026-08-06T06:13:18Z
canonical: "docs.supermetrics.com/braze-connection-guide"
---

> ## 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.

# Braze connection guide

This guide contains all permissions and requirements for connecting your Braze 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](https://docs.supermetrics.com/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](/docs/braze-connection-guide#connection-instructions).

## Required permissions

You need a Braze REST API key and your Braze REST endpoint to connect to Braze.

- **REST API key**: Created in Braze under **Settings** → **APIs and Identifiers** → **REST API Keys**. The key must have the following permissions:
  - `campaigns.list`
  - `campaigns.details`
  - `campaigns.data_series`

Creating an API key requires the appropriate admin permissions in your Braze account.
- **REST endpoint**: The REST API URL for your Braze instance, for example, `https://rest.iad-03.braze.com`. The REST API URL corresponds to your Braze dashboard cluster. You select it from a list when connecting. If you're unsure which endpoint to use, see [Braze's REST API endpoints](https://www.braze.com/docs/api/basics/#endpoints) (it matches the dashboard URL you log in to).

## 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.

- **Campaign performance**: message delivery and engagement metrics (sent, delivered, opens, clicks, bounces, and more) broken down by channel and message variation, per day.
- **Campaign analytics**: campaign-level outcomes (revenue, conversions, and unique recipients), per day.

## Connection instructions

When connecting to Braze, you enter your Braze REST API key and select your REST endpoint when prompted. Braze uses credential-based authentication, so there's no separate login window.

1. Select the Braze data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. Insert your Braze REST API key and select your REST endpoint.
3. If prompted, choose to make this connection [shared or private](/v1/docs/about-shared-and-private-connections).
4. Click **Start**.
5. 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](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub).

You can also connect to Braze from these destinations:

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

## More resources

- [How to reauthenticate a data source connection](/v1/docs/how-to-reauthenticate-a-data-source-connection)
- [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)