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 SYNCShopify e-commerce active just nowStripe payments active real-timeShipStation fulfillment active 2 min agoIntegration Categories
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/APIData 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.