List Integration Suggestions

GET

api

integrations

suggestions

curl --request GET \
  --url https://api.sequenzy.com/api/v1/integrations/suggestions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/integrations/suggestions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/integrations/suggestions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/integrations/suggestions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/integrations/suggestions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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" }
    ]
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

{
  "success": false,
  "error": "Company not found"
}

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

curl "https://api.sequenzy.com/api/v1/integrations/suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

string | null

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

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.

object[]

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

Show properties

string

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

string

Display name, such as Clerk.

string

Catalog category, such as auth or analytics.

string

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

string | null

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

object | null

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

Show properties

string

Always pricing_found.

integer

Pricing plans read from your website or entered in settings.

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 with provider set. API-key providers connect with Connect Integration. OAuth and app-install providers need the dashboard.

Responses

{
  "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" }
    ]
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

{
  "success": false,
  "error": "Company not found"
}

List Integration Suggestions

curl --request GET \
  --url https://api.sequenzy.com/api/v1/integrations/suggestions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/integrations/suggestions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/integrations/suggestions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/integrations/suggestions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/integrations/suggestions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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" }
    ]
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

{
  "success": false,
  "error": "Company not found"
}

​Request

​Response fields

​Responses

Request

Response fields

Responses