How It Works
- You install the Tranthor Sync app in your Shopify admin.
- You provide a Tranthor workspace ID and Write Key.
- The app registers Shopify webhooks to Tranthor’s public webhook endpoint.
- 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:- Builds a brand kit from your store.
- Brings in your data.
- Finds your best opportunities.
- Drafts your first campaign in your brand.
Required Shopify Scopes
read_productsread_customersread_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/createorders/updatedorders/paidorders/fulfilledorders/cancelledcustomers/createcustomers/updateproducts/update- Compliance:
customers/data_request,customers/redact,shop/redact
Webhook URL Format
<workspaceId> with your Tranthor workspace ID.
Tranthor Backend Requirements
Set the following environment variable so Tranthor can verify Shopify HMAC signatures:/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
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_createdshopify_order_updatedshopify_order_paidshopify_order_fulfilledshopify_order_cancelledshopify_customer_createdshopify_customer_updatedshopify_product_updated

