This article shows you how to register a Power BI client app in Azure Active Directory (Azure AD). You register your client app with Azure AD to allow your application access to the Power BI REST API. This will allow you to establish an identity for your application and specify permissions to Power BI REST resources. For a list of Power BI permissions, see Power BI permissions.

Important Before you register a Power BI app you need an Azure Active Directory tenant and an organizational user, and a Power BI service account.

There are two ways to register your client app: with the Power BI App Registration Tool or on Azure Management Portal. The Power BI App Registration Tool is the easiest option since there are just a few fields to fill in. If you want to make changes to you app, this can be done through the Azure Management Portal.

In this article

Register a client app with Power BI App Registration Tool

You need to register your client app in Azure Active Directory to establish an identity for your application and specify permissions to Power BI REST resources. When you register a client app, such as a console app, you receive a Client ID. The Client ID is used by the application to identify themselves to the users that they are requesting permissions from. Here's how to register your client app with the Power BI App Registration Tool:

  1. Go to dev.powerbi.com/apps.
  2. In the Power BI App Registration Tool, follow these four steps:

Step 1 - Choose Login in to login to your Azure AD account. You will see your name in the Welcome line.

Step 2 – Enter information about your app.

  • App Name: The name of your app.
  • App Type: Choose Native app.
  • Redirect URI: For a native client app, a redirect uri gives AAD more details on the specific application that it will authenticate. Any valid Uri will work such as https://login.live.com/oauth20_desktop.srf.

Step 3 – Choose APIs to access. For more information about Power BI access permissions, see Power BI Permissions.

Step 4 - To register your app, click Register App. After the app is registered in Azure AD, you will get a Client ID. Make sure you copy the Client ID. You can get the Client ID later in the Azure Management Portal. See How to get a client id in Azure Management Portal.

You can now use your Client ID for your app. The next section shows how to register a client app with Azure Management Portal.

Register a client app with Azure Management Portal

You need to register your client app in Azure Active Directory to establish an identity for your application and specify permissions to Power BI REST resources. When you register a client app, such as a console app, you receive a Client ID. The Client ID is used by the application to identify themselves to the users that they are requesting permissions from.

To learn how to authenticate a client app using an Azure AD Client ID, see Authenticate a client app.

Register a client app

Here's how to register a client app: 1. Accept the Microsoft Power BI API Terms. 2. Sign into your Microsoft Azure subscription at https://manage.windowsazure.com. 3. In the left service panel, choose ACTIVE DIRECTORY. 4. Click the active directory that you belong to.

  1. Click APPLICATIONS.

  2. Click ADD.

  3. In Tell us about your application, enter a NAME, and choose NATIVE CLIENT APPLICATION for the type, and click Next icon..

  4. In Application information, enter a REDIRECT URI. For a client app, a redirect uri gives AAD more details on the specific application that it will authenticate. For a client app, you can use any valid Uri such as https://login.live.com/oauth20_desktop.srf.

  5. Click the Complete icon.

  6. In the application page, choose CONFIGURE. You will see your CLIENT ID.

  7. In the CONFIGURATION page, under permissions to other applications, click Add Application.

  8. In Permissions to other applications, choose Power BI Service.

    Important If you do not see Power BI Service in the Permissions to other applications list, you need to sign up for the Power BI Service. To sign up for the Power BI Service, you need at least one organizational user in your Azure Active Directory (AAD) tenant. If you do not have an Azure Active Directory (AAD) tenant, see Create an Azure Active Directory tenant to create an Azure AD tenant and an organizational user in your Azure AD tenant.

  9. Click Complete icon.

  10. In the permissions to other applications group, choose all Delegated Permissions, and chooses one or more permissions. For more information about Power BI permissions, see Power BI Permissions.

  11. Click Save.

How to get a client app id

When you register a client app, such as a console app, you receive a Client ID. The Client ID is used by the application to identify themselves to the users that they are requesting permissions from.

Here's how to get a client id:

  1. Sign into your Microsoft Azure subscription at https://manage.windowsazure.com.
  2. In the left service panel, choose ACTIVE DIRECTORY.
  3. Click the active directory that you belong to.
  4. Click APPLICATIONS.
  5. Choose an application.
  6. In the application page, choose CONFIGURE.
  7. In the CONFIGURE page, copy the CLIENT ID.

See also

Power BI permissions
Azure Active Directory tenant and an organizational user
Power BI service account
Authenticate a client app
Overview of Power BI REST API
More questions? Try the Power BI Community