Share a connect link

Use a connect link when you want to trigger authorization without opening Connect UI immediately in your app (for example: email-based onboarding, support-assisted setup, or cross-device flows).

Option 1: Generate a link from your backend

Create a connect session and return the connect_link to your frontend or internal tools:

Node
cURL

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

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

api.post('/connectLink', async (req, res) => {
  const { data } = await nango.createConnectSession({
    tags: {
      end_user_id: '<END-USER-ID>',
      end_user_email: '<END-USER-EMAIL>',
      organization_id: '<ORGANIZATION-ID>'
    },
    allowed_integrations: ['<INTEGRATION-ID>']
  });

  res.status(200).send({
    connectLink: data.connect_link,
    expiresAt: data.expires_at
  });
});

curl --request POST \
  --url https://api.nango.dev/connect/sessions \
  --header 'Authorization: Bearer <NANGO-API-KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tags": {
      "end_user_id": "<END-USER-ID>",
      "end_user_email": "<END-USER-EMAIL>",
      "organization_id": "<ORGANIZATION-ID>"
    },
    "allowed_integrations": [
      "<INTEGRATION-ID>"
    ]
  }'

The returned connect_link expires after 30 minutes.

Option 2: Generate a link from the dashboard

In the Nango dashboard, open the Connections page and use the Share connect link button. This generates a link that you can share directly with the end user.

Notes

For the API details, see Create a connect session.

Auth guide - embed the standard Connect UI flow.
Connection tags, configuration, and metadata - reconcile completed links with users and orgs.
Create a connect session API - API details for generated links.

Getting started

Guides

Reference

Share a connect link

Option 1: Generate a link from your backend

Option 2: Generate a link from the dashboard

Notes

​Option 1: Generate a link from your backend

​Option 2: Generate a link from the dashboard

​Notes

​Related guides

Option 1: Generate a link from your backend

Option 2: Generate a link from the dashboard

Notes

Related guides