Symptoms
When attempting to copy a Nintex workflow, ShareGate Migrate displays the following error :
The ShareGate service interfacing with the Nintex Discovery Service is not available.
You have to be Site Collection Administrator on the following site for ShareGate to use the Nintex Discovery API: 'Your_site'
Error code
Any error code beginning with CO-039
Details
ShareGate Migrate uses the Nintex Discovery API when migrating Nintex workflows to Microsoft 365. This is a required step to first provision your tenant and then get a key specific to your Microsoft 365 tenant, which will be used to access Nintex's other migration APIs. There are two main operations done with the Discovery API : provisioning your tenant and getting your AOI key.
Provisioning your tenant
We first need to provision your tenant for Nintex. When you first try to copy a Nintex Workflow to Microsoft 365, ShareGate Migrate will check if you are provisioned. If you are not, it will provision your tenant which can take up to ten minutes. This step is only required once, so next time you migrate a workflow, this step will be skipped. The provisioning of your tenant is required by Nintex to be able to use the Nintex migration API to export, import, and retrieve Nintex workflows on Microsoft 365.
Getting your API key
Once your tenant is provisioned, the next step is to get your API key for your tenant. Sharegate will use the same Discovery API to get this key. This is the key that will be provided to other Nintex APIs to authorize them to manipulate Nintex workflows on your tenant.
Unauthorized or forbidden
When you receive the following message: You have to be Site Collection Administrator on the following site for ShareGate to use the Nintex Discovery API: 'Your_site'
It is possible that ShareGate Migrate received an unauthorized or forbidden message when using your user account to provision your tenant. Provisioning requires site collection administrator rights on the site collection you are migrating to. It is always recommended to use a site collection administrator account for migration to minimize errors due to insufficient rights.
Service is down
When you receive the following message: The ShareGate service interfacing with the Nintex Discovery Service is not available.
ShareGate Migrate uses a service that we created to interact with the Nintex Discovery API. It is possible that this service becomes unavailable. When this happens, ShareGate Migrate will not be able to contact the service therefore will not be able to provision your tenant or get your tenant key.
Solution
If you have site collection administrator rights on the destination and you are still getting this error, please contact our technical support team.