Connect your first mailbox
This page takes you from a fresh MailDesk install to a mailbox that sends and receives email inside Odoo.
Who this is for: the MailDesk administrator (an Odoo administrator or a user with the Mailbox Admin role). You need: MailDesk installed and licence activated (Activate your license). Available in MailDesk Basic and Pro.
Before you begin: which provider do you use?
Answer two questions.
1. Which email provider does the mailbox use?
- Gmail or Google Workspace
- Microsoft 365 or Outlook
- Another provider (IMAP/SMTP)
2. Has an administrator already set up Google or Microsoft sign-in (OAuth) for MailDesk?
- Yes. Go straight to Step 3: add the mailbox.
- No, or you do not know. An administrator must do the one-time setup first:
- Gmail: Connect Gmail / Google Workspace
- Microsoft 365: Connect Microsoft 365 / Outlook
- Another provider needs no OAuth. It uses a username, password and server settings: Connect another email provider (IMAP/SMTP)
If a colleague already created a shared mailbox for you, skip to Option A.
Everyday users only need the Mailbox User role to read and send mail once a mailbox is shared with them. The role is on the Access Rights tab of the user, in Settings ▸ Users.
Step 1: open MailDesk
- Log in to Odoo.
- Open the main apps menu and choose MailDesk.
What you should see: MailDesk opens on the inbox. Before any mailbox is connected, the inbox is empty. That is expected.
When a mailbox is connected, the inbox shows a header with search and a compose button, the quick tabs All, Unread, Starred, Incoming and Outgoing, and your message list.
Step 2: find the menus
- MailDesk: the inbox with folders, message list and reading pane.
- Connect Mailbox: joins a mailbox that already exists, with its email address and shared password.
- Configuration: the administrator area. It holds MailDesk Settings, Aliases and Mailboxes. Under Mailboxes you find Mailbox Accounts, Incoming Mail Servers and Outgoing Mail Servers.
If you do not see Configuration, you have the Mailbox User role. An administrator must set up the connection.
Step 3: add the mailbox
Option A: join a shared mailbox
Use this if a colleague already created a shared mailbox (for example support@) and gave you its shared password.
- In MailDesk, choose Connect Mailbox.
- Enter the Email address of the shared mailbox and the Password the owner gave you.
- Click Connect.
What you should see: the shared mailbox appears in MailDesk. This wizard does not create a mailbox and does not contact your email provider.
Option B: create a new mailbox account
- Go to MailDesk ▸ Configuration ▸ Mailboxes ▸ Mailbox Accounts and click New.
- Account Name: a name you recognise in Odoo, for example Support.
- Email Address: the full address, for example
[email protected]. - Sender Name: the name recipients see. If you leave it empty, they see only the address.
- Users with Access: choose the Odoo users who may use this mailbox. Only these users see the mailbox and its mail.
- For a team mailbox, turn on Allow Personal Connection and set a Share Password. Colleagues use it in Connect Mailbox (Option A).
- Set the Incoming Mail Server and the Outgoing SMTP Server. The type of the incoming server decides the provider (Gmail, Outlook or plain IMAP).
- Click Test Incoming Server and Test Outgoing Server.
What you should see: each test shows Connection Test Successful!
- Click Fetch folders, then open the Folders tab and tick the folders to synchronise. Inbox and Sent are the recommended minimum. Fewer folders make the sync faster.
- Save.
What you should see: the account is saved and its folders are listed.
For provider details, see Add or manage a mailbox.
Step 4: let the first sync run
After you save, MailDesk fills the inbox by itself.
- It syncs folder by folder, newest messages first.
- The first messages appear shortly after you connect. Older mail keeps loading in the background.
- MailDesk fetches the full body of a message when you open it.
A large mailbox can take a while. Let the sync finish. Do not disconnect and reconnect the account.
Step 5: test send and receive
- Click Compose and send a short email to yourself.
- Open Sent.
- Wait for the message to arrive in Inbox.
What you should see: your message in Sent at once, and in Inbox after the next sync. To check receiving from outside, also send an email to the mailbox from another address.
If it does not work
- A connection test fails. Check the address, password and server settings, and the OAuth setup for Gmail and Microsoft 365. See Fix common MailDesk problems.
- The message is sent but does not arrive, or arrives late. Check that the Inbox folder is ticked on the Folders tab. See Fix missing or delayed emails.
- You cannot see Configuration. Ask an administrator to give you the Mailbox Admin role.
One mailbox at a time
Connect one mailbox and confirm that sending and receiving both work before you add the next one.