Dec 17, 2025

Shopify Integration Setup

Hyperfold Team

Integrations

Overview

The Shopify integration enables bidirectional sync between your Shopify store and Hyperfold. Products flow from Shopify into Hyperfold's semantic catalog, while agent-generated orders flow back to Shopify for fulfillment.

Hyperfold doesn't replace Shopify—it enhances it with AI agent capabilities while keeping your existing store operations intact.

Connecting Shopify

Connect your Shopify store using OAuth or API credentials:

# Connect Shopify via OAuth
$ hyperfold integrate add shopify

> [OAuth] Opening Shopify authorization...
> Select your store and approve permissions
> [Verify] Checking API scopes...

✓ Shopify connected!

Store:     acme-sports.myshopify.com
Products:  1,489
Locations: 2

# Or with API credentials directly
$ hyperfold integrate add shopify \
--store="acme-sports.myshopify.com" \
--api-key="shpat_xxx" \
--api-secret="yyy"

Required Shopify API scopes:

read_products, write_products
read_orders, write_orders
read_inventory, write_inventory
read_locations

Product Sync

Import your product catalog and enable automatic sync:

# Initial product sync
$ hyperfold catalog product-import --source=shopify

> [Shopify] Fetching products (1,489 total)...
> [Transform] Converting to Hyperfold schema...
> [Enrich] Generating semantic embeddings...
> [Store] Writing to Firestore...

✓ Synced 1,489 products

# Enable webhook-based auto-sync
$ hyperfold integrate configure shopify --sync=webhook

> [Webhook] Registering product/create webhook...
> [Webhook] Registering product/update webhook...
> [Webhook] Registering product/delete webhook...

✓ Auto-sync enabled

Field Mapping

Customize how Shopify fields map to Hyperfold's product schema:

# shopify-mapping.yaml
mappings:
products:
  # Shopify field → Hyperfold field
  id: product_id
  title: name
  body_html: description
  vendor: attributes.brand
  product_type: semantics.category
  variants[].price: pricing.list_price
  variants[].sku: sku
  variants[].inventory_quantity: inventory.quantity

# Custom field transformations
transforms:
  - source: tags
    target: semantics.tags
    transform: split(',')

  - source: body_html
    target: description
    transform: stripHtml

Order Sync

When an agent completes a purchase, Hyperfold automatically creates the corresponding order in Shopify:

# Order sync flow:
# 1. Buyer agent completes checkout via ACP
# 2. Hyperfold creates order record
# 3. Order synced to Shopify with agent metadata
# 4. Fulfillment updates sync back to Hyperfold

# Check sync status
$ hyperfold integrate status shopify

ORDER SYNC:
Last sync:     2 minutes ago
Orders synced: 8,234
Pending sync:  3
Errors:        0

Inventory Management

Enable real-time inventory sync to prevent overselling:

$ hyperfold integrate configure shopify --inventory=realtime

✓ Real-time inventory sync enabled

Hyperfold ← Shopify: On product update
Hyperfold → Shopify: On order completion

Troubleshooting

Common issues and solutions:

Products not syncing: Check webhook registration with hyperfold integrate webhooks list
Inventory mismatch: Run hyperfold integrate sync shopify --inventory --force
Order creation failed: Verify Shopify API scopes include write_orders