> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to register your own LiveSwitch API OAuth app

> Request a LiveSwitch Developer App and connect it to Nango

LiveSwitch provisions Developer Apps on request. You need a Client ID, Client Secret, and an exactly matching callback URL before users can authorize your integration.

<Steps>
  <Step id="choose-scopes" title="Choose the access your integration needs">
    Review the [LiveSwitch authentication guide](https://developer.liveswitch.com/docs/basic-concepts). 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.
  </Step>

  <Step id="copy-callback-url" title="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.
  </Step>

  <Step id="request-developer-app" title="Request a LiveSwitch Developer App">
    Email [integrations@liveswitch.com](mailto:integrations@liveswitch.com?subject=Create%20a%20developer%20app) 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.
  </Step>

  <Step id="configure-nango" title="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.

    <Accordion title="For agents">
      Ask the user to sign in to Nango and create an Environment API key under **Environment Settings > API Keys**. Call [`POST /integrations`](/docs/reference/backend/http-api/integration/create) 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.
    </Accordion>
  </Step>

  <Step id="next" title="Next">
    Follow the [*Quickstart*](/docs/getting-started/quickstart) to connect your first account.
  </Step>
</Steps>

For more details, see the [LiveSwitch authentication documentation](https://developer.liveswitch.com/docs/basic-concepts).