Skip to main content
Libredesk supports three methods for connecting email inboxes: Google OAuth, Microsoft OAuth, and manual IMAP/SMTP configuration with password authentication.

​
Google setup

Connect your Gmail or Google Workspace inbox using OAuth 2.0.

​
Prerequisites

  • A Google Cloud Console project
  • OAuth 2.0 credentials (Client ID & Client Secret)

​
Required OAuth scopes

When configuring your Google OAuth app, the following scopes are required:
ScopePurpose
https://mail.google.com/Full Gmail access for reading and sending emails
https://www.googleapis.com/auth/userinfo.emailAccess to user’s email address

​
Configuration steps

1

Get callback URL from Libredesk

In Libredesk, go to Admin → Inboxes → New inbox → Google. A dialog will open with the Callback URL - copy this URL.
2

Create a Google Cloud project

Go to the Google Cloud Console and create a new project or select an existing one.
3

Enable Gmail API

In your project, navigate to APIs & Services → Library and enable the Gmail API.
4

Configure OAuth consent screen

Set up the OAuth consent screen with the required scopes listed above.
5

Create OAuth credentials

Go to APIs & Services → Credentials and click Create Credentials → OAuth client ID:
  • Application type: Web application
  • Add the callback URL from step 1 to Authorized redirect URIs
  • Note down the Client ID and Client Secret
6

Complete setup in Libredesk

Back in the Libredesk dialog, enter the Client ID and Client Secret, then click Authorize. You’ll be redirected to Google’s consent screen to grant permissions.

​
Microsoft setup

Connect your Outlook or Microsoft 365 inbox using OAuth 2.0.

​
Prerequisites

  • An Azure Active Directory (Azure AD) app registration
  • OAuth 2.0 credentials (Client ID & Client Secret)

​
Required API permissions

Add the following Microsoft Graph delegated permissions in Azure Portal: Microsoft API Permissions
PermissionTypeDescription
emailDelegatedView users’ email address
IMAP.AccessAsUser.AllDelegatedRead and write access to mailboxes via IMAP
offline_accessDelegatedMaintain access to data you have given it access to
openidDelegatedSign users in
SMTP.SendDelegatedSend emails from mailboxes using SMTP AUTH
User.ReadDelegatedSign in and read user profile

​
Configuration steps

1

Get callback URL from Libredesk

In Libredesk, go to Admin → Inboxes → New inbox → Microsoft. A dialog will open with the Callback URL - copy this URL.
2

Register an app in Azure Portal

Go to the Azure Portal → Azure Active Directory → App registrations → New registration:
  • Enter a name for your application
  • Select the appropriate account type (single tenant or multi-tenant)
  • Add the callback URL from step 1 as the Redirect URI
3

Configure API permissions

In your app registration, go to API permissions → Add a permission → Microsoft Graph:
  • Add all the delegated permissions shown in the table above
  • Click Grant admin consent for Default Directory
4

Create client secret

Go to Certificates & secrets → New client secret:
  • Add a description and expiration period
  • Copy the secret value immediately (it won’t be shown again)
5

Note your credentials

From the Overview page, copy:
  • Application (client) ID
  • Directory (tenant) ID (if using single-tenant)
6

Complete setup in Libredesk

Back in the Libredesk dialog, enter the Client ID, Client Secret, and Tenant ID (optional), then click Authorize. You’ll be redirected to Microsoft’s consent screen to grant permissions.

​
Manual IMAP/SMTP setup

For self-hosted mail servers or providers that don’t support OAuth, use manual IMAP/SMTP configuration.

​
When to use

  • Self-hosted mail servers
  • Email providers without OAuth support
  • App passwords for Google (if OAuth is not preferred)

​
Configuration steps

1

Add inbox in Libredesk

Navigate to Admin → Inboxes → New inbox → Other provider, configure IMAP and SMTP settings, then click Save.