Skip to main content
Tranthor Sync is a Shopify app that connects your store to Tranthor’s analytics pipeline. It syncs historical data (orders, customers, products) and streams real-time updates via Shopify webhooks.

How It Works

  1. You install the Tranthor Sync app in your Shopify admin.
  2. You provide a Tranthor workspace ID and Write Key.
  3. The app registers Shopify webhooks to Tranthor’s public webhook endpoint.
  4. Tranthor ingests events into your workspace and updates analytics.

What happens when you connect

Connecting your store also starts your workspace setup, so you do not need to build anything first. As soon as the Tranthor Sync app connects, Tranthor:
  1. Builds a brand kit from your store.
  2. Brings in your data.
  3. Finds your best opportunities.
  4. Drafts your first campaign in your brand.
You can follow these steps on the Activating screen, or leave it. The work continues in the background, and you can go to the dashboard at any time. When the draft is ready, the screen shows a preview of the email, with Approve & send and Review in detail. Nothing is sent until you approve it. If a first draft cannot be created automatically, you can create one anytime from Agents.

Required Shopify Scopes

  • read_products
  • read_customers
  • read_orders
Note: Shopify requires Protected Customer Data approval for public apps to access orders and customers on non-development stores. Until approved, the app can sync products only.

Webhook Topics

  • orders/create
  • orders/updated
  • orders/paid
  • orders/fulfilled
  • orders/cancelled
  • customers/create
  • customers/update
  • products/update
  • Compliance: customers/data_request, customers/redact, shop/redact

Webhook URL Format

Replace <workspaceId> with your Tranthor workspace ID.

Tranthor Backend Requirements

Set the following environment variable so Tranthor can verify Shopify HMAC signatures:
Optional hardening for sync handoff:
If set, configure the same value in the Shopify Sync app so /api/public/shopify/connect/resolve requires x-tranthor-connect-shared-secret.

App Configuration

In the Shopify app settings UI, enter:
  • Tranthor workspace ID
  • Tranthor Write Key
The Tranthor Write Key is the base64-encoded secretId:writeKeyValue token shown in the dashboard (Settings → Integrations → Shopify → Manual setup values). It is not the raw secret value — the encoded token is required so Tranthor can resolve the secret. The app prefixes it with the Basic scheme itself when calling Tranthor’s public ingestion API:

Event Names in Tranthor

  • shopify_order_created
  • shopify_order_updated
  • shopify_order_paid
  • shopify_order_fulfilled
  • shopify_order_cancelled
  • shopify_customer_created
  • shopify_customer_updated
  • shopify_product_updated

Support

If you need help onboarding your Shopify store, reach out to the Tranthor team through the dashboard support channel.