# Braze

Braze is a customer engagement platform that helps marketing teams orchestrate campaigns, canvases, and messaging across email, push, SMS, and in-app channels. It centralizes user behavior data, segmentation, and performance analytics in one place. Connecting Braze to Coupler.io lets you pull that data into your reporting tools without manual exports.

**Why connect Braze to Coupler.io?**

* Sync campaign and canvas performance data automatically to Google Sheets, BigQuery, Looker Studio, or AI tools like ChatGPT and Gemini
* Combine Braze data with other sources (CRM, revenue, ad spend) using Join or Append transformations
* Track KPIs like daily new users, active users, and uninstalls over time in a centralized dashboard
* Keep historical snapshots of segment sizes and engagement metrics without manual downloads

## Prerequisites

* A Braze account with access to the **Developer Console**
* An API key with read permissions for the entities you want to sync (campaigns, canvases, segments, events, cards, KPIs)
* Your Braze **REST endpoint URL** (varies by region, e.g., `https://rest.iad-01.braze.com`)

## Quick start

{% hint style="success" %}
Start with **Campaigns analytics** or **Canvases analytics** — these give you the richest performance data right away and work well as a foundation for dashboards.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a Braze API key.** In Braze, go to **Settings → Developer Console → API Keys** and create a new key. Grant it read access to the data entities you need (campaigns, canvases, segments, events, cards, KPIs). Copy the key.
{% endstep %}

{% step %}
**Add Braze as a source in Coupler.io.** In your Coupler.io workspace, create a new data flow and select **Braze** as the source. Paste your API key and enter your Braze REST endpoint URL.
{% endstep %}

{% step %}
**Select an entity.** Choose which entity to pull — for example, Campaigns analytics, Canvases analytics, or Segments. Set a start date using the date picker to define how far back to sync historical data.
{% endstep %}

{% step %}
**Choose a destination.** Pick where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude, ChatGPT, or Gemini.
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute a manual sync. Once it completes successfully, your data will appear in the destination and you'll be able to set up a schedule.
{% endstep %}
{% endstepper %}

## Available entities

| Entity                   | What it contains                                 |
| ------------------------ | ------------------------------------------------ |
| Campaigns                | List of all campaigns with metadata              |
| Campaigns analytics      | Performance metrics per campaign                 |
| Campaigns details        | Detailed configuration and settings per campaign |
| Canvases                 | List of all canvases                             |
| Canvases analytics       | Performance metrics per canvas                   |
| Canvases details         | Step-level canvas configuration                  |
| Events                   | Custom event list                                |
| Events analytics         | Event occurrence counts over time                |
| KPI daily new users      | New user registrations per day                   |
| KPI daily active users   | Daily active user counts                         |
| KPI daily app uninstalls | App uninstall counts per day                     |
| Cards                    | Content card list                                |
| Cards analytics          | Impressions, clicks, and dismissals per card     |
| Segments                 | List of all segments                             |
| Segments analytics       | Segment size over time                           |
| Segments details         | Segment filter logic and configuration           |
