Select Actions to adjust the guide

Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Action

Scope(s)

Loading actions...

Dynamic Guide URL

Scopes Selected


          
            Separator

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.

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.

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.

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.

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.

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`).

From the left menu under Manage, select API permissions.

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:

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.

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

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.

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: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)

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.