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

# Connect Power BI

> Read your published Power BI reports and datasets — a narrower scope of the Microsoft 365 connection.

The Power BI connector reads your published reports and datasets across every workspace, so Rivvi can cite live figures and compare them against your outreach outcomes.

<Tip>
  Power BI is the **Microsoft 365 connection scoped to Power BI only** — the same Azure AD app, without granting SharePoint, OneDrive, or Teams access. Most organizations should connect [Microsoft 365](/connectors/microsoft-365), which covers Power BI *and* the rest of the suite. Choose this if you want to grant Power BI on its own.
</Tip>

## What you'll need

From an **Azure AD app registration** with Power BI access:

* **Tenant ID** — Azure app registration → Overview → Directory (tenant) ID
* **Client ID** — Azure app registration → Overview → Application (client) ID
* **Client secret** — Certificates & secrets → the secret **Value** (shown once at creation)

<Card title="Power BI: Register an app" icon="arrow-up-right-from-square" href="https://learn.microsoft.com/power-bi/developer/embedded/register-app">
  Microsoft's guide to registering an app for Power BI.
</Card>

## Connect it

<Steps>
  <Step title="Register an Azure AD app for Power BI">
    Copy the tenant ID, client ID, and a client secret's value.
  </Step>

  <Step title="Open Rivvi's connector settings">
    **Settings → Connectors**, select **Power BI**, click **Connect**.
  </Step>

  <Step title="Paste your credentials">
    | Field                    | What to paste                                                               |
    | ------------------------ | --------------------------------------------------------------------------- |
    | **Tenant ID**            | Directory (tenant) ID                                                       |
    | **Client ID**            | Application (client) ID                                                     |
    | **Client secret**        | The secret's Value                                                          |
    | **Default workspace ID** | *(Optional)* Leave blank to use all workspaces, or set one to pin a default |
  </Step>
</Steps>

<Note>
  Your Azure app must be a member of each Power BI workspace it should read, and your tenant's *"Allow service principals to use Power BI APIs"* admin setting must be enabled. The **[Microsoft setup for IT admins](/connectors/microsoft-setup)** guide walks through both, plus how Rivvi reads across [multiple workspaces](/connectors/microsoft-setup#multiple-power-bi-workspaces).
</Note>

## What Rivvi can do with Power BI

**Read (allowed by default)**

* List every workspace the connection can access.
* List reports across your workspaces; read a specific report's pages and visuals.
* List a dataset's tables and columns, and run read queries against a published dataset.
* List dashboards.

**Write (asks for approval by default)**

* Trigger a dataset refresh.
* Export a report to PDF or PowerPoint.

## Try it

```text theme={null}
What's the current figure on our operations dashboard?
Query our appointments dataset for last month's totals.
```

## Next

<CardGroup cols={2}>
  <Card title="Microsoft 365" icon="microsoft" href="/connectors/microsoft-365">
    Get Power BI plus SharePoint, OneDrive, Excel, and Teams in one connection.
  </Card>

  <Card title="Microsoft setup for IT admins" icon="shield-halved" href="/connectors/microsoft-setup">
    The full app registration, Power BI access, and multi-workspace setup.
  </Card>
</CardGroup>