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

The app registration in Microsoft Entra ID provides the OAuth 2.0 credentials for the connection.

1

Create a New App Registration

Sign in to the Microsoft Entra admin center.

  • Select the Settings (gear) icon in the top-right corner if you have access to multiple tenants.
  • Select the tenant you want to connect from the list under Directory + subscription.
  • Select App registrations from the left navigation menu.
  • Select New registration.
  • Name: A name that identifies this integration
  • Supported account types: Accounts in this organizational directory only (single tenant)
  • Redirect URI (optional): select Web, then enter the Callback URL from your Connector Profile
  • Select Register to create the app registration.
2

Copy the Application (Client) ID

The app’s Overview page shows the Application (client) ID.

  • Copy the Application (client) ID to Client ID in your Connector Profile.
3

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

From the left menu under Manage, select API permissions. The permission comes from the Business Central API, not Microsoft Graph.

  • Click Add a permission.
  • Select APIs my organization uses.
  • Search for Dynamics 365 Business Central.
  • Select Dynamics 365 Business Central.
  • Choose Delegated permissions.
  • Enable Financials.ReadWrite.All.
  • Click Add permissions to save.
4

Grant Admin Consent

Consent on behalf of all users in your tenant.

  • Click Grant admin consent for [tenant name].
  • Select Yes.
  • Check that Granted for [tenant name] appears under the Status column.
5

Create a New Client Secret

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

  • Under the Client secrets tab, click New client secret.
  • Description: A description that identifies this secret
  • Select an appropriate expiration period.
  • Click Add.
6

Copy the Client Secret Value

The Client secrets tab shows the Value of the new secret. The Value is only shown once.

  • Copy the Value to Client Secret in your Connector Profile.

Find Your Tenant ID (single-tenant apps only)

The tenant ID identifies your Microsoft Entra directory. Only needed for a single-tenant app registration. Leave Tenant ID blank on a multi-tenant app.

1

Locate the Tenant ID

Sign in to the Microsoft Entra admin center.

  • Open Identity > Overview.
  • Copy the Tenant ID across.

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.