Skip to main content

MAILAUTHPERM - Insufficient Mailbox Permissions

Fix this error by granting the required Azure API permissions so ServiceOps can access the mailbox.

MAILAUTHPERM appears when the Azure application used by ServiceOps lacks the API permissions to read or send from the configured mailbox. Authentication succeeds, but the mailbox itself rejects access. Use this page to identify the missing permissions and restore full mailbox access.

Error CodeMAILAUTHPERM
Error MessageCould not access the mailbox. The application does not have the required permissions to access this mailbox.
SeverityHigh
AffectsIncoming and Outgoing Email Servers (OAuth/Azure)

Symptoms

Look for these signs to confirm this error is active.

  • Authentication appears successful, but ServiceOps still can't read from or write to the mailbox.
  • The error specifically indicates a permissions issue, not a credential issue.

Root Cause

One or more of these conditions caused the permissions failure.

  • The Azure application used by ServiceOps doesn't have the necessary API permissions for this mailbox.
  • Admin consent was never granted, or has been revoked, in Azure Active Directory.

Resolution

Follow these steps to restore the required permissions in Azure.

  1. Ask your Azure Administrator to open the App Registration used by ServiceOps in the Azure Portal and verify the following API permissions are assigned: Mail.ReadWrite (incoming) and Mail.Send (outgoing).
  2. Confirm admin consent is granted for each permission. Assigned permissions without consent still block access.
  3. Verify the mailbox user account is associated with the Azure application and isn't excluded by any access policy.
  4. Once permissions and consent are restored, enter the password again and save the configurations on the server card, then complete the sign-in.
Related FAQs

See Email Server FAQs for: "Why did the OAuth incoming server suddenly stop fetching emails?" and "Why did the OAuth outgoing server stop sending emails after working fine?"