{"title":"Set up legacy Outlook contact sync on-premises","url":"https://jonas-paprotka.de/docs/admin-contact-sync-setup-onprem/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/admin-contact-sync-setup-onprem, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/admin-contact-sync-setup-onprem","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Configure OAuth authentication for legacy Outlook contact synchronization in Business Central on-premises version 27 and earlier.","date":"2026-11-12","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Set up legacy Outlook contact sync on-premises","slug":"set-up-legacy-outlook-contact-sync-on-premises","at":0,"chars":4397},{"level":2,"title":"Authentication requirements for legacy contact sync","slug":"authentication-requirements-for-legacy-contact-sync","at":1059,"chars":496},{"level":2,"title":"Prerequisites for legacy contact sync","slug":"prerequisites-for-legacy-contact-sync","at":1555,"chars":421},{"level":2,"title":"Set up contact sync","slug":"set-up-contact-sync","at":1976,"chars":2165},{"level":2,"title":"Related information","slug":"related-information","at":4141,"chars":256}],"text":"# Set up legacy Outlook contact sync on-premises\n> APPLIES TO: Business Central 2025 release wave 2 (v27) and earlier. For later versions, this setup isn't needed. See Save business contacts to Microsoft Outlook<save-business-contacts-to-outlook>.\n> IMPORTANT\n> This legacy integration uses Exchange Web Services (EWS). Exchange Online starts disabling EWS in October 2026 and fully disables it in April 2027. Configuring OAuth doesn't prevent the EWS retirement from affecting contact synchronization. See Deprecation of Exchange Web Services in Exchange Online<https://learn.microsoft.com/exchange/clients-and-mobile-in-exchange-online/deprecation-of-ews-exchange-online>. For Business Central version 28 and later, use Save business contacts to Microsoft Outlook<save-business-contacts-to-outlook>.\nIn this article, you learn how to set up Business Central on-premises to synchronize contacts in Business Central with contacts in Outlook. See Synchronize contacts in Business Central with contacts in Microsoft Outlook<admin-synchronize-outlook-contacts>.\n## Authentication requirements for legacy contact sync\nContact synchronization requires using the OAuth 2.0 protocol for authentication with Exchange Online. Previously, basic authentication was also supported, but it's been deprecated and is no longer supported with Exchange Online. See https://learn.microsoft.com/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online. The following steps configure OAuth authentication for the legacy integration.\n## Prerequisites for legacy contact sync\n Exchange Online, either a standalone version or through Microsoft 365 plan\n Access to the Microsoft Entra tenant used by Exchange Online\n Business Central users have a Microsoft 365 or Exchange Online email account, which is assigned to their accounts in Business Central. You can check this setting in the Microsoft 365 Authentication section of user profile in the Users list.\n## Set up contact sync\nComplete the following steps to set up contact sync. If you're running Business Central Spring 2019 (v.14), you'll have to do an extra step that either modifies application code or sets up a connection to Power BI.\n1. Register an app for Exchange Online API in your Microsoft Entra tenant.\n In this step, you add a registered app in the Microsoft Entra tenant of your Microsoft 365 or Exchange Online plan. Like other Azure services that work with Business Central, Exchange Online requires a registered app in Microsoft Entra ID. The registered app provides authentication and authorization services between Business Central and Exchange Online.\n See dev-itpro/administration/register-app-azure#register-an-application-in-microsoft-entra-id in the developer and IT pro help. As you go through the instructions, remember the following points:\n  If you've already registered an application as part of an integration with another Microsoft product, such as Power BI, then reuse that registered app. In this case, you'll just have to set up the app with the Office 365 Exchange Online permissions described in the next bullet.\n  Configure the registered app with the following delegated permissions to the Office 365 Exchange Online API:\n    Contacts.ReadWrite\n    EWS.AccessAsUser.All\n1. For Business Central version 14, do one of the following tasks:\n  Modify page 6700 by changing FALSE to TRUE in the following line of code in the OnOpenPage trigger:\n   ```\n   PasswordRequired := AzureADMgt.GetAccessToken(AzureADMgt.GetO365Resource,AzureADMgt.GetO365ResourceName,TRUE) = '';\n   ```\n  Create a new page with the following code in the OnOpenPage trigger:\n   ```\n   PasswordRequired := AzureADMgt.GetAccessToken(AzureADMgt.GetO365Resource,AzureADMgt.GetO365ResourceName,TRUE) = '';\n   ```\n  Set up Power BI by following the instructions at Set up Business Central on-premises for Power BI integration<across-working-with-business-central-in-powerbi>.\n After the solution you choose is in place, ask users to either run the new/modified page or connect to Power BI<across-working-with-powerbi#connect>. They'll only need to do this step once.\n## Related information\nSynchronize Contacts in Business Central with Contacts in Microsoft Outlook<admin-synchronize-outlook-contacts>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}