Failed to link V2 and V3 applications.

While linking an existing V2 application to a new V3 application you might run into the following error when using POST /v3/migration-tools/link-v2v3-apps endpoint.

{
   "request_id":"7c322504-********-0chir6",
   "error":{
      "type":"v3_migration.link_apps_failed",
      "message":"Failed to link V2 and V3 applications with message: 'Unauthorized linking of V2 '<V2-application-ID>' and V3 '<V3-application-ID>' Applications'"
   }
}

This error occurs when invalid or wrong credentials are used while making the request.

Solutions

• Ensure the API key used in the header is associated with the V3 application that you are trying to link.
• Ensure the client-id and client-secret of the V2 application is base64 encoded as below:

echo -n 'V2-client-ID:V2-client-secret' | base64

Note:  The -n flag is essential on this case. When used -n it gives slightly different results than when it is NOT used.

Resources

• Nylas v3 Migration APIs
• Link a v2 app to a v3 app

Updated July 26, 2024 12:58