> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pandium.com/marketplaces/app-installation-options/auth-link.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
