# Apps & Marketplace

## What it is

The Marketplace is where you browse and install integrations — the connections between IDC and external systems like your store, point-of-sale, or warehouse. The Apps page lists everything you've already installed, where you configure and manage each one.

## When you'd use it

* **Marketplace** — when you want to connect IDC to a new system for the first time.
* **Apps** — when you want to check an app's status, update its settings, duplicate it for a second location, or remove it.

## Before you start

* Installing, duplicating, and uninstalling apps requires integration admin access.
* Your organization must have an active IDC subscription that covers the app you want to install. Check **Licenses** in the left menu if you're unsure. See [Licenses](/idc/idc-core/licenses.md).
* Have your external system's account details on hand — you'll need them when configuring the connection (for example, a store URL or API key).

## Step by step

### Install an app from the Marketplace

1. Click **Marketplace** in the left menu.
2. Use the **Find an app…** search box to search by name, or scroll to browse all available integrations. Use the **Type** dropdown to filter — choose **Not Installed** to see only new options.

   ![The Marketplace page showing the app grid with Find an app search box and Type filter](/files/rgGa99h3YUll6Bx7YDKX)
3. Find the app you want and click **Install**. A setup panel opens to confirm the installation. Your license details are automatically populated from your existing purchase.
4. Once installation is complete, the card updates to show **Installed** alongside a **Renewal Date**.

   > **Note:** If the Install button doesn't appear, you may not have admin access, or the app may require a license that isn't active. Check [Licenses](/idc/idc-core/licenses.md) or contact your integration admin.

### Configure the app

5. Click **Apps** in the left menu. Your newly installed app appears as a card.
6. Click the **gear icon** on the app card. This opens the app's management view — a list of the app's flows, each with a **Configure** button, and a menu bar across the top containing additional tabs.
7. Click the **Settings** tab in the app menu bar. Enter your connection details — your store URL, account credentials, or API key, depending on the app. Each field has a label describing exactly what to enter.

   ![The app Settings tab showing connection fields for entering store URL and credentials](/files/tJ5wKZttwWKDPRlrEuvH)
8. Save your settings when done.

### Confirm the first sync

9. Return to the **Dashboard** in the left menu. Within a few minutes of saving your settings, you should see activity in the **Sync Activity** chart and records appearing in **Flow Performance**.
10. Click **Logs** in the left menu. Select your new app from the **App** dropdown to see the first sync records.
11. Check that log entries show a **Success** status. If you see errors, open a log entry to read the error message, then refer to [Troubleshooting](/idc/idc-core/troubleshooting.md).

### Manage your installed apps

**Check an app's status** Click **Apps** in the left menu. Each card shows the app's **Version**, **Renewal Date**, and **Status**. Use the **Find an app…** search box to filter if you have many apps.

![An app card showing the app name, Version, Renewal Date, and Status](/files/hxxKoB1co6y6rkvlgWNQ)

**Update an app's settings** Click the **gear icon** on the app card to open the app's management view, then click the **Settings** tab. Make your changes and save. The app uses the updated settings on its next sync run.

**Duplicate an app** Click the **copy icon** on an app card. IDC creates a new copy with the same settings — useful when adding a second location that should be configured the same way. Update only the details that differ.

**Uninstall an app** Click the **trash icon** on an app card. Read the confirmation carefully: removing an app deletes all its settings and history and **cannot be undone**. Click **Uninstall** to confirm, or **Cancel** to go back.

> **Warning:** Only uninstall an app if you're certain you no longer need it.

## What success looks like

* The app appears in **Apps** with an active **Status** and a future **Renewal Date**.
* Sync activity for the app appears on the [Dashboard](/idc/idc-core/dashboard.md) after the first sync.
* Log entries for the app show **Success** statuses.
* Data is appearing in NetSuite as expected.

## Common issues

* **Install button is missing or greyed out.** You may not have admin access — ask your integration admin. Or the app may already be installed; check the Apps page.
* **App installed but the Settings tab shows no fields.** The app may still be setting up. Wait a minute and refresh. If settings still don't appear, uninstall and reinstall from the Marketplace.
* **First sync shows all errors.** Open a log entry and read the error message. Common causes are incorrect connection credentials. Update your app settings and click **Reprocess** on the failed records in [Logs](/idc/idc-core/logs.md).
* **"No apps installed" appears on the Apps page.** No integrations have been set up yet. Go to the Marketplace to install your first one.
* **Uninstall button is greyed out.** You may not have admin access. Ask your integration admin to make the change.

## Related

* [Dashboard](/idc/idc-core/dashboard.md) — confirm your app is syncing after setup.
* [Logs](/idc/idc-core/logs.md) — investigate sync errors for a specific app.
* [Licenses](/idc/idc-core/licenses.md) — check license status if an app shows inactive or expired.
* [Troubleshooting](/idc/idc-core/troubleshooting.md) — common problems and fixes.


---

# Agent Instructions: 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:

```
GET https://docs.in8sync.com/idc/idc-core/apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
