Skip to content

How to connect Aequo AP to Microsoft Dynamics 365 Business Central

In Aequo, select Connect with Microsoft and have a Global Administrator approve Aequo, add Aequo’s client ID on Business Central’s Microsoft Entra Applications page with permission sets, then pick the environment and company in Aequo and run the first sync. No app registration or client secret is needed. Start with a sandbox environment if you have one.

Last updated · Vendor pages checked · Aequo AP editorial team

Setup steps

  1. Step 1: Check the prerequisites

    • Microsoft Dynamics 365 Business Central online (the connector calls api.businesscentral.dynamics.com; on-premises servers are not supported).
    • A Global Administrator of your Microsoft Entra tenant to approve Aequo. Aequo accepts the approval only from a Global Administrator or a Dynamics 365 Business Central Administrator, and Microsoft’s approval screen needs a role that can grant admin consent, so in practice a Global Administrator does this step. If the role is assigned through Privileged Identity Management, activate it first.
    • A Business Central user who can add Microsoft Entra applications and assign permission sets, such as your Business Central administrator.
    • An Aequo AP workspace. Start a free trial if you do not have one. The connector links one workspace to one Business Central company.
    • A sandbox environment is recommended for the first run, but not required.
  2. Step 2: Select Connect with Microsoft in Aequo

    • In Aequo, open Settings > Integrations and choose the Accounting tab. Under ERP and industry systems, find Microsoft Dynamics 365 Business Central and select Connect.
    • The dialog shows Aequo’s client ID with a copy button. You need it in step 4.
    • Select Connect with Microsoft. Aequo sends you to Microsoft’s sign-in page.
  3. Step 3: Approve Aequo in Microsoft

    • Sign in with a Global Administrator account of the Microsoft 365 organization that owns Business Central.
    • Microsoft lists the permission Aequo requests: the Dynamics 365 Business Central application permission API.ReadWrite.All. Aequo does not request Automation.ReadWrite.All or the Business Central admin center permission. Select Accept to grant it for your organization.
    • Microsoft returns you to Aequo through a second sign-in. Aequo checks that the account belongs to the organization that approved it and holds the Global Administrator or Dynamics 365 Business Central Administrator role. Nothing is saved yet.
  4. Step 4: Add Aequo on the Microsoft Entra Applications page in Business Central

    • Microsoft requires this step inside Business Central for every app that uses the Business Central API, including apps approved in Microsoft Entra.
    • In the Business Central environment and company Aequo will use, search for Microsoft Entra Applications (page 9860) and select New.
    • Paste Aequo’s client ID (shown in the Aequo dialog) in Client ID, add a description such as "Aequo AP", and set State to Enabled.
    • Assign permission sets for the company. Aequo reads vendors, G/L accounts, purchase orders and purchase invoices; creates vendors and draft purchase invoices; and deletes a draft it created if one of its lines is rejected. D365 BUS FULL ACCESS covers this. If your policy requires least privilege, use a permission set limited to those objects. Microsoft does not allow the SUPER permission set for applications.
    • Environments are separate: repeat this in each environment you connect (for example a sandbox, then production).
  5. Step 5: Pick the environment and company, then Test & connect

    • Environment: Aequo looks for environments named Production and Sandbox. If yours has another name, choose Another environment and type it exactly as the Business Central admin center shows it (it is case-sensitive).
    • Select Show companies and choose your company. If Aequo says Business Central needs to allow Aequo, step 4 is not finished in that environment yet.
    • Local currency: leave it blank and Aequo reads the company’s local currency from Business Central, or type its ISO code (for example GBP).
    • Select Test & connect. Aequo reads the company from Business Central with its own Microsoft credentials and saves the connection. No password or client secret of yours is shared with or stored by Aequo.
  6. Step 6: Run the first sync

    • Select Manage, then run Sync vendors first, Sync chart of accounts next and Sync purchase orders last. Purchase orders whose vendor has not been synced are skipped until it has.
    • From then on, a scheduled sync runs every hour: vendors, then G/L accounts, then purchase orders.
    • Set vendor coding defaults and approval rules in Aequo before you approve invoices.
  7. Step 7: Check the results

    • In Aequo, check that your vendors, posting G/L accounts and purchase orders appear. Purchase orders keep their Business Central number, so invoices that quote it match to it. Draft and in-review orders come in as pending.
    • Approve two or three real invoices. Each becomes a draft purchase invoice in Business Central with G/L account lines. Open them in Business Central, check vendor, dates, lines and amounts, then post as usual.
    • Manage shows the connection’s last test, last sync and last reconciliation, any invoice writeback that did not complete, and Reconcile now to re-check drafts against Business Central.

Advanced: use your own app registration

If your policy does not allow third-party multi-tenant apps, register your own app in Microsoft Entra and enter its details in Aequo instead of steps 2 and 3.

  1. Register your own app in Microsoft Entra.
    • In the Microsoft Entra admin center, open App registrations > New registration, name it (for example "Aequo AP") and choose Accounts in this organizational directory only. No redirect URI is needed.
    • Copy the Application (client) ID and the Directory (tenant) ID from Overview. Under Certificates & secrets, create a client secret and copy its Value (not the Secret ID). Note its expiry date: when it expires, syncing stops until you enter a new secret in Aequo.
    • Under API permissions, add Dynamics 365 Business Central > Application permissions > API.ReadWrite.All (Automation.ReadWrite.All is not needed) and select Grant admin consent.
  2. Add your app in Business Central and enter it in Aequo.
    • Add your app’s client ID on the Microsoft Entra Applications page with State Enabled and permission sets, as in step 4.
    • Company ID is a GUID, not the company name: the id of your company in GET https://api.businesscentral.dynamics.com/v2.0/{tenant ID}/{environment}/api/v2.0/companies.
    • In the Business Central connect dialog in Aequo, select Advanced: use my own app registration, enter the tenant ID, environment name, company ID, client ID, client secret and local currency (Aequo assumes USD if it is left empty), then select Test and connect. The secret is stored encrypted and sent only to Microsoft’s sign-in host.

Troubleshooting

Most connection problems are an account without the Global Administrator role, Aequo not yet added on Business Central’s Microsoft Entra Applications page, or an environment with a non-default name. The message Aequo shows tells you which.

Business Central connection problems and fixes
What you seeLikely causeFix
Aequo says “Ask your Microsoft 365 or Business Central admin to connect Aequo”The account that signed in is neither a Global Administrator nor a Dynamics 365 Business Central Administrator, or the role is assigned through Privileged Identity Management and not activeAsk a Global Administrator to select Connect with Microsoft, or activate the role and try again.
Microsoft says you need admin approval, or Aequo says the permissions were not approvedThe account cannot grant tenant-wide admin consent, or Accept was not selectedSign in as a Global Administrator and select Accept on Microsoft’s permission screen.
Aequo says Business Central needs to allow Aequo (or the test returns HTTP 401 or 403)Aequo’s client ID is not on the Microsoft Entra Applications page of that environment, is not Enabled, or has no permission setsDo step 4 in that environment, then select Show companies or Test & connect again.
Your environment is not in the listAequo finds only environments named Production and SandboxChoose Another environment and type the name exactly as the Business Central admin center shows it (case-sensitive).
Vendors and accounts look like a different company’sAnother company in the environment was picked (for example a demo company)Select Connect with Microsoft again and pick the right company. One Aequo workspace connects to one company.
Drafts appear in the sandbox, not production (or the other way round)The connection points at the sandbox environmentBusiness Central environments are separate. Connect again and pick the production environment once you are happy with the sandbox run, and add Aequo on the Microsoft Entra Applications page there too.
With your own app registration: the Microsoft Entra token request failed (for example invalid_client)Wrong tenant ID or client ID, a client secret ID entered instead of the secret value, or an expired secretCopy the IDs again from the app’s Overview page and create a new client secret, entering its Value.
A purchase order did not come inIts vendor has not been synced, or a purchase order with the same number was already entered in Aequo by handRun Sync vendors, then Sync purchase orders. A number clash is reported and never overwritten; rename one of the orders.
An approved invoice did not reach Business CentralA line has no G/L account, the account number is not a posting account, Business Central rejected a line, or another accounting system (such as QuickBooks Online or Xero) is also connected and receives approved invoicesCheck the invoice writeback section in Manage for the reason, fix the coding and retry. If a line was rejected, Aequo deletes the partial draft so the retry starts clean.

Still stuck? Email support@aequoap.com with the message Aequo showed and your environment type. Never include a client secret. See support for what to include.

How to disconnect or revoke access

Disconnect in Aequo stops syncing and writeback; disabling or deleting the app in Microsoft revokes access entirely.

  1. In Aequo, open Settings > Integrations, select Manage on the Business Central card and choose Disconnect. Aequo stops syncing with Business Central and stops creating draft purchase invoices. History stays readable and you can reconnect later.
  2. In Business Central, open the Microsoft Entra Applications page, open the Aequo app’s card and set State to Disabled, or delete the card.
  3. In the Microsoft Entra admin center, open Enterprise applications, find Aequo AP and delete it (or remove its permissions). That stops Aequo from getting a token for your organization. With your own app registration, delete its client secret or the app registration instead.

Drafts that Aequo already created stay in Business Central until you post or delete them.

Frequently asked questions

Which Microsoft permission does Aequo request?

Only the Dynamics 365 Business Central application permission API.ReadWrite.All, granted for your organization by a Global Administrator. Aequo does not request Automation.ReadWrite.All or the Business Central admin center permission, because it uses only the standard Business Central API.

Who needs to be involved?

A Global Administrator to approve Aequo in Microsoft, and a Business Central user who can add Microsoft Entra applications and assign permission sets. Often that is the same person or your Business Central partner.

Should I connect a sandbox or production first?

A sandbox if you have one. Environments are separate, so Aequo must be added on the Microsoft Entra Applications page in each environment you connect. To switch Aequo to production, select Connect with Microsoft again and pick the production environment.

Do I have to manage a client secret?

Not with Connect with Microsoft: Aequo uses its own credentials and stores no secret of yours. If you use your own app registration instead, its client secret expires on the date you chose; syncing stops until you create a new one and enter it with Update credentials on the Business Central card in Aequo.

How do I disconnect Aequo from Business Central?

In Aequo, open Manage on the Business Central card and select Disconnect; syncing and writeback stop and history is kept. To revoke access in Microsoft too, set Aequo to Disabled on the Microsoft Entra Applications page, or delete Aequo AP under Enterprise applications in the Microsoft Entra admin center.

Need a hand with the Microsoft side?

Email support@aequoap.com with your environment type (sandbox or production) and the step you are on, or book a setup call and we will go through it with your administrator.

Sources

Checked on October 30, 2026. Vendor capabilities and prices change; confirm current details with each vendor.

  1. Microsoft Learn, Using service-to-service authentication (Business Central) — app registration, API.ReadWrite.All, Microsoft Entra applications page, no SUPER for apps
  2. Microsoft Learn, Admin consent on the Microsoft identity platform — admin consent for a multi-tenant app
  3. Microsoft Learn, Grant tenant-wide admin consent to an application — roles that can grant admin consent
  4. Microsoft Learn, Business Central API (v2.0) — vendors, accounts, purchase invoices, purchase orders, companies
  5. Microsoft Learn, purchaseOrder resource type (API v2.0) — status values Draft, In Review, Open
  6. Microsoft Learn, Review permissions granted to enterprise applications — reviewing and revoking an app’s permissions