Connect Integration

POST

api

integrations

connect

Connect Integration

curl --request POST \
  --url https://api.sequenzy.com/api/v1/integrations/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "<string>",
  "webhookSecret": "<string>",
  "apiKey": "<string>",
  "providerAccountId": "<string>",
  "settings": {},
  "historyImport": {}
}
'

import requests

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

payload = {
    "provider": "<string>",
    "webhookSecret": "<string>",
    "apiKey": "<string>",
    "providerAccountId": "<string>",
    "settings": {},
    "historyImport": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: '<string>',
    webhookSecret: '<string>',
    apiKey: '<string>',
    providerAccountId: '<string>',
    settings: {},
    historyImport: {}
  })
};

fetch('https://api.sequenzy.com/api/v1/integrations/connect', 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/connect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => '<string>',
    'webhookSecret' => '<string>',
    'apiKey' => '<string>',
    'providerAccountId' => '<string>',
    'settings' => [
        
    ],
    'historyImport' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/integrations/connect")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}"

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

{
  "success": true,
  "integration": {
    "id": "int_abc123",
    "provider": "paddle",
    "name": "Paddle",
    "providerAccountId": "12345",
    "isActive": true,
    "syncEnabled": true,
    "syncStatus": null,
    "connectedAt": "2026-08-02T10:00:00.000Z"
  },
  "webhookUrl": "https://api.sequenzy.com/api/webhooks/paddle/comp_123",
  "revenueSyncQueued": true
}

{
  "success": false,
  "error": "Stripe cannot be connected through the API: its connection runs an OAuth, app-install, or plugin flow that needs a human in the dashboard. Connect it from Settings -> Integrations."
}

{
  "success": false,
  "error": "Invalid Polar API key. Please check and try again."
}

{
  "success": false,
  "error": "The Whop API key is missing one or more required read permissions."
}

{
  "success": false,
  "error": "This Paddle account is already connected to \"Other Workspace\""
}

Connect an integration whose setup only needs an API key and/or a webhook signing secret: Polar, Paddle, Dodo Payments, Whop, Creem, Chargebee, Clerk, PostHog, or Affonso. Credentials are validated against the provider where possible, stored encrypted, and never returned by any endpoint. Payment providers queue their initial revenue backfill automatically; Affonso queues its affiliate backfill; PostHog can optionally import its event history. The response includes webhookUrl - configure it in the provider’s webhook settings with the same secret you passed here, or live events will not arrive. Calling this for an already-connected provider replaces its stored credentials. OAuth and app-install providers (Stripe, Shopify, Supabase, GitHub, WooCommerce, Meta) cannot be connected here: their flows need a browser, so they return a 400 pointing at the dashboard. Use Integration Catalog to discover each connectable provider’s exact fields via connectFields. Requires an API key with the integrations:manage scope.

Request

string

required

One of polar, paddle, dodo, whop, creem, chargebee, clerk, posthog, affonso.

string

required

Signing secret of the webhook you create at the provider, pointed at the returned webhookUrl. For Chargebee, pass the webhook’s basic-auth credentials as username:password.

string

Provider API key. Required for every provider except Clerk and PostHog.

string

Provider account ID. Required for Paddle (seller ID), Dodo (business ID), Whop (company ID, biz_...), Creem (store ID), and Chargebee (site name). Polar resolves it from the API key; Clerk, PostHog, and Affonso derive it.

object

PostHog only: { syncAllEvents?: boolean, eventAllowlist?: string[] }. Defaults to syncing every non-internal event.

object

PostHog only: { region: "us" | "eu", projectId: string, personalApiKey: string }. Imports the project’s event history after connecting; the personal API key needs query read access.

curl -X POST "https://api.sequenzy.com/api/v1/integrations/connect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "paddle",
    "apiKey": "pdl_live_apikey_...",
    "webhookSecret": "pdl_ntfset_...",
    "providerAccountId": "12345"
  }'

Response fields

object

The connected integration, in the same shape as List Integrations. Credentials are never included.

string

URL to configure in the provider’s webhook settings with the same secret.

boolean

Payment providers only: whether the initial revenue backfill was queued.

boolean

Affonso only: whether the affiliate backfill was queued.

object

PostHog only: {(requested, queued, error)} for the optional history import. The webhook connection succeeds even when queueing the import failed.

Responses

{
  "success": true,
  "integration": {
    "id": "int_abc123",
    "provider": "paddle",
    "name": "Paddle",
    "providerAccountId": "12345",
    "isActive": true,
    "syncEnabled": true,
    "syncStatus": null,
    "connectedAt": "2026-08-02T10:00:00.000Z"
  },
  "webhookUrl": "https://api.sequenzy.com/api/webhooks/paddle/comp_123",
  "revenueSyncQueued": true
}

{
  "success": false,
  "error": "Stripe cannot be connected through the API: its connection runs an OAuth, app-install, or plugin flow that needs a human in the dashboard. Connect it from Settings -> Integrations."
}

{
  "success": false,
  "error": "Invalid Polar API key. Please check and try again."
}

{
  "success": false,
  "error": "The Whop API key is missing one or more required read permissions."
}

{
  "success": false,
  "error": "This Paddle account is already connected to \"Other Workspace\""
}

List Integration ActivityRead recent integration webhook and sync activity

Connect Integration

curl --request POST \
  --url https://api.sequenzy.com/api/v1/integrations/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "<string>",
  "webhookSecret": "<string>",
  "apiKey": "<string>",
  "providerAccountId": "<string>",
  "settings": {},
  "historyImport": {}
}
'

import requests

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

payload = {
    "provider": "<string>",
    "webhookSecret": "<string>",
    "apiKey": "<string>",
    "providerAccountId": "<string>",
    "settings": {},
    "historyImport": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: '<string>',
    webhookSecret: '<string>',
    apiKey: '<string>',
    providerAccountId: '<string>',
    settings: {},
    historyImport: {}
  })
};

fetch('https://api.sequenzy.com/api/v1/integrations/connect', 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/connect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => '<string>',
    'webhookSecret' => '<string>',
    'apiKey' => '<string>',
    'providerAccountId' => '<string>',
    'settings' => [
        
    ],
    'historyImport' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/integrations/connect")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"<string>\",\n  \"webhookSecret\": \"<string>\",\n  \"apiKey\": \"<string>\",\n  \"providerAccountId\": \"<string>\",\n  \"settings\": {},\n  \"historyImport\": {}\n}"

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

{
  "success": true,
  "integration": {
    "id": "int_abc123",
    "provider": "paddle",
    "name": "Paddle",
    "providerAccountId": "12345",
    "isActive": true,
    "syncEnabled": true,
    "syncStatus": null,
    "connectedAt": "2026-08-02T10:00:00.000Z"
  },
  "webhookUrl": "https://api.sequenzy.com/api/webhooks/paddle/comp_123",
  "revenueSyncQueued": true
}

{
  "success": false,
  "error": "Stripe cannot be connected through the API: its connection runs an OAuth, app-install, or plugin flow that needs a human in the dashboard. Connect it from Settings -> Integrations."
}

{
  "success": false,
  "error": "Invalid Polar API key. Please check and try again."
}

{
  "success": false,
  "error": "The Whop API key is missing one or more required read permissions."
}

{
  "success": false,
  "error": "This Paddle account is already connected to \"Other Workspace\""
}

Overview

Companies

Sync Rules

Shopify

Websites

Integrations

Sender Profiles

Tracking Settings

Notification Preferences

Subscribers

Tags

Lists

Events

Segments

Audience Syncs

Migrations

Products

Media

Analytics

Sequences

Generation

SMS

Campaigns

Landing Pages

Emails

A/B Tests

Email Sends

Suppressions

Transactional

Templates

Widgets

Commerce

Webhooks

Team

Conversations

Connect Integration

Request

Response fields

Responses

​Request

​Response fields

​Responses

Request

Response fields

Responses