Error Message
During a mail migration from Google Workspace to Microsoft 365, you may encounter the following error:
This error indicates that the Gmail API cannot access the user's mailbox because the Gmail service is not properly enabled or the user lacks the required license.
Possible Causes
This error can occur due to one of the following reasons:
- The user being migrated lacks a valid Google Workspace license - The user account doesn't have Gmail enabled or has an insufficient license tier.
- The migration service account is not properly licensed - The account used by Cloudiway to connect to Google Workspace needs appropriate permissions.
- The Gmail API has not been enabled - The Gmail API must be enabled in your Google Cloud Console project.
Solution 1: Check User License
Verify that the user you're trying to migrate has a valid Google Workspace license with Gmail access:
- Sign in to the Google Admin Console
- Navigate to Directory → Users
- Find and click on the user experiencing the error
- Click on Licenses in the user details
- Verify that a Google Workspace license (Business Starter, Standard, Plus, or Enterprise) is assigned
- Ensure Gmail is enabled under the Apps section
License Types
Solution 2: Check Migration Account License
The migration account configured in your Cloudiway connector must also have a valid license:
- Identify the migration account email address from your Cloudiway connector settings
- In Google Admin Console, verify this account has:
- A valid Google Workspace license
- Super Admin or appropriate delegated admin rights
- Gmail service enabled
- If using domain-wide delegation, ensure the service account is properly configured
Solution 3: Enable Gmail API
The Gmail API must be enabled in your Google Cloud project. Follow these steps:
- Go to the Google Cloud Console
- Select your project (or create one if needed)
- Navigate to APIs & Services → Library
- Search for "Gmail API"
- Click on Gmail API in the results
- Click Enable if it's not already enabled
Complete Service Account Setup
Verify the Fix
After applying the appropriate solution:
- Wait a few minutes for changes to propagate (Google changes can take up to 24 hours, but usually apply within minutes)
- Go to your Cloudiway project
- Test the connector connection
- Retry the migration for the affected user
Still Having Issues?
- The affected user's email address
- Screenshot of the error from Cloudiway logs
- Confirmation of license and API status