📄 OAuth problems (Gmail / Outlook)
Sign in

OAuth problems (Gmail / Outlook)

This article explains common OAuth authorization issues when connecting Gmail or Outlook / Microsoft 365 accounts to MailDesk.

Most OAuth issues are configuration-related and can be resolved quickly.


Common OAuth error messages

You may see messages like:

  • “OAuth not configured”

  • “Authorization expired”

  • “Re-authorization required”

  • “Access denied”

These messages indicate that MailDesk cannot authenticate with the email provider.


“OAuth not configured”

What it means
OAuth credentials are missing or incomplete in Odoo.

MailDesk cannot start the authorization flow without:

  • Google OAuth credentials (for Gmail)

  • Microsoft OAuth credentials (for Outlook)

What to do
This is an administrator task.

Ask your admin to:

  • Configure Google OAuth (Client ID / Secret + Gmail API)

  • Or configure Microsoft OAuth (Azure App Registration + Graph permissions)

Once configured, restart the authorization process.


“Authorization expired” / “Re-authorization required”

Why this happens

  • OAuth tokens expire over time

  • Access may have been revoked by the user

  • Security policies may require re-consent

How to fix it

1️⃣ Open Mailbox Accounts
2️⃣ Open the affected account
3️⃣ Click Re-Authorize
4️⃣ Sign in again and grant access

No data is lost during re-authorization.


“Access denied” during authorization

Possible causes

  • Required permissions were not granted

  • Admin consent is missing (Microsoft 365)

  • Account restrictions or security policies

What to do

  • Carefully review permission screens during login

  • For Microsoft 365, ensure admin consent is granted

  • Ask your admin to review tenant policies


OAuth works but emails do not sync

If authorization succeeds but sync does not start:

Check:

  • Internet access from the Odoo server

  • Provider API availability

  • Temporary rate limits

In most cases, MailDesk will retry automatically.


Revoking and re-granting access

You can safely reset OAuth access:

Gmail

  • Remove the mailbox account in MailDesk

  • Revoke app access in Google Account → Security

Outlook / Microsoft 365

  • Remove the mailbox account in MailDesk

  • Revoke the app in Microsoft Entra / Azure AD

Then reconnect the account.


Quick checklist

Before contacting support, verify:

  • OAuth credentials are configured

  • Authorization flow completes successfully

  • Tokens are not expired

  • Required permissions are granted


When to contact support

Contact support or your administrator if:

  • OAuth cannot be configured

  • Authorization fails repeatedly

  • Errors persist after re-authorization

Include:

  • Provider (Gmail or Outlook)

  • Error message

  • Time of the issue


Tip:

OAuth problems are usually configuration issues, not MailDesk bugs.


What’s next?

→ Check Emails are missing or delayed
→ Check Sent mail does not appear
→ Review Security & privacy