In this walkthrough, you integrate, or embed, a report into a web app using C# and the Power BI API, some JavaScript code, and an IFrame.

To get started with this walkthrough, you need a Power BI account. If you don't have an account, you can sign up for a free Power BI account, or you can create your own Azure Active Directory tenant for testing purposes.

To integrate a report into a web app, you use the Power BI API, and an Azure Active Directory (AD) authorization access token to get a report. Then, you load the report into an IFrame using the same access token. The Power BI API provides programmatic access to certain Power BI resources. See Overview of Power BI REST API. The illustration below shows the general flow to integrate a report.

Here are the steps to integrate, or embed, a report into a web page.

Download the sample

This article shows the code used in the Integrate a report sample on GitHub. To follow along with this walkthrough, you should download the sample.

If you are looking for a sample that involves embedding items for non-Power BI users, you can see Embedding for non-Power BI users.

Steps to integrate a report into an app

Next step

In the next step, you learn how to Register a web app with Azure AD to get a Client ID and Client Secret to authenticate the web app with Azure AD. A Client ID and Client Secret is used to identify your app in Azure AD. After you get a Client ID and Client Secret, you can configure the Integrate a report sample. See Configure the integrate a report sample.

Next Step >

See also

Power BI developer samples
Embed sample for non-Power BI users
App permissions
Power BI JavaScript API

More questions? Try asking the Power BI Community