Integration Overview
Connect external platforms to power your agentic commerce infrastructure.
Overview
Integrations connect Hyperfold to your existing business systems—e-commerce platforms, payment providers, fulfillment services, and CRMs. Once connected, your agents can access real-time data and perform actions across all systems.
# Connect your first integration
$ hyperfold integrate add shopify
# Follow the OAuth flow...
✓ Shopify connected
✓ 2,847 products synced
✓ Webhooks configured
# View integration status
$ hyperfold integrate list
INTEGRATIONS
NAME TYPE STATUS LAST SYNC
Shopify e-commerce active just now
Stripe payments active real-time
ShipStation fulfillment active 2 min ago
Integration Categories
E-commerce Platforms — Sync products, inventory, orders, and customers from your store.
Payment Providers — Process payments securely with Shared Payment Tokens.
Fulfillment Services — Automate shipping label creation and tracking.
CRM & ERP — Access customer data and business intelligence for personalized commerce.
Getting Started
Connecting an integration typically follows these steps:
| Step | Description |
|---|---|
| 1. Add Integration | Use CLI or API to initiate connection |
| 2. Authenticate | Complete OAuth flow or provide API credentials |
| 3. Configure Sync | Choose what data to sync and how often |
| 4. Map Fields | Define how external fields map to Hyperfold schema |
| 5. Initial Sync | Import existing data from external system |
Architecture
# How data flows through integrations
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ External │ │ Hyperfold │ │ Agents │
│ Systems │◄────►│ Platform │◄────►│ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
Shopify Unified Negotiator
Stripe Data Model Fulfillment
ShipStation + Sync Engine Recommender
# Data sync modes:
# - Real-time: Webhooks push changes instantly
# - Polling: Scheduled sync every N minutes
# - On-demand: Manual sync via CLI/API
Data Flow
Integrations maintain a unified data model that agents use regardless of source:
- Products → Hyperfold Catalog (with semantic enrichment)
- Customers → Customer Profiles (with unified history)
- Orders → Order Management (cross-channel)
- Inventory → Real-time stock levels (multi-location)
Best Practices
Start with Core Integrations — Connect your e-commerce platform and payment provider first. These are essential for basic agent operations.
Use Webhooks When Available — Real-time webhooks provide instant updates. Polling should be a fallback for systems that don't support webhooks.
Test in Sandbox First — Use sandbox/test environments when available. Validate data mappings before enabling production sync.
Monitor Sync Health — Set up alerts for sync failures. Check integration dashboards regularly for errors or data discrepancies.