1
Choose the access your integration needs
Review the LiveSwitch authentication guide. Nango includes
offline_access by default so it can refresh tokens. Add openid, profile, and email, which LiveSwitch requires for every integration, then select only the API scopes your application needs. Add me if you want to follow the LiveSwitch quickstart.The webhooks and webhooks.write scopes require the authorizing user to have organization administrator rights.2
Copy your Nango callback URL
Copy the OAuth callback URL shown by Nango for your environment. Nango Cloud uses
https://api.nango.dev/oauth/callback; self-hosted instances use their configured callback URL. LiveSwitch requires an exact match.3
Request a LiveSwitch Developer App
Email integrations@liveswitch.com with the subject Create a developer app. Include:
- the application name and purpose;
- the callback URL;
- the primary developer contact;
- whether you need separate staging and production applications.
4
Configure Nango
Enter the Client ID and Client Secret supplied by LiveSwitch in the LiveSwitch integration settings. Add the scopes selected in the first step, then create a connection and authorize it with a suitable LiveSwitch user.
For agents
For agents
Ask the user to sign in to Nango and create an Environment API key under Environment Settings > API Keys. Call
POST /integrations with Authorization: Bearer <NANGO-API-KEY>, provider set to liveswitch, and credentials containing type: "OAUTH2", the LiveSwitch client_id, client_secret, and the selected scopes as a comma-separated scopes string.5
Next
Follow the Quickstart to connect your first account.