Skip to main content
Showing results for 
Search instead for 
Did you mean: 

Find everything you need to get certified on Fabric—skills challenges, live sessions, exam prep, role guidance, and more. Get started

Post Patron
Post Patron

URL, Scope and Grant_type to use when creating a PBI REST API access_token?



I have an app registered within Azure. I'm able to make a token request to and get a successful response and receive an access_token. 

However, when I try to use this access_token to access the PBI REST API, I get a Forbidden Status 403.


If I use an access_token based on my own credentials, I can access the API. 


What is the correct URL, Scope and Grant_type to use when creating a PBI REST API access_token for a Service Principal? 

Post Patron
Post Patron

Awesome, thank you! I can't find ANY documentation on the allowed scope values to send to "". 

Regular Visitor



anyone, please help me with this, I've been stuck with the same error (403 forbidden). I have an app registered within Azure and even I can get the access token, but when I use the token to retrieve the datasets from API, it shows the above 403 error.

Hi @Dayspring 

Does your service principal have access to the workspace (through a security group or directly)?

Did you try to see the response body, sometimes it has additional info for the reason you get the error.



How to provide access to the workspace and also please provide the list of scopes that I should use while authenticating, as of now, I'm using the below scopes.




@Dayspring each API has the list of required scopes, so it depends on which API you are using. You should follow the docs, for example: Reports - Get Reports In Group - REST API (Power BI Power BI REST APIs) | Microsoft Learn


For permissions you can either provide permissiong through Power BI portal as described here Roles in workspaces in Power BI - Power BI | Microsoft Learn or use an API to provide permissions Groups - Add Group User - REST API (Power BI Power BI REST APIs) | Microsoft Learn

Post Patron
Post Patron

I was able to dig through some Python examples to get more info (!) but still no success. 

Here is where I am: 

- Token server URL:<tenant_id>/oauth2/v2.0/token
- Header:  "Content-Type": "application/x-www-form-urlencoded"
- Body: grant_type=client_credentials&client_id=<client_id here>&client_secret=<URL_Encoded Client_secret here>&scope=
- Response: Status 200
  "token_type": "Bearer",
  "expires_in": 3599,
  "ext_expires_in": 3599,
  "access_token": "eyJ0e..."
However, when I try to use this token to access the PBI REST API, I get the following errors:

- Request URL:<report_id here>/ExportTo
- Headers: 
  "Content-Type": "application/json",
  "Authorization": "Bearer <token from above response>"
- Body: 
  "format": "PNG"
- Response: Status 404; Not found
    "statusCode": 404,
    "headers": {
        "Date": "Mon, 01 Mar 2021 19:05:07 GMT",
        "Content-Length": "0"
What is missing here?
Community Support
Community Support

Hi @ericOnline ,


Please refer to this thread: 


Best Regards,
If this post helps, then please consider Accept it as the solution to help the other members find it more quickly.

Thanks for the response, however the Service Principal is listed as "Admin" in both the Workspace and Dataset. What I need is: Which token URL, Grant_type and Scope to use when requesting a token based on Client_id and Client_secret. 


Please advise. 

Hi @ericOnline

Was  your issue ever resolved?   



@V-lianl-msft  I have very similar issue  I have successfully brought back the token correctly now using a script provided by one of your team but I am now getting 


The only thing I am missing in my script is "Scope" as I am unsure what to use?


This is the post for reference


This is the script I used from the above post


let //get token url = "", GetJson = Web.Contents( url, [ Headers = [ Accept = "application/json", ContentType = "application/x-www-form-urlencoded" ], Content = Text.ToBinary( "grant_type=client_credentials& client_id=xxxxxxx& client_secret=xxxxxxx& scope=xxxxxx" ) ] ), token = Json.Document(GetJson)[access_token], //other api usage wiht above token Result = Web.Contents( "", [ Headers = [ #"Content-Type" = "application/json", Authorization = "Bearer " + token, RelativePath = "/xxxxx/xxxxx" ] ] ) in Result


Do I need to add anything else to the script apart from the scope?






I struggled for a few days with the forbidden (403) error and it turned out that I had the App registration correct. What I needed to do was to call the scope correctly in get_token. I was passing ".default" and then I read a thread where it recommended to change it to 

"". In one application what I wanted Dataset.ReadWrite.All, I sent the required scope as 
"". Apparently when you just send ".default" as scope Azure AD just looks for those scopes within Graph API. When you send the whole URL it gets you the right scope and my Forbidden error went away. 
Hope this helps!

Helpful resources

July 2024 Power BI Update

Power BI Monthly Update - July 2024

Check out the July 2024 Power BI update to learn about new features.


Fabric Community Update - June 2024

Get the latest Fabric updates from Build 2024, key Skills Challenge voucher deadlines, top blogs, forum posts, and product ideas.