There are cases where you need to re-authorize a connection, e.g. credentials have expired or the scopes/permissions have changed.

The simplest way is to delete and recreate the connection, but this will reset the connection’s attached data (metadata, synced records). Most of the time when testing, this is fine.

Follow the instructions below if you need to re-authorize a connection without altering it’s attached data.

​

Re-authorize a connection from your app

You can implement the re-authorization flow in your app by having your backend call a different endpoint when the connection already exists.

Instead of generating the default endpoint to generate a session token, use the POST /connect/sessions/reconnect endpoint (API/SDK reference) to generate a session token meant for reconnection. This token is then used on the frontend in the same way as when creating a connection, but it will reconnect the existing connection instead.

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: process.env['<NANGO-SECRET-KEY>'] });

api.post('/sessionToken', (req, res) => {
  // Ask Nango for a secure token to reconnect
  const res = await nango.createReconnectSession({
    connection_id: "<CONNECTION-ID>",
    integration_id: '<INTEGRATION-ID>',
  });

  // Send this token back to your frontend
  res.status(200).send({
    sessionToken: res.data.token
  });
});

​

Re-authorize a connection from the Nango UI

To re-connect from the UI, go to the Connections tab > click Add Test Connection > click Or use deprecated flow. Pick the relevant integration and enter the connection ID of the connection you want to re-authorize.

This flow leverage’s the headless client. Check out the reference to pass the right parameters based on the integration’s authorization type (OAuth, API key, basic auth).