Equisys technical notes

Technical guidance, explanations and fixes for our products

FIX: Zetadocs Delivery fails to send after Basic authentication disabled in Exchange Online



This Zetadocs technical note applies to:

  • Zetadocs Extension for Business Central version 2.0 and later
  • Zetadocs for NAV version 9.0 and later
  • Exchange Online


When trying to use Zetadocs Delivery to send a record you are given an error message "Zetadocs has encountered an error when making the webapi request. Please contact your administrator." or if you are using Zetadocs for NAV "Error sending the message. Please review the Zetadocs Delivery Outbox and the Zetadocs Delivery Settings.". 

To understand if this the resolution in this technote applies to you, install the ExchangePowerShell and ExchangeOnlineManagement PowerShell Modules. Run the following PowerShell script to check your authentication settings, where <YourMailboxIdentity> is the email address from your Zetadocs Delivery Settings e.g. accounts@contoso.com and logging in with an Exchange Adminstrator account when prompted.

Get-CASMailbox -Identity <YourMailboxIdentity> | Format-List SmtpClientAuthenticationDisabled

If the output is "SmtpClientAuthenticationDisabled : True" then your account has had SMTP Auth disabled and so you will need to follow the steps in the Resolution section in order to use Zetadocs Delivery.

If the output is "SmtpClientAuthenticationDisabled : False" this technote does not apply to you and you should contact your VAR/Equisys to help resolve your problem.


In October 2022 Microsoft deprecated Basic Authentication for Exchange Online. As part of this they disabled SMTP Authentication for all new tenants and all tenants that weren't using it. SMTP Auth can be re-enabled as it is still needed by many multi-function devices such as printers and scanners that can't be updated to use modern authentication.


Follow HOWTO: Use Zetadocs Delivery with Exchange Online and to get Zetadocs Delivery working again.


A solution for this behaviour is detailed in the technote mentioned above.

Last updated: 9th August 2022 (MP/CR)

Keywords: Zetadocs Delivery, Email, Send, Basic Auth, SMTP

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script