Skip to main content
You must have at least Application Developer permissions in your Azure account to register applications in Microsoft Entra ID. A Dynamics 365 Business Central license is required for users accessing the API.

​
Register Your Application in Microsoft Entra ID

To connect Dynamics 365 Business Central with StackOne, you need to register an application in Microsoft Entra ID to obtain OAuth 2.0 credentials.

1

Sign in to Microsoft Entra Admin Center

Sign in to the Microsoft Entra admin center as at least an Application Developer. If you have access to multiple tenants, click the Settings (gear) icon in the top-right corner, then select the desired tenant from the list under Directory + subscription.

2

Create a New App Registration

Navigate to App registrations from the left navigation menu and select New registration.

  • Enter a meaningful Name for your app (e.g., StackOne Business Central Integration).
  • Under Supported account types, select Accounts in this organizational directory only (single tenant).
  • Select Register to create the app registration.
3

Copy the Application (Client) ID

After registration, you’ll be directed to the application’s Overview page. Copy the Application (client) ID value and store it securely for use later.

​
Configure Redirect URI

Set up the OAuth 2.0 callback URL to enable authentication flow between StackOne and Business Central.

1

Navigate to Authentication Settings

From your app’s Overview page, select Authentication (Preview) from the left menu under Manage. If you are using the older UI, this may appear as Authentication.

2

Set the Redirect URI

Under Redirect URI configuration, click Add Redirect URI, select Web, enter the StackOne OAuth callback URL, and click Configure.

  • Redirect URI: https://api.stackone.com/connect/oauth2/dynamics365bc/callback
  • Note: If you are using the older UI, under Platform configurations click Add a platform, select Web, enter the URI above, and click Configure.

​
Configure API Permissions

Grant your application the Dynamics 365 Business Central API permission. This uses the Business Central API, not Microsoft Graph. The permission granted here (Financials.ReadWrite.All) is the same as the Scope used by StackOne during authentication (https://api.businesscentral.dynamics.com/Financials.ReadWrite.All).

1

Open API Permissions

From the left menu under Manage, select API permissions.

2

Add Business Central Permission

Enables actions: Create Bank Account, Create Currency, Create Customer, Create Item, Create Journal Line, Create Sales Quote, Create Vendor, Delete Bank Account, Delete Currency, Delete Customer, Delete Item, Delete Journal Line, Delete Sales Quote, Delete Vendor, Get Account, Get Bank Account, Get Company, Get Company Information, Get Currency, Get Customer, Get Customer Payment, Get Customer Payment Journal, Get Dimension, Get Dimension Value, Get Employee, Get General Ledger Entry, Get Item, Get Item Category, Get Journal, Get Journal Line, Get Purchase Invoice, Get Purchase Order, Get Sales Credit Memo, Get Sales Invoice, Get Sales Order, Get Sales Quote, Get Tax Area, Get Vendor, List Accounts, List Bank Accounts, List Companies, List Company Information, List Currencies, List Customer Payment Journals, List Customer Payments, List Customers, List Dimension Values, List Dimensions, List Employees, List General Ledger Entries, List Item Categories, List Items, List Journal Lines, List Journals, List Purchase Invoices, List Purchase Orders, List Sales Credit Memos, List Sales Invoices, List Sales Orders, List Sales Quotes, List Tax Areas, List Vendors, Update Bank Account, Update Company Information, Update Currency, Update Customer, Update Item, Update Journal Line, Update Sales Quote, Update Vendor

Click Add a permission, then select APIs my organization uses and search for “Dynamics 365 Business Central”. Select it, choose Delegated permissions, enable Financials.ReadWrite.All, and click Add permissions to save. Note: offline_access is requested automatically during the OAuth flow to obtain refresh tokens — it is not a selectable Dynamics 365 Business Central API permission and requires no additional action here:

3

Grant Admin Consent

Click Grant admin consent for [tenant name] and select Yes to consent on behalf of all users in your tenant. After granting, verify that Granted for [tenant name] appears under the Status column.

​
Generate Client Secret

Create a client secret that will be used to authenticate your application with Business Central.

1

Navigate to Certificates & Secrets

From the left menu under Manage, select Certificates & secrets.

2

Create a New Client Secret

Under the Client secrets tab, click New client secret.

  • Add a Description (e.g., StackOne Business Central Integration Secret).
  • Select an appropriate expiration period.
  • Click Add.
3

Copy the Client Secret Value

Immediately copy the Value of the newly created client secret and store it securely for use later. This value will only be shown once and cannot be retrieved again.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Microsoft Dynamics 365 Business Central:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Microsoft Dynamics 365 Business Central
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Microsoft Dynamics 365 Business Central.