---
title: "List integration suggestions"
method: GET
path: "/integrations/suggestions"
tags: ["Integrations"]
---

# List integration suggestions

`GET /integrations/suggestions`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/integrations/suggestions`
- Auth: HTTP bearer

Suggests integrations to connect next, from what Sequenzy found on the company's website during onboarding: tools on the homepage or on the sign-in page it links to (Clerk, Supabase, PostHog, Segment, Webflow, Wix, WordPress, WooCommerce) or a Shopify storefront. Connected providers are left out. Payment providers are never guessed from the site: when it lists pricing and no payment or commerce integration is connected, paymentProviders lists every payment provider. Requires the account:read scope.

## Response `200`

Suggestions returned

- object
  - `success` boolean, required
  - `websiteUrl` string, nullable, required: The company website the suggestions were read from.
  - `scanComplete` boolean, required: False while onboarding is still reading the website, including the tool scan, 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[], required: Detected providers that are not connected, in suggestion order.
    - `provider` 'shopify' | 'clerk' | 'supabase' | 'posthog' | 'segment' | 'woocommerce' | 'wordpress' | 'webflow' | 'wix', required
    - `name` string, required
    - `category` string, required
    - `evidence` 'homepage' | 'sign_in_page' | 'storefront', required: Where the provider was found. storefront means the site runs on Shopify.
    - `shopDomain` string, nullable, required: The myshopify.com domain for a Shopify suggestion when one was found; null otherwise.
  - `paymentProviders` object, nullable, required: Present when the website lists pricing and no payment or commerce integration is connected; null otherwise.
    - `reason` 'pricing_found', required
    - `pricingPlanCount` integer, required: Pricing plans read from the website or entered in settings.
    - `providers` object[], required: Every available payment provider.
      - `provider` string, required
      - `name` string, required

## Other responses

- `401`: Unauthorized
- `403`: The API key is missing the account:read scope
- `404`: Company not found
- `503`: The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-10-25** `a03cd444a509`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/integrations/suggestions/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)
