TTruefold
← All guides

Connect Shopify

Truefold reads your Shopify orders, products, customers, and refunds so your store data can be modeled alongside your marketing and email data.

During the beta, you connect Shopify with a custom app you create inside your own Shopify admin, then paste its Admin API access token into Truefold. The access is read-only — Truefold never writes to, changes, or deletes anything in your store — and no passwords are ever shared.

Before you start

  • You need to be the store owner or a staff member with the "Develop apps" permission.
  • Have your store's domain handy — the my-store.myshopify.com address (not a custom domain like www.mystore.com).

Steps

  1. In your Shopify admin, go to Settings → Apps and sales channels → Develop apps. (If it's your first custom app, click Allow custom app development.)
  2. Click Create an app, name it Truefold, and create it.
  3. Open Configuration → Admin API integration → Configure, and enable these Admin API access scopes:
    • read_orders
    • read_products
    • read_customers (if available on your plan — see below) Save.
  4. Open the API credentials tab and click Install app.
  5. Under Admin API access token, click Reveal token once and copy it. It starts with shpat_. Shopify shows it only once — copy it now.
  6. In Truefold, go to Sources → Add source → Shopify → Connect, enter your shop domain and paste the Admin API access token, then click Connect Shopify.

About the customer scope (read_customers)

On Shopify Basic, custom apps can't be granted access to customer personal data, so read_customers may be unavailable. That's fine — Truefold will still sync orders and products, and only the customer/subscriber-level views (subscriber counts, first-purchase timing, cohorts) will be empty. On higher plans, enabling read_customers unlocks those.

Protected customer data

Order and customer records are protected customer data. Because this is your own custom app, that access is granted in your app's scope configuration — no separate Shopify review is required. Truefold minimizes what it stores and hashes email addresses at rest; it never keeps customer names, phone numbers, or addresses.

Troubleshooting

  • "The custom app is missing required scopes" — open the app's Admin API integration → Configure, enable read_orders and read_products, save, then reinstall the app and paste the new token.
  • "Admin API access tokens start with shpat_" — you may have copied the API key or API secret key instead; copy the Admin API access token from the API credentials tab.
  • "Enter a shop subdomain" — use the .myshopify.com address, not your custom storefront domain.
  • Lost the token — Shopify only reveals it once. Uninstall/reinstall the app (or rotate the token) to get a new one, then paste it in Truefold.