For the complete documentation index, see [llms.txt](https://docs.pandium.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pandium.com/marketplaces/app-installation-options/auth-link.md).

# Auth Link

Auth Link lets you send users directly to an authentication flow for a specific connector, bypassing the In-App Marketplace entirely. This is useful for:

* **OAuth integrations**: Users authenticate directly with a third-party service
* **Credential-based connections**: Users enter their credentials without sharing them with you
* **Streamlined onboarding**: Skip the marketplace when you already know which integration a user needs

## Requirements

* A [Tenant](https://docs.pandium.com/integration-hub/creating-a-tenant) must be created for the user

**Note**: Auth Link does not require the In-App Marketplace to be set up.

## How to Generate an Auth Link

### Step 1: Create or find the tenant

Go to the **Tenants** resource in the left menu bar.

<figure><img src="/files/LJADidugjYPthDsz71Ra" alt="" width="340"><figcaption></figcaption></figure>

If you haven't already, [create a Tenant](https://docs.pandium.com/integration-hub/creating-a-tenant) for your customer.

### Step 2: Open the connector

Click on the tenant to view its details. Under the connector you want the user to authenticate, click **Connect** (or **Reconnect** if previously connected).

<figure><img src="/files/1cygFCdGBEubjYaBxHkb" alt="" width="216"><figcaption></figcaption></figure>

### Step 3: Generate the Auth Link

In the popup window, click **Generate Customer Link**.

<figure><img src="/files/GRXlLsY3zTA8itsyGo8h" alt=""><figcaption></figcaption></figure>

Copy the link to share with your user.

<figure><img src="/files/lOxr3F6h6JrR5ydGql5j" alt=""><figcaption></figcaption></figure>

### Step 4: User authenticates

Send the link to your user. They will be taken directly to the authentication process—either an OAuth flow or a credential entry form, depending on the connector.

### Step 5: Verify connection

Once the user completes authentication, their connector status will show a green check on the **Tenant Details** page.

<figure><img src="/files/fqmYNbV0kdlW4ZKkZYWE" alt="" width="320"><figcaption></figcaption></figure>

## Auth Link vs Live Link

| Feature                             | Auth Link        | Live Link          |
| ----------------------------------- | ---------------- | ------------------ |
| Requires marketplace                | No               | Yes                |
| User sees marketplace UI            | No               | Yes                |
| Requires tenant to be created first | Yes              | No                 |
| Scope                               | Single connector | Entire integration |

If you want users to go through the standard marketplace experience, use [Live Link](/marketplaces/app-installation-options/live-link.md) instead.

## Auth-Only Connections

If you're building a custom marketplace using Pandium's Auth Dialog process, authentication can be defined directly within the JWT. See [Embedding Auth-Only Connections](https://docs.pandium.com/marketplaces/embedding-auth-only-connections) for details.
