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

# List Integration Suggestions

> Suggest integrations to connect, based on what is on your website

Suggest integrations to connect next, based on what Sequenzy found on your website when you added your company. This is the same list the dashboard home screen shows.

Sequenzy reads your homepage, the scripts it loads, and the sign-in page it links to. Without one, it tries the app it links to, then your `app.` and `dashboard.` subdomains. Auth tools such as Clerk and Supabase usually load there rather than on the marketing site. It looks for:

* Clerk and Supabase
* PostHog and Segment
* WooCommerce, WordPress, Webflow and Wix
* A Shopify storefront

Only script URLs, API hosts and platform markers count, never product names in your page copy. Providers you have already connected are left out.

Payment providers are never guessed, because checkout scripts rarely load on marketing pages. If your website lists pricing and you have no payment or commerce integration, `paymentProviders` lists every payment provider so you can pick yours.

Requires the `account:read` scope.

## Request

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/integrations/suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

**websiteUrl** `string | null`

The company website the suggestions were read from. `null` for a company
without a website.

**scanComplete** `boolean`

`false` while Sequenzy is still reading your website, including the scan for
the tools it uses, which can finish a few seconds after the rest. An empty
list then means the site has not been scanned yet, not that nothing was found.

**suggestions** `object[]`

Detected providers that are not connected yet, in suggestion order: Shopify,
then auth, product analytics and site platforms.

**properties**

**provider** `string`

`shopify`, `clerk`, `supabase`, `posthog`, `segment`, `woocommerce`,
`wordpress`, `webflow`, or `wix`.

**name** `string`

Display name, such as `Clerk`.

**category** `string`

Catalog category, such as `auth` or `analytics`.

**evidence** `string`

Where it was found: `homepage`, `sign_in_page`, or `storefront` (the site
runs on Shopify).

**shopDomain** `string | null`

The `*.myshopify.com` domain for a Shopify suggestion when one was found.
`null` otherwise.

**paymentProviders** `object | null`

Present when your website lists pricing and no payment or commerce
integration is connected. `null` otherwise, including for Shopify stores.

**properties**

**reason** `string`

Always `pricing_found`.

**pricingPlanCount** `integer`

Pricing plans read from your website or entered in settings.

**providers** `object[]`

Every available payment provider, each with `provider` and `name`.

To see what a suggested provider gives you and how it connects, call [List Integration Capabilities](https://docs.sequenzy.com/api-reference/integrations/catalog.md) with `provider` set. API-key providers connect with [Connect Integration](https://docs.sequenzy.com/api-reference/integrations/connect.md). OAuth and app-install providers need the dashboard.

## Responses

```json 200 theme={null}
{
  "success": true,
  "websiteUrl": "https://lumenhq.io",
  "scanComplete": true,
  "suggestions": [
    {
      "provider": "clerk",
      "name": "Clerk",
      "category": "auth",
      "evidence": "sign_in_page",
      "shopDomain": null
    },
    {
      "provider": "posthog",
      "name": "PostHog",
      "category": "analytics",
      "evidence": "homepage",
      "shopDomain": null
    }
  ],
  "paymentProviders": {
    "reason": "pricing_found",
    "pricingPlanCount": 2,
    "providers": [
      { "provider": "stripe", "name": "Stripe" },
      { "provider": "polar", "name": "Polar" },
      { "provider": "paddle", "name": "Paddle" }
    ]
  }
}
```

```json 401 theme={null}
{
  "success": false,
  "error": "Unauthorized"
}
```

```json 403 theme={null}
{
  "success": false,
  "error": "API key is missing required scope: account:read"
}
```

```json 404 theme={null}
{
  "success": false,
  "error": "Company not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.