Since there were no in-depth tutorials available on the Celigo Community, I decided to share a complete and practical guide. OAuth setup for Microsoft 365 Business Central can be tricky, so I’ve documented the full process to help you connect M365 to Celigo more easily:
Provided by Teknuro.com
For questions or implementation support, contact: nuri@teknuro.com
Background
Microsoft has deprecated the use of Web Service Access Keys for Business Central Online. Integrations must now use OAuth2.0.
This guide walks you through creating an OAuth App Registration in Azure Portal for use with Celigo integrator.io or other integration platforms.
Step-by-Step: Set up OAuth in Azure
1. Go to Azure Portal
Navigate to: https://portal.azure.com
2. Register a new application
- Search for App registrations
- Click New registration
- Fill in:
- Name: (e.g.,
Celigo Demo
) - Supported account types: Choose as per your organization
- Name: (e.g.,
- Click Register
3. Configure Authentication
-
Open the App by clicking on the display name:
-
Go to Authentication
-
Click Add a platform
-
Choose Web
- For redirect URI, enter:
https://integrator.io/connection/oauth2callback
- Click Configure
4. Set API Permissions
- Go to API permissions
- Click Add a permission
- Choose Dynamics 365 Business Central****First:
- Select Delegated permissions
- Add required scopes (e.g.,
Financials.ReadWrite.All
, etc.)
-
Second:
-
Click Add a permission again
-
Choose Application permissions
-
Add the needed scopes
-
Click Grant admin consent for your organization
-
Confirm by clicking Yes
5. Create Client Secret
- Go to Certificates & secrets
- Click New client secret
- Add description and expiry (e.g., 6 or 12 months)
- Click Add
Example Output (For Reference Only)
Save the Client ID and Secret Value.
Store the Client Secret securely. You cannot retrieve it again later.
Creating a Business Central connection via OAuth still uses the Azure App Registration, which may grant higher privileges than intended if the app has broad permissions — bypassing user-level scope limitations.
Create Connection in Celigo
- Go to Connections
- Create Connection
- Select Microsoft Dynamics 365 Business Central application and select for example API:
- Enter your Microsoft Dynamics 365 Business Central environment.
How to retrieve the environment name:
- Sign in to the Microsoft Dynamics 365 Business Central admin center.
- Click Environment .
- Copy the Environment Name
Name here is Production, so we fill in Production:
Now the connection should work and you will see a online connection:
If it is not working, you can also switch to the HTTP tab in the connection to be created:
As a base uri fill in: https://api.businesscentral.dynamics.com/v2.0/Production/api
(Production is your environment name here)
Then scroll down and select OAuth 2.0 as the Auth:
Click on the plus and create the iClient.
Here you will fill in a name and the client id and secret (which we generated in azure in the previous steps
Now click on Save & Authorize and it should work now:
Notes
- This OAuth setup is required for all new integrations with Microsoft Dynamics 365 Business Central Online.
- Use these credentials to authenticate in Celigo’s HTTP connector or prebuilt Business Central connector using OAuth 2.0.