Auth
Share a connect link
Generate a short-lived connect link and share it with your end user.
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:
import { Nango } from '@nangohq/node';
const nango = new Nango({ apiKey: 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
});
});The returned connect_link expires after 30 minutes.
Option 2: Generate a link from the dashboard
In the Tenklo 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.
Related guides
- 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.