> 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/~/revisions/x7Thkx1S9I9SnLbXNFwg/marketplaces/app-installation-options.md).

# App Installation Options

### App Installation Options

Once an integration is created using Pandium, there are several ways to surface it to users for installation.

One option is to showcase the integration to all users via Pandium's [In-App Marketplace](https://www.pandium.com/in-app-marketplace). Here users can discover, install and manage their integration configurations and sync schedules independently. 

Pandium also offers installation options that are suitable for testing and feedback on in-development or closed beta integrations. 

For situations where it’s necessary to send an authentication link to users without using the marketplace, Pandium offers both a **Live Link** and **Magic Link** feature in the Integration Hub.

**Live Link** is designed for Pandium customers who use the In-App Marketplace and wish to direct users straight to an integration hosted on Pandium–even if that app is not published to the marketplace.

**Auth Link** is tailored for situations using OAuth authentication flows or similar. Here, the user connecting a tenant must enter private credentials before the connection is successful. 

This method bypasses the use of Pandium's In-App Marketplace, allowing users to enter their credentials directly.

Once this link is sent to users, they are taken directly to the authentication process. If this process needs intermediary pages, Pandium can help set this up.

## How to Use the In-App Marketplace

If your In-App Marketplace is already [set up](https://docs.pandium.com/marketplaces/embedding-the-marketplace), and you're looking to publish integrations to users, you have two ways to do it. First, while [creating an integration](https://docs.pandium.com/integration-hub/creating-an-integration), you can navigate to 'Marketplace Setup.'

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

Alternatively, you can access an integration's marketplace settings at any time by clicking on 'Details' of the integration within the 'Integrations' tab of the Integration Hub.

<figure><img src="/files/1VTQpdlDkNVk8NMnzP7x" alt="" width="384"><figcaption></figcaption></figure>

Within the 'Marketplace Setup' you can choose whether to have the integration published to your marketplace by toggling this setting on or off.

<figure><img src="/files/ytJA7TQaxGwKfRuRPl6A" alt=""><figcaption><p>Example: A Grey Wizard Tech (GWT) integration with enabled marketplace publish settings.</p></figcaption></figure>

Once published, users can discover the integration in the In-App Marketplace and install.

<figure><img src="/files/OHUnyBaKVaWpg3EgKcKP" alt=""><figcaption><p>End-user perspective: A Grey Wizard Tech customer integrating with Google Sheets via the In-App Marketplace.</p></figcaption></figure>

## How to Use Live Link

To use Live Link, first ensure your In-App Marketplace is [set up](https://docs.pandium.com/marketplaces/embedding-the-marketplace). Then, go to your Integration Hub and check that you have saved the base URL for your marketplace by going to 'Settings' in the left menu bar under the 'Company' tab.

<figure><img src="/files/a1urlT2M3vhyGzob5BDJ" alt=""><figcaption><p>Marketplace URL setting within the “Company” tab under “Settings”</p></figcaption></figure>

Once you have this base URL setup and the marketplace established, Pandium will append a custom URL to the end of any integrations you have in Pandium.

Within the “Integrations” resource in the Integration Hub, navigate to the integration you want to grab the Live Link for.

<br>

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

On the integration tile, click the three dots in the bottom right, and then click “Live Link.”

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

Here, you can view and copy this link, and send this to your users, where they will be navigated to the particular app page within your marketplace, even if the integration is unpublished and not publicly viewable.&#x20;

From here, installation progresses as normal for your user.

## How to Use Auth Link&#x20;

By sending an Auth Link to your customers, they are able to directly authenticate a connector without the need to share credentials to you or logging into the Integration Hub.

To use the Auth Link feature to surface an integration to an end-user, you must first [create a Tenant](https://docs.pandium.com/integration-hub/creating-a-tenant) in the Integration Hub. If you're not sure what a Tenant is, see our [reference here](https://docs.pandium.com/getting-started/key-terminology#tenant).&#x20;

Once a Tenant is created, it can be accessed by going to the “Tenants” resource in the left menu bar in the Integration Hub.

<br>

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

Once on the “Tenants” page, click the Tenant you want to create a Auth Link for to see its details. Click “Connect” or “Reconnect” under the [Connector](https://docs.pandium.com/getting-started/key-terminology#connector) for the integration you want to allow your user to authenticate to.

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

Then, click “Generate Customer Link” in the pop up window to access the Auth Link.

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

If an Auth Link is not currently available for your needed connector, reach out to your Technical Account Manager.

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

Send this link to your end-user or and they will go through the authentication process on their end.

Once your user has successfully authenticated, Pandium will consider them connected, and you will see this reflected under their “Connector Status” within the “Tenant Details” page by a green check.

<br>

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

### Auth-Only Connections

If creating your own Marketplace using our more streamlined Auth Dialog process, authentication is defined directly within the JWT. To learn more about how this process works, check out the specific article [here](https://docs.pandium.com/marketplaces/embedding-auth-only-connections).

*Note: These features are not included in the Pandium Lite offering.*


---

# 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/~/revisions/x7Thkx1S9I9SnLbXNFwg/marketplaces/app-installation-options.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.