Rename M365 Tenant Name: "Start-SPOTenantRename : Error Code: -756"

Question

Hello everyone,

I'm trying to change the Microsoft 365 tenant name, but unfortunately I'm getting the following error:

"Start-SPOTenantRename : Error Code: -756, An unexpected error has occurred.

On line: 1, character: 1

+ Start-SPOTenantRename -DomainName “NEW-TENANT-NAME” -ScheduledDateT ...

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : InvalidOperation: (:) [Start-SPOTenantRename], Exception

+ FullyQualifiedErrorId : Error Code: -756,An unexpected error has occurred.,Microsoft.Online.SharePoint.PowerShell.StartSPOTenantRe

name

"

Has anyone else encountered this?

What should I do?

Thanks and best regards
Chris

Answer 1

Hello Christian,

Based on the error you encountered when attempting to rename the Microsoft 365 tenant, you may want to check the following:

• Microsoft explains that Error -756 indicates that “an unexpected error occurred while trying to update the tenant URLs.” In this case, it is recommended to retry the rename after some time, as the issue may be temporary. For reference: https://learn.microsoft.com/en-au/troubleshoot/sharepoint/administration/errors-when-renaming
• Additionally, please double-check that all prerequisites and required steps are met before proceeding. You can review them here: https://learn.microsoft.com/en-us/sharepoint/change-your-sharepoint-domain-name

You may also run the following command to confirm eligibility for the tenant rename: Get-SPOTenantRenameStatus Reference: https://learn.microsoft.com/en-us/powershell/module/microsoft.online.sharepoint.powershell/get-spot…

You may also find this related discussion helpful, as it suggests adding the new “XYZ.onmicrosoft.com” domain to your tenant (without setting it as the fallback domain) before running the tenant rename command.

When running the rename command again, please ensure that the syntax and parameters are correct as outlined in the official documentation, including that the scheduled time is at least 24 hours in the future, the time is set in UTC, and there is no conflicting rename already scheduled.

I hope this information helps. If you have any additional questions, please feel free to let me know.

---

If this response resolves your issue, kindly click Accept Answer and consider upvoting. If you need further clarification, please click Comment.

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.