BigCommerce Installation Guide

Connect your BigCommerce store to Synton AI for AI-powered commerce management and cross-platform advertising.

Prerequisites

Before connecting, ensure you have:

Requirement	Details
BigCommerce Store	Active store on any plan (Standard, Plus, Pro, Enterprise)
Store Owner or Admin Role	Permission to create API accounts
SSL Certificate	Automatic with BigCommerce (no action needed)

Multi-Storefront Support

BigCommerce Multi-Storefront is fully supported. Each storefront can be managed independently within Synton AI.

Step 1: Create Synton AI Account

1. Visit app.synton.ai
2. Click Sign Up
3. Select BigCommerce as your platform
4. Complete registration with your email
5. Verify your email address

Step 2: Create API Credentials in BigCommerce

1. Log into your BigCommerce control panel
2. Navigate to Settings > API > API Accounts
3. Click Create API Account
4. Select V2/V3 API Token (not OAuth)

Configure API Account

Account Name: Synton AI Integration

OAuth Scopes (required permissions):

Resource	Permission
Products	Modify
Orders	Read-only
Customers	Read-only
Content	Read-only
Carts	Read-only
Checkouts	Read-only
Store Inventory	Modify
Channel Settings	Read-only
Sites & Routes	Read-only
Marketing	Read-only

5. Click Save

Save Your Credentials

BigCommerce will display your API credentials only once:

• API Path: e.g., https://api.bigcommerce.com/stores/abc123/v3/
• Client ID: Long alphanumeric string
• Access Token: Long alphanumeric string

Store These Securely

The Access Token is shown only once. Copy all three values immediately. If lost, you must regenerate the entire API account.

Step 3: Connect to Synton AI

Option A: Manual Connection (Recommended)

1. Log into app.synton.ai
2. Navigate to Settings > Integrations
3. Click the BigCommerce card
4. Enter your credentials:
   • Store Hash: Extract from API Path
     • From https://api.bigcommerce.com/stores/abc123/v3/
     • Store Hash is abc123
   • Client ID: Paste from BigCommerce
   • Access Token: Paste from BigCommerce
5. Click Connect
6. Wait for connection verification (5-10 seconds)

Option B: OAuth Connection

For enhanced security with automatic credential management:

1. In Synton dashboard, click Connect with OAuth
2. Log into your BigCommerce account when prompted
3. Review and authorize the requested permissions
4. You'll be redirected back to Synton automatically
5. Connection is complete

OAuth Benefits

OAuth connection automatically rotates credentials and doesn't require manual token management. Recommended for enterprise users.

Step 4: Configure Integration Settings

Navigate to Settings > Integrations > BigCommerce in Synton:

Setting	Description	Recommended
Sync Frequency	How often to sync data	Real-time
Include Variants	Sync all product variants	Yes
Order History	Import historical orders	Last 90 days
Currency	Primary reporting currency	Store default
Enable Webhooks	Real-time event notifications	Enabled

Click Save Settings.

Verification

Check Connection Status

1. In Synton, go to Settings > Integrations > BigCommerce
2. Verify connection status shows Connected with green indicator
3. Click Test Connection to verify API access
4. You should see:
   • ✅ API Connection Successful
   • ✅ Products Accessible
   • ✅ Orders Accessible
   • ✅ Webhooks Configured

Verify Data Sync

1. In Synton dashboard, navigate to Chat
2. Ask: "How many products do I have?"
3. Verify the count matches your BigCommerce catalog
4. Ask: "Show me recent orders"
5. Verify orders appear with correct data

Check Webhooks

Synton automatically creates BigCommerce webhooks. To verify:

1. In BigCommerce, go to Settings > API > Webhooks
2. You should see entries for:
   • store/product/created
   • store/product/updated
   • store/product/deleted
   • store/order/created
   • store/order/updated
   • store/customer/created
3. All should have Status: Active and point to https://api.synton.ai/webhooks/bigcommerce

Initial Sync

After connection, an initial sync begins automatically:

1. In Synton, go to Settings > Integrations > BigCommerce
2. You'll see Initial Sync Progress
3. Sync time depends on catalog size:
   • Small (< 100 products): 1-2 minutes
   • Medium (100-1,000 products): 5-10 minutes
   • Large (1,000-10,000 products): 30-60 minutes
   • Very large (> 10,000 products): 2-4 hours

API Rate Limits

BigCommerce enforces rate limits. Synton automatically throttles requests to stay within limits. Large syncs may take longer on Standard/Plus plans.

Multi-Storefront Configuration

If using BigCommerce Multi-Storefront:

1. Your primary storefront syncs automatically
2. Additional storefronts appear in Settings > Storefronts
3. Configure each storefront:
   • Enable/Disable for Ads: Toggle ad campaign targeting
   • Inventory Threshold: Set per-storefront stock alerts
   • Catalog Mapping: Map to specific ad platform catalogs

Channel Configuration

For multi-channel stores:

1. In Synton, go to Settings > Channels
2. Each BigCommerce sales channel appears automatically:
   • Main store
   • Facebook
   • Instagram
   • Amazon
   • eBay
   • Custom channels
3. Configure per-channel settings as needed

Troubleshooting

"Invalid API credentials"

Solutions:

1. Verify Store Hash is correct:
   • Check API Path in BigCommerce
   • Extract hash correctly (between /stores/ and /v3/)
2. Confirm Access Token hasn't been regenerated
3. Check API account status in BigCommerce (should be Active)
4. If needed, regenerate API account and reconnect

"Insufficient permissions"

Cause: API account missing required OAuth scopes

Solution:

1. In BigCommerce, go to Settings > API > API Accounts
2. Find your Synton AI integration
3. Click Edit
4. Verify all required scopes are checked (see Step 2)
5. Save changes
6. In Synton, click Reconnect to refresh permissions

Products not syncing

Solutions:

1. Verify products are visible in BigCommerce
2. Check products aren't channel-restricted
3. In Synton, go to Settings > Integrations > BigCommerce
4. Click Sync Now to trigger manual sync
5. Check sync logs for specific errors

Inventory counts incorrect

Solutions:

1. Verify inventory tracking is enabled on products
2. For multi-location inventory:
   • Check which location Synton is reading from
   • Configure location priority in settings
3. Wait for next sync cycle (or trigger manual sync)
4. Clear sync cache: Settings > Data Management > Clear Cache

API rate limit errors

Symptoms: Sync pauses, error messages about rate limits

Information: BigCommerce rate limits by plan:

Plan	Rate Limit
Standard	150 requests/30 seconds
Plus	450 requests/30 seconds
Pro	1,500 requests/30 seconds
Enterprise	Custom (higher)

Solutions:

1. Synton automatically queues and retries requests
2. Large initial syncs may take longer on lower-tier plans
3. Consider upgrading BigCommerce plan for faster sync
4. No action needed - sync will complete automatically

Connection timeout

Solutions:

1. Check status.synton.ai for service status
2. Verify BigCommerce store is accessible (not in maintenance)
3. Test API manually: https://api.bigcommerce.com/stores/YOUR_HASH/v3/catalog/products
4. Contact support if issue persists

Webhook delivery failures

Solutions:

1. In BigCommerce, go to Settings > API > Webhooks
2. Click on a failed webhook
3. Check delivery logs for error details
4. Verify webhook URL is correct
5. Check webhook secret hasn't changed
6. Test connectivity to Synton API

BigCommerce App Compatibility

Compatible Apps

Works seamlessly with:

• ShipStation
• Avalara (tax automation)
• Mailchimp for BigCommerce
• Google Shopping by BigCommerce
• Facebook for BigCommerce
• Amazon by BigCommerce

Potential Conflicts

May conflict with:

• Other AI/automation apps (duplicate actions possible)
• Custom inventory management apps (verify sync direction)
• Third-party PIM systems (establish data source of truth)

B2B Edition Support

For BigCommerce B2B Edition:

• Customer groups sync automatically
• Price lists respect customer group pricing
• Quote requests visible in Synton
• Company accounts tracked for attribution
• Shared catalogs supported for targeted advertising

Uninstallation

To disconnect BigCommerce:

1. In Synton, go to Settings > Integrations
2. Find BigCommerce card
3. Click Disconnect
4. Confirm disconnection
5. Optionally, delete API account in BigCommerce:
   • Settings > API > API Accounts
   • Find Synton AI and click Delete

Data Retention

Synced data remains in Synton for reporting unless you request deletion. To delete all data, contact support@synton.ai within 30 days.

Next Steps

1. Open Your Dashboard at app.synton.ai
2. Complete Onboarding — Follow the guided setup in your dashboard
3. Explore AI Agents — Let Synton start analyzing and optimizing your store

Support

• Documentation: docs.synton.ai
• Email: support@synton.ai
• Dashboard: app.synton.ai