Skip to main content
Kroo can embed your Power BI reports directly into the platform so your team can view dashboards without leaving the app. This guide covers the Power BI licensing requirements, first-time Azure setup, and how to embed and manage reports.

​
Power BI Requirements

Embedding Power BI reports into Kroo requires your workspace to be backed by a dedicated capacity. Power BI Pro licenses alone are not sufficient. If your workspace lacks capacity, embedding will fail when Kroo attempts to generate an embed token.

​
Required Power BI plan

Kroo uses the embed for your customers pattern with a service principal. This requires your Power BI workspace to be assigned to one of the following capacity types:
Capacity typeSKUsPurchase via
Microsoft FabricF2 and aboveAzure portal
Power BI EmbeddedA1 (EM1) and aboveAzure portal
Power BI PremiumP1 and aboveMicrosoft 365 admin center
Premium Per User (PPU) is not supported. While PPU gives individual users access to Premium features, Microsoft does not support it for the embed token API or the export API that Kroo uses for PDF exports.
For full details on capacity sizing and costs, see Microsoft’s Capacity and SKUs documentation.

​
What won’t work

  • Power BI Pro only — Pro is a per-user license. The embed token API returns a 403 Forbidden when the workspace is not backed by a dedicated capacity (source).
  • Power BI Free — No embedding capability.
  • Premium Per User (PPU) — Not supported for embed token generation or PDF export (source).

​
Prerequisites

  • Admin role in your Kroo organization
  • A Power BI workspace backed by a Premium, Embedded, or Fabric capacity (see above)
  • A published Power BI report in that workspace
  • An Azure AD administrator who can grant consent to the Kroo application

​
First-Time Azure Setup

Before embedding your first report, your Azure AD admin must authorize the Kroo application and grant it access to your Power BI workspace. This only needs to be done once per organization.
1

Grant admin consent to the Kroo app

Your Azure AD admin must visit the link below and approve the permissions. This authorizes the Kroo service principal to access Power BI APIs in your tenant.Grant admin consentFor background on why this is needed, see Microsoft’s service principal embedding guide.
2

Enable service principal API access (if not already enabled)

In the Power BI Admin portal, go to Tenant settings → Developer settings and verify these are enabled:
  • Embed content in apps
  • Allow service principals to use Power BI APIs
These can be scoped to a specific security group if needed. See Microsoft’s documentation for details.
3

Add the Kroo app to your Power BI workspace

In Power BI, go to your workspace → Manage access → Add people or groups. Search for the Kroo application and add it as a Member.
The Kroo app must be added as a Member (not Viewer). Viewer access is not sufficient for embed token generation.

​
Embedding a Power BI Report

1

Navigate to Dashboards

From the top bar, go to Insights → Dashboards.
2

Open the embed dialog

Click Embed PowerBI in the top right corner of the page.
3

Paste your report URL

Copy the full URL from your Power BI report and paste it into the Power BI report URL field. Kroo will automatically extract the workspace and report IDs.The URL should look like: https://app.powerbi.com/groups/{workspaceId}/reports/{reportId}Then fill in the remaining fields:
FieldDescription
Power BI report URLThe full URL of your published Power BI report
Display nameThe name shown for this dashboard inside Kroo
Report descriptionA short description of what the report contains
4

Submit

Click Submit to add the dashboard. It will appear in your Dashboards list immediately.

​
Managing Dashboard Permissions

By default, all admin users have access to every embedded dashboard. To control access for other users:
1

Open dashboard options

From the Dashboards list, find the dashboard you want to manage and click the three-dot menu (⋯) on its card.
2

Open Permissions

Click Permissions from the dropdown menu.
3

Grant access to users

Select the users you want to give access to this dashboard and save. Only the users you select will be able to view it.
Admin users always have access to all dashboards regardless of individual permission settings.

​
Troubleshooting

SymptomLikely cause
Report fails to load with a 403 errorWorkspace is not assigned to a Premium/Embedded/Fabric capacity, or the Kroo service principal has not been added as a workspace Member
”Unable to create the report” on submitThe report URL is invalid, the report doesn’t exist, or the Kroo app doesn’t have access to the workspace
PDF export failsWorkspace is not backed by capacity, or the report uses unsupported visuals (R visuals, Python visuals, PowerApps). See Microsoft’s export limitations
Admin consent link returns an errorYour Azure AD admin may need to enable third-party app consent in Azure AD settings

​
Support

For help with embedding reports or configuring access, contact implementations@getkroo.com.