To connect Microsoft Dynamics 365 Business Central to shiptheory, you will need the following credentials generated from the Azure Portal.


Shiptheory will need the following to connect to Microsoft Dynamics 365 Business Central.

  • Tenant ID
  • Client ID
  • Client Secret
  • Company ID


Login to the Azure Portal 


First you will need to login to the Azure Portal using administrator credentials, This can be done by going here


Add a new App


This step will guide you through the process of generating the Tenant ID, Client ID, Client Secret.


From the homepage, click on Azure Active Directory -> App Registrations -> Add



When you click on the down arrow, choose App registration


You will have to enter the below information in order to continue

  • Name: e.g. "Shiptheory API Access"
  • Account Type: choose "Accounts in any organizational directory"
  • Redirect URI: Choose "Web", and enter "http://localhost"



Click Register.


In the next page you can find:


  • Client ID: Application (client) ID
  • Tenant ID: Directory (tenant) ID




Setup API Permissions


Now click API Permissions, and then click Add a permission



Scroll down, and choose Microsoft Dynamics 365 Business Central:



choose Dellegrated permissions, user_impersonation, click Add permissions:



Now Click on Certificates & Secrets and create a New client secret:



Enter a name and define the expiration duration of your secret value:


Click Add and you will have the Client Secret:


  • Client Secret: Value (circled in RED below), NOT the Secret ID


Save this Client Secret in a safe place.

To get the company ID


Login to your Microsoft Dynamics 365 Business Central, you can find the company ID in your URL:



For example, if your URL is:


https://businesscentral.dynamics.com/XXXXXX/sandbox?page=7339&company=Demo%20-%20LM&dc=0


The Company ID is shown following the "&company=" section of the url, In this case, the company id is "Demo - LM", to decode the string from "Demo%20-%20LM" to "Demo - LM", you can use this URL Decoder Online Tool.


Congratulations! You have the nessessary information to connect Microsoft Dynamics 365 Business Central to Shiptheory. Please follow the instruction in Connecting Microsoft Dynamics 365 Business Central to Shiptheory to actually connects it to Shiptheory.


If you have any trouble with getting setup, unsure of what information to include or just need any clarification - you can reach out to our support team and we'll be happy to help.