Integrations

Shopify — connect with OAuth

Connect a Shopify store to PullPush without pasting Admin API keys. The public Shopify app uses OAuth install: authorize once, PullPush creates an encrypted SOURCE connection and registers order webhooks.

Before you start

  1. A PullPush account at app.pullpush.ai
  2. A tenant API key (pp_…) from Settings → API Keys (used as ?token= on install)
  3. Your shop domain: your-store.myshopify.com

App Store listing is separate — dashboard-initiated OAuth works today when the Shopify app credentials are configured on the platform.

Install from the dashboard

  1. In PullPush open Connections → Add Connection → Shopify (or use the install URL below).
  2. Enter the shop domain and continue. PullPush redirects to Shopify’s authorize screen.
  3. Approve scopes, then return to PullPush. Sign in if asked and press Connect: only a member (MEMBER or higher) of the PullPush account the install link belongs to can do this. A SOURCE shopify connection is then created with envelope-encrypted credentials.
  4. Order webhooks (orders/create, orders/updated) are registered automatically.

Install URL (manual)

https://api.pullpush.ai/api/shopify/install?shop=YOUR-STORE.myshopify.com&token=pp_YOUR_TENANT_KEY

Replace the shop and token. Shopify-initiated installs verify HMAC; dashboard installs use the tenant token so the connection lands on the right workspace.

What syncs

Configured through PullPush flows (not inside Shopify Admin):

  • Orders — webhook + poll; outbound to fulfilment / accounting / 3PL
  • Stock / products — via inventory and product scopes as mapped in flows

Never writes 0 for “unknown” stock — missing data is skipped.

See Connections and Sync types.

Scopes

Least privilege used by the app:

Scope Why
read_orders Sync orders to destinations
read_products / write_products Catalog + stock updates
read_inventory / write_inventory Inventory levels across channels

GDPR / compliance

Shopify mandatory webhooks hit POST https://api.pullpush.ai/api/shopify/gdpr (customers/data_request, customers/redact, shop/redact), HMAC-verified.

Safety path

  1. Create the connection via OAuth
  2. Wire a flow in shadow mode
  3. Run preview before live writes

Troubleshooting

Symptom Fix
shopify_app_not_configured No Shopify app for this account: neither its own, its partner's nor the PullPush platform app is set up — contact support
Invalid shop Domain must be exactly *.myshopify.com
Connection missing after authorize Confirm the token= tenant key is valid and the tenant is active
Webhooks not firing Check connection status; re-install or open Support with the shop domain

Related