Home > Gmail Related Codes
Export to PDFIssue:
The email failed in the migration with the following error:
Recommendations:
Assign the Groups Admin role to the destination Admin account, and rerun the migration job.
Issue:
The mailbox alias failed in the migration with the following error:
Recommendations:
Grant the destination Admin account sufficient permissions and the Super admin role if required, then rerun the migration job.
Issue:
The calendar item failed in the migration with the following error:
Recommendations:
Grant the destination Admin account with the “Make changes to events” permission to the calendar by referring to the . Then, rerun the migration job.
Issue:
The permission failed in the migration with the following error:
Recommendations:
Grant the destination Admin account with the “Groups > Update & Read” permission to the group by referring to the . Then, rerun the migration job.
Issue:
The migration job failed with the following error:
Details:
The Admin account in the destination app profile does not have sufficient permissions to retrieve destination shared drives.
Recommendations:
Grant the Admin account with sufficient permissions by referring to the . Then, rerun the migration job.
Issue:
The item failed in the migration with the following error:
Details:
Another destination mailbox is currently using the alias.
Recommendations:
Check if the destination user needs the mailbox alias or use another alias for the current mailbox.
Issue:
The item failed in the migration with the following error:
Details:
Failed to add the alias to the destination user mailbox or Google Group. The domain you configured in the user mapping either does not exist in the destination tenant or is a user alias domain.
Recommendations:
Make sure the user mapping is configured to the correct user domain in the destination tenant. Then, rerun the migration job.
Issue:
The item failed in the migration with the following information:
Details:
The source calendar folder name only consists of invalid characters. Fly will remove the invalid characters from the folder name during the migration. In this case, the calendar folder name will be empty, and the folder cannot be created at the destination.
Recommendations:
Rename the source calendar folder and run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The rule failed in the migration with the following error:
Some conditions or actions in this rule are not supported for cross-platform migration.
Recommendations:
Refer to the for properties supported for migration.
Issue:
The mailbox alias failed in the migration with the following error:
The Google service account lacks the scope for alias migration.
Recommendations:
Refer to the to add the missing scope to the Google service account and rerun the migration job.
Issue:
The migration failed with the following error:
The service account in the destination app profile does not have sufficient permissions.
Recommendations:
Grant sufficient permissions to the service account by referring to the . Then, rerun the migration job.
Issue:
The user failed in the migration with the following error:
Failed to create the filter in the destination. Some properties cannot be retrieved due to API limitations.
Refer to the for properties supported for migration.
Issue:
The folder/file failed in the migration with the following error:
Details:
The destination Drive and Docs service is disabled for users in your organization.
Recommendations:
Enable the Drive and Docs service for users and rerun the migration job.
Issue:
The calendar item failed in the migration with the following error:
Details:
Some source attendees do not have email addresses.
Recommendations:
Check the item’s attendees and provide any missing email addresses. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The event failed in the migration with the following error:
Failed to migrate the event due to inline attachments.
Recommendations:
You can reduce inline attachments, select not to migrate attachments, or remove the existing event.
Issue:
The item failed in the migration with the following information:
Details:
The object is failed since the event does not have a valid ICalUID which is required for an event object.
Issue:
The rule failed in the migration with the following error:
Failed to create the filter in the destination because the mail is not configured as a forwarding address in the destination.
Recommendations:
Add this mail to the forwarding list and rerun the migration job.
Issue:
The filter is skipped in the Gmail migration report with the following information:
Details:
Filters with the action Categorize as are not supported in the migration.
Issue:
The filter failed in the Gmail migration report with the following error:
Details:
This error occurs in the following situations:
Recommendations:
Manually create email rules in the destination after the migration.
Issue:
The rule failed in the migration with the following error:
Details:
Failed to delete the existing filter in the destination by Filter ID.
Recommendations:
Delete the filter in the destination manually. Then, rerun the migration job.
Issue:
The object failed in the migration with the following error:
Details:
The destination does not support using system folders as the target folder for the Move or Copy operation.
Recommendations:
Select non-system folders as the target folder. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The object failed in the migration with the following error:
Details:
The target folder for the Move or Copy operation cannot be found by the Folder ID in the destination.
Recommendations:
Ensure the target folder exists in the destination. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The From or To filter failed in the Gmail migration report with the following error:
Details:
The filter cannot be migrated when the From or To filter condition value meets one of the following situations:
Recommendations:
Manually create email rules in the destination after the migration.
Issue:
The From or To filter failed in the Gmail migration report with the following error:
Details:
The From or To filter condition value contains cc:, bcc:, from:, or to:. In this case, the filter cannot be migrated.
Recommendations:
Manually create email rules in the destination after the migration.
Issue:
The rule failed in the migration with the following error:
Details:
The source rule includes multiple forwarding recipients, but the destination Gmail filter can only support one recipient.
Recommendations:
Reduce the number of recipients. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The filter is skipped in the Gmail migration report with the following information:
Details:
Filters with the action Never send it to Spam are not supported in the migration.
Issue:
The filter failed in the Gmail migration report with the following error:
Details:
The keywords or symbols in the Subject, Has the Words, or Doesn't have rule “ -“, “ +“, “ !”, ” && “, “ & “, “ AROUND “, from:, to:, cc:, bcc:, subject:, list:, after:, before:, older:, newer:, older_than:, newer_than:, deliveredto:, filename:, has:, label:, is:, in:, category:, Rfc822msgid:, larger:, smaller:, and size:. (Note that symbols or keywords that are quoted by double quotes (“ “) have spaces before and/or after them.)
In this case, the filter cannot be migrated.
Recommendations:
Manually create email rules in the destination after the migration.
Issue:
The filter is skipped in the Gmail migration report with the following information:
Details:
Filters with the action Star it are not supported in the migration.
Issue:
The From or To filter failed in the Gmail migration report with the following error:
Details:
The From or To filter condition value begins with -, +, or !. In this case, the filter cannot be migrated.
Recommendations:
Manually create email rules in the destination after the migration.
Issue:
The item failed in the Gmail migration report with the following error:
Details:
The focus time items are not supported in Gmail Migration due to Microsoft API limitations.
Issue:
The object is failed in the migration with the following information:
Details:
The source folder name only consists of carets (^), while carets are not supported in Gmail label names. Fly will remove carets from the source folder name during the migration. In this case, the source folder name will be empty, and the folder cannot be created at the destination.
Recommendations:
Rename the source calendar folder and run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The email failed in the migration with the following error:
Details:
The shared drive configured in the migration mapping does not exist in the destination.
Recommendations:
Please check the related SharePoint Online to Google Drive migration report for details.
Issue:
The object failed in the migration with the following error:
Details:
An unexpected error occurred while processing your request.
Recommendations:
Try running a “Retry error objects” migration job later to resolve this issue. If the error persists, contact Support and provide the migration mapping information and job ID to analyze the error.
Issue:
The object failed in the migration with the following error:
Details:
An unknown error occurred while migrating the object.
Recommendations:
Try running the migration job later. If the error persists, contact Support and provide the migration mapping information and job ID to analyze the error.
Issue:
The object failed in the migration with the following error:
Details:
An error occurred while migrating the object.
Recommendations:
Try running a “Retry error objects” migration job later to resolve this issue.
Issue:
The object failed in the migration with the following error:
Details:
Your request has been throttled by Google due to frequent requests.
Recommendations:
Try running a “Retry error objects” migration job later to resolve this issue. If the error persists, contact Support and provide the migration mapping information and job ID to analyze the error.
Issue:
The object failed in the migration with the following error:
Details:
An unknown error occurred while processing your request.
Recommendations:
Try running a “Retry error objects” migration job later to resolve this issue. If the error persists, contact Support and provide the migration mapping information and job ID to analyze the error.
Issue:
The calendar failed in the migration with the following error:
Details:
The Google Calendar API is not enabled in the project.
Recommendations:
Enable the Google Calendar API in for the project. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The mail/event attachments failed in the migration with the following error:
Details:
The Google Drive API is not enabled in the project.
Recommendations:
Enable the Google Drive API in for the project. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The contact failed in the migration with the following error:
Details:
The Google People API is not enabled in the project.
Recommendations:
Enable the Google People API in for the project. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The task failed in the migration with the following error:
Details:
The Google Tasks API is not enabled in the project.
Recommendations:
Enable the Google Tasks API in for the project. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The group failed in the Gmail migration report with the following error:
Details:
All users in the organization is configured as a member/owner/manager of the Google group. In this case, Fly cannot migrate this group to the destination due to Microsoft API limitations.
Recommendations:
Manually create a group in the destination and add members to the group after the migration.
Issue:
The mailbox failed in the migration with the following error:
Details:
The email is larger than 25 MB and cannot be migrated to the Google Group.
Issue:
The group member failed in the migration with the following error:
Details:
The user is an external user or does not exist in the destination, and cannot be added to the destination Google Group.
Recommendations:
Check the user mapping for group members and make sure the destination user is correct. Then, run an incremental or “Retry error objects“ migration job to resolve this issue.
Issue:
The object failed in the migration with the following error:
Details:
The Group Migration API is not enabled in the project.
Recommendations:
Enable the Group Migration API in for the project. Then, run an incremental or “Retry error objects“ migration job to resolve this issue.
Issue:
The email failed in the migration with the following error:
Details:
The shared drive for the main Teams site does not exist in the destination.
Recommendations:
Please check the related SharePoint Online to Google Drive migration report for details.
Issue:
The contact failed in the Gmail migration report with the following error:
Details:
The email address of the contact contains invalid characters.
Recommendations:
Make sure there is no invalid character in the email address of the contact. Then, run a “Retry error objects” migration job to resolve this issue.
Issue:
The item failed in the migration with the following error:
Details:
The name of the label applied to the item is all invalid characters. In this case, Fly cannot migrate the item to the destination.
Recommendations:
Make sure you select Overwrite conflict resolution in the migration policy and the source label name contains at least one valid character. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
The folder failed in the migration report with the following error:
Details:
The characters of the source folder name are all invalid. In this case, Fly cannot migrate this folder to the destination.
Recommendations:
Modify the source folder name and run a “Retry error objects” migration job to resolve this issue.
Issue:
The item failed in the migration with the following error:
Details:
The mapped time zone configured in the timeZoneMappings customized feature in the migration policy is not supported by Exchange.
Recommendations:
Refer to the Timezone column of the table for the destination time zone’s ID that you can map. Modify the time zone configured in the timeZoneMappings customized feature and run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The task failed in the Gmail migration report with the following error:
Details:
The task attachment does not exist in the source.
Issue:
The Gmail calendar event failed in the Gmail migration report with the following error:
Details:
The error indicates that the source Gmail time zone is not supported by Exchange.
Recommendations:
Map the source time zone to a valid time zone in Exchange by configuring the timeZoneMappings=<Source Time Zone ID:Destination Time Zone ID> feature string in the Customized Features section of the migration policy, and entering the IDs of the source and destination time zones as the values. For example, timeZoneMappings=<America/Grand_Turk:Eastern Standard Time>.
To map multiple source time zones, add the feature string in the format of timeZoneMappings=<Source Time Zone ID 1*:Destination Time Zone ID 1><Source Time Zone ID 2:**Destination Time Zone ID 2>*. For example, timeZoneMappings=<America/Grand_Turk:Eastern Standard Time><America/Santiago:SA Western Standard Time>.
For the source unsupported time zones’ IDs, you can find them in the comment of the failed calendar items in the job report. For the destination time zones’ IDs, refer to the Timezone column of the table for details.
Issue:
The label/event failed with the following error:
Details:
The label/event cannot be found in the destination.
Recommendations:
Run an incremental or “Retry error objects” migration job using this migration policy.
Issue:
The object failed in the migration with the following error:
Details:
The label name you entered is invalid. By default, we treat ”/“ as a character that separates labels.
Recommendations:
Update the label name and ensure that the label does not consist solely of separator characters. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The object is failed in the migration with the following information:
Details:
The email is larger than 50 MB, and you do not select the checkbox in the migration policy to migrate large email. In this case, the email cannot be migrated.
Recommendations:
Select the Migrate email attachments to Google Drive for the destination user mailbox option in your migration policy. Then, run an incremental or “Retry error objects” migration job to resolve this issue. Note that if the email’s large size is mainly due to embedded content (such as inline images), neither the email nor its attachments can be migrated, even with this option enabled.
Issue:
The object failed in the migration with the following error:
Details:
Failed to migrate permissions for a source internal user. The user is either mapped to a non-existent user/group, or the source user's email address cannot be found in the destination organization.
Recommendations:
Configure a user mapping for the user and map to an existing destination user/group. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The email/event failed in the migration with the following error:
Details:
An error occurred while migrating the email/event attachments.
Recommendations:
Check the comments of the failed attachments in the migration report. After you fix the errors, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The object failed in the migration with the following error:
Details:
No response from Google API.
Recommendations:
You can try again later. If the error persists, contact Support and provide the migration mapping information and job ID to analyze the error.
Issue:
The migration job failed with the following error:
Details:
There are multiple shared drives with the same name in the destination.
Recommendations:
Make sure the destination shared drive to which you want has a unique name.
Issue:
The folder failed in the Gmail migration report with the following error:
Details:
If you access the source Gmail mailbox via Outlook that uses the IMAP protocol, the error may occur in the following situations:
Recommendations:
Based on the cases above, you need to configure folder name mappings for the folders before the migration. Refer to the following instructions to configure folder name mappings:
Issue:
The item failed in the Gmail migration report with the following error:
Details:
The out of office event is not supported in Gmail Migration due to Microsoft API limitations.
Issue:
The item failed in the migration with the following error:
Details:
The parent folder of the migrated item attachment does not exist.
Recommendations:
Run a “Retry error objects” migration job to resolve this issue.
Issue:
The item failed in the migration with the following error:
Details:
Google has throttled your request due to frequent requests.
Recommendations:
Run a “Retry error objects” migration job after a few hours to resolve this issue.
Issue:
The task failed in the migration with the following error:
Details:
This task contains reference attachments with no actual content.
Recommendations:
Remove the attachments from the task and upload them again. Then, rerun the migration job.
Issue:
The object failed in the migration with the following error:
Details:
Request timeout.
Recommendations:
Run an incremental or “Retry error objects” migration job later to resolve this issue.
Issue:
The object failed in the migration with the following information:
Details:
The folder name is the same as a reserved label name in Gmail. In this case, the folder cannot be created at the destination.
Recommendations:
Rename the source folder or configured the EmailFolderAddSuffix=true customized feature string in the migration policy to avoid conflict. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The item attachments failed in the migration with the following error:
Details:
The number of files created in the destination shared drive has exceeded the limit of 500,000.
Recommendations:
You can migrate item attachments to different shared drives.
Issue:
The event failed in the migration with the following information:
Details:
The shared drive configured in the migration policy does not exist in the destination.
Recommendations:
Ensure the configured shared drive exists in the destination and has at least one manager. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The email skipped in the migration with the following error:
Details:
The source contained multiple emails with the same message ID. Since message IDs are unique to each email, only one was migrated, and the duplicates were skipped.
Issue:
The calendar item failed in the migration with the following error:
Details:
This may happen when an item was previously migrated from Google Calendar and is now being migrated back.
Recommendations:
Remove the calendar item and create a new one. Then, rerun the migration job.
Issue:
The folder failed in the migration with the following error:
Details:
The number of files and subfolders in the destination shared drive has exceeded Google’s allowed limit of 500000.
Recommendations:
Create multiple project mappings to migrate item attachments to different shared drives. Then, run an incremental or “Retry error objects” migration to resolve this issue.
Issue:
The task failed in the migration with the following error:
Details:
The task notes exceed Google’s limit of 8192 characters.
Recommendations:
Modify the source task notes to no more than 8192 characters. Then, run an incremental or “Retry error objects” migration job to resolve this issue.
Issue:
The task failed in the migration with the following error:
Details:
The task title exceeds Google’s limit of 1024 characters.
Recommendations:
Modify the source task title to not more than 1024 characters. Then, run an incremental or “Retry error objects“ migration job to resolve this issue.
Issue:
The migration failed with the following error:
Details:
There is no available manager to access the destination shared drive.
Recommendations:
Grant the Admin account Manager access to the destination shared drive and rerun the migration job.
Issue:
The object failed in the migration with the following error:
Details:
Google has throttled your request due to frequent requests.
Recommendations:
When throttling occurs in Google, it may take minutes or hours to ease up the throttling. We recommend that you wait a bit before you run a “Retry error objects” migration job after a few hours to resolve this issue.