Tailscale (OAuth)

🚀 Quickstart
🔗 Useful links
🚨 API gotchas

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Tailscale (OAuth).

Authorize Tailscale (OAuth)

Go to Connections -> Add Test Connection -> Authorize, then enter your Tailscale credentials. Later, you’ll let your users do the same directly from your app.

Call the Tailscale API

Let’s make your first request to the Tailscale API (fetch a list of all users). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl -X GET "https://api.nango.dev/proxy/v2/tailnet/{connectionConfig.organizationName}/users" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" 

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

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

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
  endpoint: '/v2/tailnet/{connectionConfig.organizationName}/users',
  providerConfigKey: '<INTEGRATION-ID>',
  connectionId: '<CONNECTION-ID>'
});

console.log(res.data.users);

Or fetch credentials dynamically via the Node SDK or API.

The {connectionConfig.organizationName} in the URL represents the organizationName. You can get this value from your connection configuration after creating the connection.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Tailscale accounts.

Topic	Links
Authorization	Guide to connect to Tailscale (OAuth) using Connect UI
General	Tailscale Website
	Tailscale Admin Console
Developer	Generate an OAuth client
	OAuth clients documentation
	List of OAuth Scopes
	How to generate an OAuth client access token
	Tailscale API docs

Contribute useful links by editing this page

Questions? Join us in the Slack community.

API Guides

APIs & Integrations