Once an administrator has set up the provider, each user connects their own mailbox. What that means depends on the provider:
| Provider | Who connects | How |
|---|---|---|
| Microsoft 365 | The user | Signs in on the Microsoft consent screen |
| Google Workspace | The user | Signs in on the Google consent screen |
| IMAP/SMTP | An administrator | Types the server, login and password on the account |
On IMAP/SMTP there is no consent screen and no button for the user to press. See IMAP/SMTP Setup.
The banner
Until you connect, a banner sits above every screen: "Your mailbox is not connected yet." Its Connect my mailbox button drops you straight on the consent screen. Hide dismisses it until your next sign-in.
The banner only appears where the button would work: an internal user who is not connected, on a database whose provider is set up and uses OAuth, and never on a staging copy.
Connect your mailbox
- Click your profile picture (top right) → My Preferences
- Go to the Mail Pro tab
- Click Connect mailbox
- Sign in with your Microsoft 365 or Google Workspace account
- Grant the requested permissions
A personal mailbox is created for the address you signed in with, and set as your Default mailbox. The tab shows which address you are connected as; that is the identity your mail provider knows, which is not always the one on your Odoo user.
An administrator can invite everybody at once with Send Mail Pro Invite on the Users list (Settings → Users & Companies → Users).
Check it works
Send an email from any record in Odoo. If it does not go out, the email in the queue says why and what to do about it.
Set your default mailbox
- Go to My Preferences → Mail Pro
- Pick a mailbox in Default mailbox
- Save
That mailbox is pre-selected in the composer. You can still change it per email.
Choose how much of your mailbox Odoo reads
Replies in a conversation that is already in Odoo always come in, whatever you pick. The Sync level slider on My Preferences → Mail Pro decides what is read on top of that, for your own address:
| Sync level | What comes into Odoo |
|---|---|
| Replies | replies in conversations that are already in Odoo, and nothing from your mail app |
| Received and sent replies | also the replies you send from Outlook or Gmail |
| Replies and existing contacts | also new conversations from people who are already contacts |
| Replies, existing and new contacts | also new conversations from new contacts, whom Mail Pro adds as contacts |
It is your setting, not an administrator's: nobody else can change it, and you can move up or down at any time. Shared mailboxes are configured by an administrator under Settings.
Reading your whole mailbox
Under your own mailbox, Inbox, Sent, Archive and Deleted show your mailbox as it is at Microsoft, Google or your mail server, not only what Odoo imported. That is read live and never stored, so it opens only in a browser where you have signed in there yourself: the first time in a browser, and again after a week away, the folder shows one line, Sign in with Microsoft 365 to see your whole mailbox, with a button. If your browser is already signed in at Microsoft or Google, the button is a flash; otherwise you sign in there as usual. On an IMAP mailbox the button asks for your mailbox password instead, which is checked against your mail server and not kept.
Nobody who merely holds your Odoo login gets past this, an administrator included: the sign-in has to be yours. What Odoo already imported is not behind it.
Sending emails
- Open any email composer (from CRM, Helpdesk, a sales order)
- Use the Send From dropdown to pick a mailbox
- Compose and send
You see your own personal mailbox and every shared mailbox. On Microsoft 365 a shared mailbox also needs SendAs permission on the address.
Disconnecting
- Go to My Preferences → Mail Pro
- Click Disconnect and confirm
This removes your stored credentials. Odoo stops sending and receiving for that account until you connect again. Only you, or an administrator, can change your connection.