Shopify Integration - Connect Your Shopify Store to AI Agents
Complete guide to connecting your Shopify store to GXO.dev for agentic commerce. Learn prerequisites, step-by-step setup, OAuth scopes, and troubleshooting.
Integrating Your Shopify Store with GXO.dev
Connect your Shopify store to GXO.dev and make your products discoverable by AI agents like ChatGPT, Claude, and Gemini.
This guide walks you through everything from setup to troubleshooting, ensuring your Shopify products are fully optimized for Agentic Commerce.
Prerequisites and Requirements
Shopify Store Requirements
Store Status
- Active Shopify store (not in development mode)
- Store must be publicly accessible
- Valid Shopify plan (Basic, Advanced, or Plus)
- Admin access to your Shopify store
Product Requirements
- Products have:
- Title
- Description
- Price
- At least one image
- Accurate inventory levels
- Proper category/taxonomy
Technical Requirements
- Stable internet connection
- Modern browser (Chrome, Safari, Edge, or Firefox)
- JavaScript enabled
- Pop-up blockers disabled
GXO.dev Account Requirements
Account Setup
- Active GXO.dev account
- Completed profile setup
- Active subscription plan (Starter or higher)
- Team permissions (if applicable)
Permissions Needed
- Platform integration access
- Product management rights
- Analytics access
- Settings modification permissions
💡 Tip: If you’re part of a team, ensure your user role includes “Integrations” and “Products” permissions in Settings → Team → Members.
Step-by-Step Connection Guide
Step 1: Access Shopify Integration
- Log in to your GXO.dev dashboard
- Click Integrations in the sidebar
- Select Shopify
- Click Connect Shopify Store
- You’ll be redirected to the setup page
Step 2: Enter Store Information
Enter Store Domain
- Format:
yourstore.myshopify.com - Example:
mystore.myshopify.com - Exclude
https://or trailing slashes
- Format:
Verify Store URL
- GXO.dev confirms the store exists
- Must be publicly accessible
- Ensure it’s not in development mode
Step 3: Shopify OAuth Authorization
Redirect to Shopify
- Click Connect to Shopify
- Log in to your Shopify admin (if prompted)
Review Permissions
- read_products – access product details
- read_inventory – access inventory counts
- read_orders (optional) – access order data for analytics
Authorize Connection
- Click Install App
- Review and approve requested scopes
- Confirm installation
Step 4: Connection Verification
- You’ll be redirected back to GXO.dev
- Your Shopify store will appear as Connected
- A success message confirms setup completion
- Review the connection status indicator (🟢 Green = Active)
- Confirm first product sync has started
OAuth Scopes and Permissions
Required Permissions
read_products
- Purpose: Access product details for AI agent discovery
- Data Accessed: Titles, descriptions, prices, images
- Usage: Create ACP-compliant product feeds
- Security: Read-only
read_inventory
- Purpose: Track inventory for accurate AI recommendations
- Data Accessed: Stock counts, statuses
- Usage: Maintain real-time product availability
- Security: Read-only
Optional Permissions
read_orders
- Purpose: Track AI-attributed sales and conversions
- Data Accessed: Order summaries and totals
- Usage: Analytics attribution
- Security: Read-only
read_customers
- Purpose: Enable personalization analytics
- Data Accessed: Customer demographics and purchase history
- Usage: Personalized AI recommendations
- Security: Read-only
Permission Management
View Current Permissions
- Go to Integrations → Shopify → Settings
- Review permission status and expiration
- Monitor API usage
Updating Permissions
- Re-authorize if scopes change
- Remove unused permissions
- Regularly verify token validity
Product Sync Settings
Automatic Synchronization
Real-Time Updates
- Inventory changes sync immediately
- Price updates reflected within minutes
- Product additions sync automatically
Sync Frequency Options
| Type | Use Case |
|---|---|
| Real-time | Critical inventory or price changes |
| Hourly | Frequent catalog updates |
| Daily | Standard catalog management |
| Manual | Testing or troubleshooting |
Manual Synchronization
Force Sync
- Click Sync Now
- Use when troubleshooting or validating data
- Ensures immediate data refresh
Selective Sync
- Sync by product category, tag, or vendor
- Filter out draft or hidden items
- Update specific listings only
Sync Configuration
Product Filtering
- Include/exclude by product type
- Filter by minimum price threshold
- Exclude out-of-stock items
Data Mapping
- Map Shopify fields to ACP format
- Customize product descriptions and metadata
- Configure variant handling (size, color, etc.)
Advanced Configuration
Custom Product Mapping
Field Mapping
- Map Shopify fields → ACP fields
- Configure variant data (SKU, options)
- Define AI-relevant metadata (tags, material, features)
Data Transformation
- Add natural-language phrasing
- Optimize titles for AI discovery
- Include contextual attributes (e.g., “great for travel”)
Webhook Integration
Setup Steps
- Go to Integrations → Shopify → Webhooks
- Click Enable Webhooks
- Choose event types to monitor
- Confirm delivery endpoint in GXO.dev
Supported Events
- Product updates
- Inventory changes
- Order creation events (optional)
- Error or failure alerts
🔔 Webhooks allow near-instant updates between Shopify and GXO.dev, ensuring your AI feeds stay current.
Performance Optimization
Sync Optimization
- Use incremental sync for large catalogs
- Monitor API usage and adjust frequency
- Track sync duration and error rates
Data Quality
- Regularly audit product data
- Improve image quality and consistency
- Keep descriptions complete and accurate
Security and Privacy
Data Protection
- Encrypted data transmission
- Secure token management
- OAuth tokens stored using industry-standard encryption
- Regular internal audits
Access Control
- Role-based permissions
- Integration audit logs
- Token rotation and access expiration
Privacy Compliance
- GDPR: Right to deletion, transparent processing, retention policies
- CCPA: Customer data disclosure, opt-out mechanisms
- Privacy-first by design
Monitoring and Analytics
Connection Health
- Real-time connection status
- API latency and uptime monitoring
- Error detection and reporting
Alerts
- Email notifications for connection errors
- Dashboard alerts for degraded performance
- API quota warnings
Performance Metrics
Sync Performance
- Sync success/failure rates
- Average processing time per batch
- API request volume
Product Performance
- AI agent interactions
- Conversions and attributions
- GMV impact and growth trends
📈 See Analytics Dashboard Overview to monitor your performance in real time.
Best Practices
Before Connecting
- Ensure product data is complete and high quality
- Verify accurate pricing and inventory
- Use clear, consistent categories and tags
- Write descriptive, AI-friendly product copy
After Connecting
- Verify initial sync completed successfully
- Test AI discovery in AI Previews
- Configure sync frequency and webhook alerts
- Monitor analytics for early insights
Ongoing Maintenance
- Weekly sync and data health checks
- Regular title and image optimization
- Quarterly product catalog audits
- Update variants and tags as products evolve
Next Steps
Now that your Shopify store is connected:
- Configure Product Sync Settings
- Set Up Webhook Notifications
- Optimize Product Data
- Monitor Performance Analytics
Support and Resources
Getting Help
- Documentation: Comprehensive guides for every feature
- Support: Email support for all plans, priority for Pro+
- Community: Join our Discord Community
- Training: Video tutorials and webinars
Shopify Resources
Connect your Shopify store to GXO.dev and bring your products into the age of AI-powered commerce. Every query becomes a chance for discovery.