> ## Documentation Index
> Fetch the complete documentation index at: https://help.peliqan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MS Dynamics 365 Business Central - Getting started in Peliqan

> Connect Microsoft Dynamics 365 Business Central to Peliqan using standard or private app connectors, and learn how to create an Azure app for authentication.

***Microsoft Dynamics 365 Business Central (formerly Microsoft Dynamics NAV or Navision)*** *is a cloud based enterprise resource planning (ERP) app that assists with finance, manufacturing, customer relationship management (CRM), supply chains, analytics, and electronic commerce for small and medium-sized companies and local subsidiaries of large international groups. Business central is available On Prem as well as On Cloud.*

This article provides an overview to get started with the ***Microsoft Dynamics 365 Business Central*** connector in **Peliqan**. Please [contact support](https://peliqan.io/contact) if you have any additional questions or remarks.

## Connect Microsoft Dynamics 365 Business Central in Peliqan

In Peliqan, go to Connections and click on "Add connection". Search for "Business Central" in the list. There are multiple connectors available for Business central.

Note: if you want to use a Private App, see below on how to create the app in Azure.

**Connectors for standard data:**

* Microsoft Dynamics 365 Business Central
* Microsoft Dynamics 365 Business Central (Private app)

**Connectors for working with Custom API's in Business Central:**

* MS Business Central Custom API
* MS Business Central Custom API (Private app)

For more info on using the Custom API, see:

[MS Dynamics 365 Business Central - Custom API](/microsoft-dynamics-365-business-central-custom-api-getting-started-in-peliqan)

**Connectors for working with Peliqan's extension for Business Central:**

For more info on the Peliqan extension, see:

[MS Business Central extension](/connect-to-data/microsoft-dynamics-365-business-central/ms-business-central-extension)

## Add connection

In Peliqan, go to Connections, search for Business Central and select one of the connectors:

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2025-05-27_at_16.55.24.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=2788727e0f26bea70784ff7b98cfa0e7" alt="Business Central connector selection" width="1134" height="1184" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2025-05-27_at_16.55.24.png" />

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2025-05-27_at_16.55.37.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=15ac03f74c901547717f3b9ee383ceb6" alt="Business Central connection form" width="1130" height="1616" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2025-05-27_at_16.55.37.png" />

## Configuration Steps

### 1. Connection Setup

**Connection Name**

Enter a descriptive name for this connection.

### 2. Business Central Credentials

**Tenant ID**

To find your Tenant ID:

1. Log in to Business Central and navigate to the Dashboard
2. Click the Settings icon (⚙) in the top toolbar
3. Select "Admin Center"
4. Copy the Tenant ID from the URL (it appears as `https://businesscentral.dynamics.com/{TENANT_ID}/admin`)

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/image.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=38bbd2919e4c7fe32450cc5b514d42ba" alt="Business Central Admin Center Tenant ID" width="1024" height="587" data-path="images/MS Dynamics 365 Business Central - Getting started/image.png" />

You can also find your Tenant ID by clicking on the Help icon (question mark top right corner) > Help & Support > See Under "Troubleshooting".

**Environment Name**

To locate your Environment Name:

1. In the Admin Center, select "Environments"
2. Choose your environment from the list (or create one if needed)
3. Enter the exact environment name as shown

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/image%201.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=279c09a9e30f575471b7298a135703cd" alt="Business Central Environment Name" width="1024" height="455" data-path="images/MS Dynamics 365 Business Central - Getting started/image 1.png" />

You can also find your Environment name by clicking on the Help icon (question mark top right corner) > Help & Support > See Under "Troubleshooting".

**Company Name**

To find your Company Name:

1. On the Business Central Dashboard
2. Click the Building icon in the top toolbar
3. Select the company you want to connect to from the list
4. Enter the exact company name as shown

## Create a "Private App" in Azure

In order to connect Business Central in Peliqan, you have to create an app in Azure. This is a so called "private" app. After entering all the details in Peliqan (client id, client secret, tenant id) etc. Peliqan will start syncing your data.

1. **Login to Azure Portal Account and click on App Registrations (or search for App Registrations):**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=7e73393068ed9e7df1c885b94c378648" alt="Azure App Registrations" width="1550" height="317" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled.png" />

2. **Click on New Registration to register a single tenant application:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%201.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=db389b376be61e3468685fd2850a7f57" alt="Azure New Registration" width="922" height="293" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 1.png" />

3. **Provide details and click on Register:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%202.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=6d383a7bd5d0cff51e45c3d89337015e" alt="Azure Register app" width="1021" height="889" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 2.png" />

4. **On Overview, make sure to copy ClientId and TenantId:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%203.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=a269955f05c27322510d207e016b5000" alt="Azure App Overview" width="1138" height="529" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 3.png" />

5. **To enable OAuth, click on Authentication > Add Platform > Click on Web:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%204.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=c2f1595390c8fb8bcdce4041e6fa957e" alt="Azure Authentication Add Platform" width="1509" height="762" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 4.png" />

6. **A configure Web window will open to add Redirect URL ([https://oauth.peliqan.io](https://oauth.peliqan.io)) and click configure:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.13.32_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=9e644894ff255bbce47f63455060413b" alt="Azure Redirect URL configuration" width="706" height="1325" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.13.32_PM.png" />

7. **Add Permissions, select API Permissions > Add a permission > Dynamics 365 Business central:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.25.23_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=6aafa18bfca5ec08620cde6ed4c50e0f" alt="Azure API Permissions" width="1334" height="939" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.25.23_PM.png" />

8. **Add Delegated permissions and Applications permissions as below:**

**Delegated permissions:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%205.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=53188d8f2d3c2851720d0007176bcc18" alt="Azure Delegated permissions" width="967" height="1085" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 5.png" />

**Application permissions:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.29.52_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=405b1fec23ad0ffb4cecaf47a3044313" alt="Azure Application permissions" width="1021" height="868" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.29.52_PM.png" />

Following permissions have to be added:

* AdminCenter.ReadWrite.all
* API.ReadWrite.All
* app\_access
* Automation.ReadWrite.All
* Financials.ReadWrite.All
* user\_impersonation

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Business_Central_API_permissions.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=658c41aae6446f7b4d4850afb8b4f8d3" alt="Business Central API permissions" width="1073" height="256" data-path="images/MS Dynamics 365 Business Central - Getting started/Business_Central_API_permissions.png" />

9. **Grant Admin consent to the Apps:**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.31.17_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=e5bb3ca04232d6b73f538c1f4733ec87" alt="Azure Grant Admin Consent" width="1323" height="448" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.31.17_PM.png" />

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%206.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=1e9344be71eedfc28b1a8a226ef61846" alt="Azure Admin Consent granted" width="1325" height="453" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 6.png" />

10. **Get Client Secret: In left pane, click Certificates & Secrets > Client Secret > New Client Secret and provide details to get the client secret. and click on the Add button:**

NOTE: Client secret is only visible when created, make sure to copy and save it for future use. For the Peliqan Connection, you will need to provide the **client secret value.**

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.36.24_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=4361f4054df0c0aedd571864a1da1ff5" alt="Azure New Client Secret" width="1714" height="621" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.36.24_PM.png" />

<img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.38.34_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=cf90dee74c3f3ae869d3aa15b745611c" alt="Azure Client Secret value" width="1341" height="464" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.38.34_PM.png" />

11. **Register the Application in Business Central:**
    1. Go to [https://businesscentral.dynamics.com/](https://businesscentral.dynamics.com/) and login with the same account as Azure Portal.
    2. Click on search icon and search for **'aad' (or "Entra")** and select Azure Entra Applications. <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%207.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=238c93eaabf7b9fbe5c62f9cbee7447a" alt="Business Central search for Azure Entra" width="2753" height="647" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 7.png" />
    3. Click on New button <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_4.47.00_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=ea400bb7922ab470a2e862b9b4f2e594" alt="Business Central New Azure Entra App" width="873" height="283" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_4.47.00_PM.png" />
    4. On the new popped-up window, enter Client Id from app overview, enter a description and enable it. <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%208.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=72a874382669efaf6a3ac4398426e14e" alt="Business Central Azure Entra App details" width="789" height="402" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 8.png" />
    5. On the User Permission Sets section below add 3 permissions mentioned below and save it. <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%209.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=a707e656ace91dcfdc44c33faffb9785" alt="Business Central User Permission Sets" width="793" height="218" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 9.png" />
    6. Make sure the application should be enabled. <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%2010.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=760758a0f559ddadd85bf324acf5971d" alt="Business Central App enabled" width="800" height="36" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 10.png" />
12. **Get Environment details:**
    1. Select settings icon and select admin center: <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%2011.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=a64368762d150c99d469a537355938e5" alt="Business Central Settings Admin Center" width="363" height="457" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 11.png" />
    2. On admin center you will be able to find the environment details: <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Untitled%2012.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=d5e07400ec911bf693eb4ea4d8ef7c2f" alt="Business Central Admin Center environment details" width="1431" height="284" data-path="images/MS Dynamics 365 Business Central - Getting started/Untitled 12.png" />
    3. Get your company name using company icon on Business Central Homepage: <img src="https://mintcdn.com/peliqan-9d7f0393/3kTZIijhQ0E3Oa3n/images/MS%20Dynamics%20365%20Business%20Central%20-%20Getting%20started/Screenshot_2023-10-23_at_5.01.03_PM.png?fit=max&auto=format&n=3kTZIijhQ0E3Oa3n&q=85&s=4d19d079130c50d8ca7dd5c47a725ea1" alt="Business Central Company Name" width="1718" height="297" data-path="images/MS Dynamics 365 Business Central - Getting started/Screenshot_2023-10-23_at_5.01.03_PM.png" />

## Sync data from Custom APIs

You can fetch data from Custom APIs that have been published in your Business Central tenant. Click here for more info:

[MS Dynamics 365 Business Central - Custom API](/microsoft-dynamics-365-business-central-custom-api-getting-started-in-peliqan)

## Sync data using Peliqan's extension for Microsoft Business Central

If you need to sync e.g. custom objects or custom fields, you can do this by installing Peliqan's extension in your Business Central environment. Next, use the connector named "MS Business Central (Peliqan Extension)". More info:

[MS Business Central extension](/connect-to-data/microsoft-dynamics-365-business-central/ms-business-central-extension)

## Need further help

Please contact our support for any further assistance via [support@peliqan.io](mailto:support@peliqan.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.