Sync Integration - Sequenzy

POST

api

integrations

{id}

sync

Sync Integration

curl --request POST \
  --url https://api.sequenzy.com/api/v1/integrations/{id}/sync \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/integrations/{id}/sync', 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/{id}/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/{id}/sync"

	req, _ := http.NewRequest("POST", 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/{id}/sync")

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

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

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

{
  "success": true,
  "integrationId": "int_abc123",
  "provider": "stripe",
  "jobId": "1042",
  "syncStatus": "queued",
  "message": "Sync queued for Stripe. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_def456",
  "provider": "supabase",
  "jobId": "2087",
  "syncStatus": "queued",
  "syncTarget": {
    "projectRef": "abcdefgh",
    "schema": "public",
    "table": "profiles"
  },
  "message": "Supabase user sync queued for public.profiles. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_ghi789",
  "provider": "posthog",
  "jobId": "3312",
  "syncStatus": "queued",
  "message": "PostHog event history import queued. It restarts from the beginning and re-imported events dedupe, so nothing is duplicated. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": false,
  "error": "Supabase user sync has no table configured. Pick the project, schema, and table once in Settings -> Integrations (Supabase); after that this backfill is re-runnable from the API."
}

{
  "success": false,
  "error": "Connect PostHog with a personal API key, region, and project ID before importing history."
}

{
  "success": false,
  "error": "Shopify does not support a manual sync from the API. Re-run the data sync from Settings -> Integrations in the dashboard. If you are trying to turn on storefront tracking (product views, cart activity, browse abandonment), use POST /v1/integrations/{id}/pixel instead - that part is API-triggerable."
}

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

{
  "success": false,
  "error": "API key is missing required scope: integrations:manage"
}

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

{
  "error": "A sync is already in progress for this integration."
}

{
  "success": false,
  "error": "A PostHog history import is already in progress. Wait for it to finish."
}

Queue a manual re-sync: customers and revenue for a payment provider, the user backfill for Supabase, or the event-history import for PostHog. Supported for Stripe, Polar, Paddle, Dodo, Creem, Chargebee, Whop, Supabase, and PostHog. Other providers re-sync from the dashboard, because their backfills need credentials and configuration selected at connect time. For PostHog this re-runs the event-history import against the personal API key, region, and project stored at connect time, and it is the supported way to retry a failed import. The import restarts from the beginning; already-imported events carry the same IDs the live webhook uses, so a re-run cannot duplicate them. Historical events never trigger automations. You get a 409 while an import is queued or syncing; terminal BullMQ failures release that state for retry. For Supabase this reads the project, schema, and table already configured for the integration - it cannot be pointed at a different table, and it returns 400 when no table has been configured yet. Run it after connecting Supabase: the database trigger only sends rows that change after it is installed, so users who existed before that have no attributes in Sequenzy until a backfill runs. The call returns immediately. Poll Get Integration to watch syncStatus and lastSyncAt, and List Integration Activity for per-row outcomes. Requires an API key with the integrations:manage scope.

Request

string

required

Integration ID, from List Integrations.

This endpoint takes no request body.

curl -X POST "https://api.sequenzy.com/api/v1/integrations/int_abc123/sync" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

string

Background job ID for the queued sync, or null when no job ID was returned.

string

Sync status after queueing, always queued on success.

object

Supabase only: the projectRef, schema, and table the backfill reads. Absent for providers whose sync has no configurable source.

Responses

{
  "success": true,
  "integrationId": "int_abc123",
  "provider": "stripe",
  "jobId": "1042",
  "syncStatus": "queued",
  "message": "Sync queued for Stripe. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_def456",
  "provider": "supabase",
  "jobId": "2087",
  "syncStatus": "queued",
  "syncTarget": {
    "projectRef": "abcdefgh",
    "schema": "public",
    "table": "profiles"
  },
  "message": "Supabase user sync queued for public.profiles. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_ghi789",
  "provider": "posthog",
  "jobId": "3312",
  "syncStatus": "queued",
  "message": "PostHog event history import queued. It restarts from the beginning and re-imported events dedupe, so nothing is duplicated. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": false,
  "error": "Supabase user sync has no table configured. Pick the project, schema, and table once in Settings -> Integrations (Supabase); after that this backfill is re-runnable from the API."
}

{
  "success": false,
  "error": "Connect PostHog with a personal API key, region, and project ID before importing history."
}

{
  "success": false,
  "error": "Shopify does not support a manual sync from the API. Re-run the data sync from Settings -> Integrations in the dashboard. If you are trying to turn on storefront tracking (product views, cart activity, browse abandonment), use POST /v1/integrations/{id}/pixel instead - that part is API-triggerable."
}

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

{
  "success": false,
  "error": "API key is missing required scope: integrations:manage"
}

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

{
  "error": "A sync is already in progress for this integration."
}

{
  "success": false,
  "error": "A PostHog history import is already in progress. Wait for it to finish."
}

Sync Integration

curl --request POST \
  --url https://api.sequenzy.com/api/v1/integrations/{id}/sync \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/integrations/{id}/sync', 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/{id}/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/{id}/sync"

	req, _ := http.NewRequest("POST", 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/{id}/sync")

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

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

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

{
  "success": true,
  "integrationId": "int_abc123",
  "provider": "stripe",
  "jobId": "1042",
  "syncStatus": "queued",
  "message": "Sync queued for Stripe. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_def456",
  "provider": "supabase",
  "jobId": "2087",
  "syncStatus": "queued",
  "syncTarget": {
    "projectRef": "abcdefgh",
    "schema": "public",
    "table": "profiles"
  },
  "message": "Supabase user sync queued for public.profiles. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": true,
  "integrationId": "int_ghi789",
  "provider": "posthog",
  "jobId": "3312",
  "syncStatus": "queued",
  "message": "PostHog event history import queued. It restarts from the beginning and re-imported events dedupe, so nothing is duplicated. Poll the integration to watch syncStatus and lastSyncAt."
}

{
  "success": false,
  "error": "Supabase user sync has no table configured. Pick the project, schema, and table once in Settings -> Integrations (Supabase); after that this backfill is re-runnable from the API."
}

{
  "success": false,
  "error": "Connect PostHog with a personal API key, region, and project ID before importing history."
}

{
  "success": false,
  "error": "Shopify does not support a manual sync from the API. Re-run the data sync from Settings -> Integrations in the dashboard. If you are trying to turn on storefront tracking (product views, cart activity, browse abandonment), use POST /v1/integrations/{id}/pixel instead - that part is API-triggerable."
}

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

{
  "success": false,
  "error": "API key is missing required scope: integrations:manage"
}

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

{
  "error": "A sync is already in progress for this integration."
}

{
  "success": false,
  "error": "A PostHog history import is already in progress. Wait for it to finish."
}

​Request

​Response fields

​Responses

Request

Response fields

Responses