Hyperfold AI
Back

Dec 17, 2025

Shopify Integration Setup

H
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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 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:

yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 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:

bash
1
2
3
4
5
6
$ 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