Connect Gmail or Outlook
Connect Gmail or Microsoft Outlook to Dopia from Settings → Mail & Calendar. Your email and meetings fill in your contacts, companies and deals on their own.
To connect your inbox to Dopia, open Settings → Mail & Calendar, click Connect Gmail or Connect Outlook, and approve access in the Google or Microsoft window. Your calendar connects in the same step. Dopia then imports your past email and meetings, turns the people you've worked with into contacts and companies, and finds the deals in your threads. There's nothing to import by hand and no fields to fill in.
The video above walks through the same steps.
Before you begin
- A Google Workspace (Gmail) or Microsoft 365 (Outlook) mailbox for the work address you sign in to Dopia with. Dopia turns down a mailbox at any other address.
- One provider. Each person connects Gmail or Outlook, not both.
- Pop-ups allowed for dopia.ai in your browser. The Google or Microsoft sign-in opens in a pop-up window.
Connect your inbox
Open Mail & Calendar
Open the account menu at the bottom of the sidebar, choose Settings, then Mail & Calendar. The Sync email & calendar step in the Getting started checklist opens the same place. During setup, the same choice appears on the Start with every customer you already have screen.
Choose Gmail or Outlook
Click Connect Gmail for a Google Workspace account, or Connect Outlook for a Microsoft 365 account. During setup, click Connect next to Gmail or Outlook.
Sign in and allow every permission
Sign in with the account for your Dopia address and approve the list of permissions. On Google's screen, leave every box ticked: without Gmail access the connection fails.
Choose what teammates see
During setup, Dopia asks next on Set up your email sharing, with Don't share (private) selected. A mailbox you connect from Settings starts on Don't share. You can change this any time, as described in choose what teammates see of your email.
What Dopia asks permission for
Google and Microsoft list the permissions on their own approval screens. This is what each one is for in Dopia.
| Permission | Why Dopia needs it |
|---|---|
| Read your email (Gmail: read-only; Outlook: read and write mail) | Import your history and every new email. Outlook's read-and-write permission is what lets Dopia prepare a reply in your mailbox before it sends one you approved. |
| Send email as you | Send the emails you approve, from your own address, in the right thread. |
| See and edit your calendar | Import your meetings, and add meetings people book through your booking link to your calendar. |
| Create online meetings (Outlook only) | Put a Microsoft Teams link on meetings booked through your booking link. Google Meet links come with the Google Calendar permission. |
| Read mailbox settings (Outlook only) | Read your time zone. |
| Your basic profile and offline access | Confirm which address you connected, and keep syncing while you're signed out. |
Dopia never moves, relabels or deletes anything in your mailbox. Emails your assistant writes in your name wait for your approval before they're sent; see approve what your assistant does.
What happens after you connect Gmail or Outlook
Dopia starts reading right away, newest mail first. A card in the top-right corner shows the import's progress, and the Sync email & calendar step in the Getting started checklist shows a percentage. You can keep working while it runs.
- Email history. Dopia imports the last 12 months of email on the Plus, Pro and Business plans and during a trial, and the last 90 days on the Free plan. If you upgrade from Free, Dopia reads the rest of the year in the background, with no need to reconnect.
- Calendar. Dopia imports the last 12 months of meetings on every plan, plus the next 90 days, and keeps that 90-day window rolling.
- Contacts, companies and deals. People you've had a two-way exchange with become contacts, their companies become company records, and each live sales conversation becomes a deal. Newsletters, no-reply senders and one-way cold email don't. The rules are in what Dopia imports from your inbox and how Dopia builds your CRM.
- New mail. After the import, new email and calendar changes reach Dopia on their own, usually within a minute. The Inbox Triage routine files new email under the right deal; see automate recurring work with routines.
Your calendar also powers your booking link, set up in the Booking section of the same tab.
How to tell the connection is working
In Settings → Mail & Calendar, your address appears on a card with a green In Sync badge and the line "Inbox and calendar are syncing in real time." Companies and contacts fill in under Records in the sidebar as the import finishes.
Reconnect or remove your mailbox
Every action for a connected mailbox is in the ⋯ menu on its card in Settings → Mail & Calendar.
- Reconnect. If the badge reads Reconnect or Issue, click it (or choose ⋯ → Reconnect) and approve access again. Reconnecting keeps everything Dopia already imported, but it doesn't re-read your history, so mail that arrived while the connection was broken may be missing. See fix email or calendar sync.
- Edit permissions. Change how much of your email teammates see.
- Remove mailbox. Confirm with Remove. Sync stops at once, and Dopia deletes the emails and calendar events it imported from this mailbox. Companies, contacts and deals stay, along with any edits you made to them. If you connect the mailbox again later, Dopia treats it as a new connection, imports your history again and links it to those records.
To move from Outlook to Gmail or the other way, remove the current mailbox first, then connect the other provider.
Troubleshooting
| What you see | What to do |
|---|---|
| "You connected one address, but your Dopia working email is another." | Connect again and sign in with the Google or Microsoft account for your Dopia address. |
| "Please allow all requested permissions — Dopia needs Gmail access to connect this mailbox." | Connect again and leave every box ticked on Google's permission screen. |
| "Popup blocked. Please allow popups and try again." | Allow pop-ups for dopia.ai in your browser, then click Connect again. |
| "Address is already connected in this workspace as a teammate's mailbox." | One address belongs to one person or sales agent. Connect your own mailbox instead. |
| "Authorization expired. Reconnect to resume sync." | Click Reconnect on the mailbox card and approve access again. |
If mail still isn't arriving, see fix email or calendar sync.
Common questions
- Can my teammates read my email after I connect Gmail or Outlook to Dopia?
- No. A newly connected mailbox is set to Don't share, so teammates see nothing from it. You can widen that later to participants and times, subject lines, or full messages in Settings → Mail & Calendar.
- Can I connect both Gmail and Outlook to Dopia?
- No. Each person connects one mailbox per workspace, either Gmail or Outlook, and its calendar comes with it. To switch providers, remove the current mailbox and connect the other one.
- Does Dopia send email from my account without asking?
- No. Emails your assistant writes in your name wait for your approval before they are sent. Dopia never moves, relabels or deletes anything in your mailbox.
- Can two people connect the same mailbox, such as a shared sales@ inbox?
- No. In Dopia one email address belongs to one person or one sales agent. If the address is already connected in your workspace, Dopia tells you whose mailbox it is and asks you to connect a different one.
- Do I need to connect my inbox again in each Dopia workspace?
- Yes. Mail and calendar connections belong to one workspace. If you belong to several workspaces, each one has its own Mail & Calendar connection.
Up next
What Dopia imports from your inbox
Dopia imports up to 12 months of email and meetings, skips newsletters and automated mail, and only adds people you've had real back-and-forth with.