Skip to main content

Connect Shopify Store

Goal​

Link a Shopify store to Nexus to automatically sync orders, customers, and fulfillment status.

Preconditions​

  • You have a Shopify store with admin access.
  • You are an owner or admin of the Nexus organization.

Steps​

  1. Navigate to Settings → Integrations → Shopify.
  2. Enter your Shopify store domain (e.g., mystore.myshopify.com).
  3. Click Connect. Nexus requests the following Shopify Admin API scopes:
    • read_orders, write_orders
    • read_customers
    • read_products
    • read_fulfillments, write_fulfillments
  4. Approve the permission request in Shopify.
  5. Nexus registers webhooks for orders/create, orders/updated, customers/create, and customers/update.
  6. Existing orders can be imported via an initial sync (Settings → Shopify → Run Initial Sync).

Expected result​

  • New Shopify orders appear automatically in the Nexus Orders module.
  • Shopify customers are merged into the Nexus contact list via crm-customer-resolver.
  • Fulfillment status updates in Nexus are pushed back to Shopify via shopify-fulfill.

Common issues​

IssueResolution
Webhook registration failedVerify the Shopify API key has write_orders scope; check Shopify Admin → Notifications → Webhooks.
Duplicate customerscrm-customer-resolver merges by phone number and email. Ensure customer records have at least one matching field.
Orders not syncingCheck that the Shopify webhook endpoint is reachable. Verify in Supabase Edge Function logs.