Dynamics 365 Business Central - OAuth
Dynamics 365 Business Central OAuth 2.0


Dynamics Mobile portal must configured to communicate with Dynamics 365 Business Central. The communication with Dynamics 365 Business Central requires Dynamics Mobile portal to authenticate against Dynamics 365 Business Central and the prefered authentication method is called Service-to-Service authentication, which uses OAuth under the hood . You find more information about the subject here
Dynamics Mobile supports OAuth authentication and this requires certain configurations to be made on the Azure, Dynamics 365 Business Central and Dynamics Mobile Portal.


  • Dynamics 365 Business Central instance hosted in Microsoft Cloud
  • Administrative access to https://portal.azure.com
  • Administrative access (FULL ACCESS) to the Dynamics 365 Business Central instance

Configuring Dynamics 365 Business Central

  1. 1.
    Go to https://portal.azure.com and login with your administrative account
  2. 3.
    Click on New Registration button on top
  3. 4.
    Enter Dynamics Mobile in the Name field
  4. 5.
    Select the first option from Supported account types
  5. 6.
    Select Web and enter the following url in Redirect URI: https://businesscentral.dynamics.com/OAuthLanding.htm
7. Click the register button Register
8. Copy the Client ID and Tenant Id values - we will need those in the Dynamics Mobile Portal.
9. Now go to the API permissions section of the newly registered app and click Add Permission
10. Select Dynamics 365 Business Central and then click Application permissions
11. Click Application permissions and then check Financials.ReadWriteAll
12. Check All of of the checkboxes like and then click button Add permissions
13. Click Grant Admin Consent for .......
14. Go to Certificate and secrets and click New Client secret
15. Enter Description, Expires: 24 months and click the Add button
Don't forget to copy the Value field and store it as we we enter this value as a CLIENT SECRET in Dynamics Mobile Portal.
16. Go to your Microsoft Dynamics Business Central instance ,click Search, enter Azure and click over Azure Active Directory Applications
17. Click New to create new app.
18. Enter Description, Client Id (from step 8) and the User Groups and User Permission Sets as given below
So far you need to have the following values copied and prepared for the next step:
Client Id (step 8)
Tenant Id (step 8)
Client Secret (step 15)

Dynamics Mobile Portal Configuration

Dynamics Mobile Portal also needs to be configured.

Configuring the connection with Business Central

  1. 1.
    Go to the Dynamics Mobile Portal and login to the appropriate application area
  2. 2.
    Go to application ADM
  3. 3.
    Go to roles
  4. 4.
    Create role with code DMSAGENT and name DMSAGENT
  5. 5.
    Click the CREATE button on top
  6. 6.
    Open the DMSAGENT role again and go to the role Settings section , then click over AGENT
  7. 7.
    Select SaaS from Agent Deployment Type
  8. 8.
    Click over Backend Connection section
  9. 9.
    Select Microsoft Dynamics 365 Business Central from Connection Type
  10. 10.
    Select Microsoft Cloud from Business Central Deployment Type
  11. 11.
    Enter Tenant Id (step 8) and Environment Id - this is the Business Central Environment Id.
  12. 12.
    Enter the copied client ID from step 8 in Client Id field
  13. 13.
    Enter the copied client secret from step 8 in Client Secret field
  14. 14.
    Enter the default display company name from Business Central in the Company field
  15. 15.
    Click the UPDATE button on top
Copy link
On this page
Configuring Dynamics 365 Business Central
Dynamics Mobile Portal Configuration
Configuring the connection with Business Central