Dynamics Community Forum Thread Details

Token ok via /common, but Business Central /environments/v1.1 returns empty

I’m integrating with Dynamics 365 Business Central Online using Microsoft Entra ID OAuth v2.

Flow

Authorize: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

I can successfully obtain an access token (and refresh token), but when I call the Business Central environments endpoint:

GET https://api.businesscentral.dynamics.com/environments/v1.1

The request does not return anything useful (no environments / empty response / effectively “nothing”). (Happy to share exact HTTP status + response body/headers.)

What I’m trying to understand

What Entra user role / permission is required to consent to the Business Central API in a multi-tenant scenario?
What exact scope / permission should be requested so that the token works for the environments endpoint?
1. Can a normal user consent to delegated BC scopes, or is admin consent required?
  - Should the scope be https://api.businesscentral.dynamics.com/.default (app-only) or a delegated scope (ex: user_impersonation)?
Are there any Business Central-specific requirements (license / permission sets) needed for the signed-in user before /environments/v1.1 will return data?

Any guidance on the correct permissions/consent model for Business Central’s environments endpoint would be appreciated.

Thanks!

Categories:

Dynamics 365 Business Central

Hi,

I would advice you to go through this documentation and follow the necessary steps - https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/administration-center-api

To answer your few questions:

1- You need D365 Or atleast Business Central Administrator role + The admin consent required Cloud Application Admin role.

2 - Scope should be defaul, however your Entra Application do need Admin consent. Also inside Business central assign EXT management related permission to the Entra Application.

All this answers are mentioned in above documentation link.

✅ Tick the checkbox below to mark the answer as verified, if it helped resolve your question.

Regards,

Dhiren.

LinkedIn - https://www.linkedin.com/in/ca-dhiren-nagar-5079081b2/

Blog - https://dhirennagar.blogspot.com/

Quick Links

Leaderboard > Small and medium business | Business Central, NAV, RMS