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

# Marketplace and integrations

> Browse and install marketplace apps (OAuth), list Connect operators and teams, and manage the Jelou Shop catalog from the CLI.

## `jelou marketplace`

Browse, search, and install OAuth marketplace apps (Shopify, HubSpot, Slack…)
for your organization.

| Subcommand       | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| `list`           | Browse the available apps (search or filter to installed)     |
| `install <slug>` | Install an app by slug (opens the browser to authorize OAuth) |

```bash theme={null}
jelou marketplace list
jelou marketplace list --search "shopify" --json
jelou marketplace list --installed-only
jelou marketplace install hubspot
jelou marketplace install slack --print-url           # headless/SSH flows
jelou marketplace install shopify --metadata '{"shopify":{"shop":"mystore.myshopify.com"}}'
```

| Flag                | Description                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------- |
| `--search <q>`      | Filters by name or description                                                            |
| `--installed-only`  | Only already-installed apps                                                               |
| `--print-url`       | Prints the OAuth URL instead of opening the browser                                       |
| `--metadata <json>` | Metadata required by some apps (e.g. the Shopify store)                                   |
| `--timeout <sec>`   | OAuth polling timeout (default 120)                                                       |
| `--limit <n>`       | Max results (default 20)                                                                  |
| `--wait`            | In `--json` mode, poll until the app is installed (or `--timeout`) and report `installed` |

<Warning>
  Installing grants long-lived OAuth scopes over your organization's
  data; revoking is a multi-step process in the dashboard (not via
  CLI). If a slug matches multiple apps, the CLI asks you to choose. Some apps
  (Shopify, etc.) require app-specific `--metadata`.
</Warning>

## `jelou connect`

Lists operators and teams of the Connect product (human-handoff
flows).

```bash theme={null}
jelou connect operators list                       # active operators
jelou connect operators list --include-inactive    # includes deleted/inactive
jelou connect teams list --json
jelou connect operators list --json --out operators.json
```

* **Operators** are individual users with the operator role.
* **Teams** are groups of operators for team-based routing.
* The operator's `id` is the one referenced in a workflow's CONNECT node
  (`configuration.operatorId`).

## `jelou shop`

Manage Jelou Shop: per-company activation, configuration, branches,
categories, products, and catalog imports.

| Group            | Subcommands                                                     |
| ---------------- | --------------------------------------------------------------- |
| Setup            | `info`, `activate`, `settings`                                  |
| Branches         | `branches list/show/create/update/delete`                       |
| Categories       | `categories list/create/update/delete`                          |
| Products         | `products list/show/upsert/update/status/delete`                |
| External catalog | `accounts`, `syncs <accountId>`, `imports template/upload/show` |

```bash theme={null}
jelou shop activate --name "My Store" --contact-mail "support@example.com"
jelou shop settings --currency USD --tax-value 15
jelou shop products list --stock in_stock --search "shoe" --json
jelou shop products upsert --file products.json --sync
jelou shop imports template --lang es --output template.xlsx
jelou shop imports upload --file products.xlsx --uploaded-by "alex"
```

<Note>
  `shop activate` uses your `jelou login` credential (your Jelou API key) — it
  doesn't require a separate bootstrap key. Only **one activation per company** is allowed, and it
  refuses to overwrite an existing activation under `--no-input`. `products upsert` creates
  or updates products by SKU; use `--sync` to wait for the result.
</Note>