# Brevo Data Connector User Guide

> **Note:** Get valuable insights into your email marketing and campaign performance by connecting your Brevo account to Power My Analytics. This guide will walk you through setup, reporting capabilities, and important considerations.

## Prerequisites

Before connecting Brevo to Power My Analytics, ensure you have:

- Created an API key for Power My Analytics in the **SMTP & API > API Keys** section of your Brevo dashboard
- Configured your Brevo IP authorization settings to allow API requests from Power My Analytics (see **IP Authorization Settings** below)

### Creating an API Key in Brevo

To generate an API key for Power My Analytics in your Brevo dashboard, follow these steps:

1. Log in to your Brevo account and click on your account name in the upper right.
2. Choose **SMTP & API**, then click on the **API keys** tab.
3. Click **Create a new API key** and enter a name for this key, such as "Power My Analytics".
4. Click **Generate**. Copy your new API key.

> **Tip:** If your organization has strict security policies, consider creating a **dedicated API key** exclusively for Power My Analytics. This way, you can apply relaxed IP authorization settings to just that key while keeping your other API keys restricted.

For more information, please see Brevo's documentation on [Using your API key to authenticate](https://developers.brevo.com/docs/getting-started#using-your-api-key-to-authenticate).

### IP Authorization Settings

> **Important:** Power My Analytics requires your Brevo account's IP authorization to be set to **"No IP review"** in order for data to sync correctly. If IP restrictions are enabled, your reports will fail or return no data.

Power My Analytics processes data requests through Google Cloud Functions, which use a dynamic pool of IP addresses that change frequently. Because these IP addresses **are not static**, it is not possible to provide a fixed list of IPs to whitelist in Brevo. Enabling IP restrictions in Brevo will block API requests from Power My Analytics and cause your reports to fail.

To configure your Brevo IP authorization settings for use with Power My Analytics:

1. Go to your Brevo [Authorised IPs settings page](https://app.brevo.com/security/authorised_ips).
2. Select **"No IP review"** to allow requests from all IP addresses.

> **Note:** Your Brevo account is still protected even with "No IP review" enabled. Every API request still requires your API key for authentication, so only services with your key can access your data.

### **Alternative: Automatic IP Review and Authorization**

If your organization prefers not to fully disable IP review, Brevo offers an **"Automatic IP review and authorization"** setting. This option automatically authorizes IP addresses used within the first 30 days. However, because Power My Analytics' IP addresses can change over time, this method is **not guaranteed** to work reliably and may result in intermittent report failures. For the most reliable experience, we recommend using **"No IP review"**.

## Adding Brevo as a Data Source

1. In the Power My Analytics hub, navigate to **Sources**.
2. Click **\+ Add new source** and select Brevo.
3. Enter the Brevo API key you created for Power My Analytics.
4. Click **Connect** to authenticate.

## Creating a Data Studio Report

Follow these steps to create a Data Studio report using your Brevo data:

1. In the PMA hub, navigate to **Reports > Data Studio**
2. Select Brevo under Create Data Studio Report (this will open the official Data Studio application in a new window)

    - Step 1:

        - Name your data source (e.g., change “Untitled Data Source” to "Brevo - Organization Name")
        - Power My Analytics Hub: Choose your PMA hub from the dropdown
        - Optional: Leave "Use report template for new reports" checked to use the PMA demo template
        - Click **Next**
    - Step 2:

        - User Account: Select your Brevo account (for real data) or "Sample Account" (for sample data)
        - Click **Next**
    - Step 3:

        - Click **Connect** (top right) to complete the data source configuration
    - Step 4:

        - Click **Create Report** (top right)

For a quick start, use our pre-built [Brevo demo template](https://lookerstudio.google.com/reporting/80777324-83d7-4921-9e61-4783791aced0/page/p_nwwl22ozsd).

## Key Reports and Fields

The Brevo connector provides access to a variety of data, including:

- Key Performance Metrics: New Contacts, Bounces, Hard Bounces, Soft Bounces, Unsubscribe Rate, Estimated Views, Complaint Rate, Open Rate, Click Rate, Delivery Rate, Click-to-Open Rate

For a full list of available Brevo fields in Power My Analytics, visit the [Schema Explorer](https://hub.powermyanalytics.com/resources/schema/brevo).

## Limitations and Important Considerations

- Cached Data Requests with Unique Metrics and Date Dimension: When a unique metric is paired with the date dimension, this will result in a request for cached data instead of a request for live data. For more information, please see [Understanding Cached and Live Data Requests](https://knowledge.powermyanalytics.com/support/faq/understanding-cached-and-live-data-requests/#a-special-case-unique-metrics-paired-with-the-date-dimension).
- Backfilling: 24 months of historical data will be backfilled when you first connect your Brevo account as a data source.

## Troubleshooting

See our article [Basic Troubleshooting](https://knowledge.powermyanalytics.com/application/troubleshooting/basic-troubleshooting/) for information on issues that may affect the Brevo connector.

If you need further assistance, please [submit a ticket](https://knowledge.powermyanalytics.com/support/submit-a-ticket/).
