Learn how to connect to a Google Workspace Gmail Account
Introduction
Connecting to Google Workspaces for Mailbox migrations is fast to set up and fully supported in Movebot. Movebot uses the Google API with Delegate API Access.
Currently, we do not support native API connections for personal Gmail. To connect to personal Gmail accounts, use the IMAP connector.
Connecting to Google Workspaces by Delegate access provides access to User Data and Shared Drives in the Google Workspace Domain and full support for migrating Drive content.
Requirements
To connect Movebot to Google Workspace Gmail, you will need:
To have a Google Workspaces Administrator Account
To be familiar with the Google Admin Center
Configuration Steps
Login to Movebot and create a new project or task
When configuring the source or destination, choose to Create new Connection
Select Google Workspaces Gmail from the list of available connections and set the connection name
Provide an email address for an administrator account.
Provide the primary domain for your Google Workspace tenant
Click "Create Service Account"
Copy the identifier for the service account (created as part of the process above)
Save the new client connection in Google and return to Movebot
Click Save and Test connection in Movebot
If the connection has succeeded, you can continue
Common Errors
Movebot supports Google Workspace Mail migrations, including user mailboxes and calendar events. Below are common errors and frequently asked questions related to GWS Mail.
Cause: Event attendee mapping is missing for calendar migration.
Resolution: You must configure mapping rules for event attendees in Step 4 of your project settings. Without this, calendar events will not be migrated.
Cause: The required scopes for Google Domain Delegation are missing or misconfigured.
Resolution: Review your domain delegation setup and ensure all necessary scopes are assigned correctly.Review the documentation.
Frequently Asked Questions
How do I handle the cutover?
Movebot simplifies cutover using delta migrations. You can migrate while users are active, then run a final delta to capture any changes after they stop using the source—minimizing downtime.
If your domain changes during cutover, use "Remap Domains for Cutover" from the Run Action menu. This allows you to specify the old and new domains for source/destination mailboxes, ensuring mappings remain accurate. After remapping, you can continue running delta migrations post-cutover.
Is it possible to migrate between two existing Google Workspace tenants using Movebot?
Answer: Yes. Movebot supports bi-directional, tenant-to-tenant migrations between Google Workspace environments.
How do I transfer one specific folder within a mailbox?
Answer: Use the CSV Import feature to migrate the specific folder.
Example:
source,destination
/mailbox:user@domain.com/@MAIL/Important Mail,/mailbox:user@new-domain.com/@MAIL
Learn more.
How does Movebot handle messages tagged with multiple labels when migrating into Microsoft?
Answer: Movebot creates a separate folder in Microsoft for each label from Google. If a message has multiple labels, a separate copy will appear in each corresponding folder.
How can I migrate a mailbox larger than 100GB into Microsoft using the Online Archive feature?
Answer:
Add a content exclusion rule in Step 6 of your project settings to ignore mail received within the last year.
Run a full migration.
Allow Microsoft’s automatic archiving to move older content into the Online Archive.
Adjust your exclusion rule to ignore mail older than one year.
How can I migrate only mail that was received before a specific date?
Answer: In your project settings, add a content exclusion rule using
"Files/Objects modified after UTC time" to filter messages received after the specified date.
Once I've migrated historical mail, can I migrate only mail received after a certain date?
Answer: Yes. Select "Start Delta Migration" from the launch menu and choose the desired timeframe for the delta to include only newer mail.
Migrated calendar events are missing Google Meet links. Why?
Answer: This is expected behaviour. Google Meet links are tenant-specific and cannot be transferred between environments. Events will be migrated without their original meeting links.
Does Movebot support merging multiple mail accounts into a single mailbox?
Answer: Yes. You can use a CSV import to map multiple source mailboxes into a single destination mailbox, organizing each into its own sub-folder.
Make sure to check "Migrate folder contents" when importing the CSV.
