Symptoms
When attempting to copy a Nintex workflow, the ShareGate migration tool 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
The ShareGate migration tool 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, the ShareGate migration tool 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 the ShareGate migration tool 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.
The ShareGate migration tool uses a service that we created to interact with the Nintex Discovery API. It is possible that this service becomes unavailable. When this happens, the ShareGate migration tool 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 support team.