> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BigCommerce

> Integration details and setup guide for the BigCommerce connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                                                                                                                                                                                                                                                     |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentication**                  | OAuth 2.0 (Authorization Code with refresh tokens) or Bearer Token (API credentials)                                                                                                                                                                                        |
| **Two-Way Sync**                    | Yes                                                                                                                                                                                                                                                                         |
| **Events Supported**                | Yes (Webhooks)                                                                                                                                                                                                                                                              |
| **Realtime**                        | Yes                                                                                                                                                                                                                                                                         |
| **Supports Rate Limiting**          | Yes (20,000 requests per hour for standard plans)                                                                                                                                                                                                                           |
| **Authentication Scopes Supported** | Over 30 granular scopes including `store_v2_products` (products), `store_v2_orders` (orders), `store_v2_customers` (customers), `store_cart` (cart), `store_checkout` (checkout), `store_channel_listings` (channel listings), and many more. See full list in setup guide. |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **BigCommerce**:

* **Products**
* **Orders**
* **Customers**
* **Carts** (including abandoned carts)
* **Categories**
* **Brands**
* **Inventory**
* **Shipping**
* **Payment Methods**
* **Coupons** and **Gift Certificates**
* **Tax Classes**
* **Store Information**
* **Channels** (Multi-channel listings)
* **Webhooks**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                                           |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Offers free trial?**                             | Yes. BigCommerce offers a 15-day free trial with full access to features. Sign up at [https://www.bigcommerce.com](https://www.bigcommerce.com). |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can use your trial store for testing.                                                                              |
| **Requires partnership to obtain authentication?** | No. API credentials can be obtained directly from your BigCommerce store admin panel.                                                            |

***

### Authentication (OAuth 2.0 or Bearer Token)

#### Option 1: OAuth 2.0 (Recommended for user-facing integrations)

For customers who want to completely whitelabel their OAuth experience, you can provide your own developer keys instead of using Alloy Automation's.

1. Log in to the **BigCommerce Developer Portal** ([https://devtools.bigcommerce.com](https://devtools.bigcommerce.com)) and create a new app.
2. Configure your OAuth application:
   * Add the redirect URI: [https://api.runalloy.com/api/strategy/connector/bigCommerce/callback](https://api.runalloy.com/api/strategy/connector/bigCommerce/callback)
   * Select the scopes your integration requires (see Scopes section below)
3. Copy your **Client ID** and **Client Secret**.
4. Enter your **Client ID** and **Client Secret** into Alloy Automation.

#### Option 2: Bearer Token (Store-Level API Account)

1. Log in to your **BigCommerce store admin panel**.
2. Navigate to **Settings** → **API** → **API Accounts**.
3. Click **Create API Account**.
4. Select the OAuth scopes you need and give your API account a name.
5. Copy the **Access Token** (you won't be able to see it again).
6. Enter the Access Token into Alloy Automation as a Bearer token.

#### OAuth Authorization URL

The authorization URL for BigCommerce is: [https://login.bigcommerce.com/oauth2/authorize](https://login.bigcommerce.com/oauth2/authorize)

#### Scopes

BigCommerce uses granular scopes with read-only and read-write options:

* **Products:** `store_v2_products_read_only`, `store_v2_products`
* **Orders:** `store_v2_orders_read_only`, `store_v2_orders`
* **Customers:** `store_v2_customers_read_only`, `store_v2_customers`, `store_v2_customers_login`
* **Cart & Checkout:** `store_cart_read_only`, `store_cart`, `store_checkout_read_only`, `store_checkout`
* **Content:** `store_v2_content_read_only`, `store_v2_content`
* **Channels:** `store_channel_listings_read_only`, `store_channel_listings`
* **Marketing:** `store_v2_marketing_read_only`, `store_v2_marketing`
* **Payment:** `store_payments_methods_read`, `store_payments_access_token_create`
* And many more (see full list in BigCommerce API documentation)

#### API Documentation

For detailed API documentation, visit: [https://developer.bigcommerce.com/docs/rest](https://developer.bigcommerce.com/docs/rest)

***

## Use Cases

### 1) Product catalog synchronization

Sync product information, inventory levels, pricing, and variants between BigCommerce and your ERP, PIM, or warehouse management system, ensuring consistent product data across all sales channels.

### 2) Order management and fulfillment

Automatically pull orders from BigCommerce into your order management or fulfillment system, update order statuses, add tracking information, and synchronize shipping details in real-time.

### 3) Customer data integration

Synchronize customer profiles, order history, and contact information between BigCommerce and your CRM or marketing automation platform, enabling personalized marketing campaigns and customer service.

### 4) Abandoned cart recovery

Monitor abandoned carts via webhooks and trigger automated recovery workflows such as personalized email sequences, SMS reminders, or retargeting ads to recover lost sales.

### 5) Multi-channel commerce

Manage product listings, inventory, and orders across multiple sales channels (BigCommerce, Amazon, eBay, etc.) from a centralized system, ensuring consistent availability and preventing overselling.

***

## API Gotchas

* ⚠️ **Rate limiting:** BigCommerce enforces rate limits based on your plan (20,000 requests/hour for standard plans). Monitor the `X-Rate-Limit-Requests-Left` header and implement throttling.
* ⚠️ **Store hash required:** All API requests require your store's unique `store_hash` identifier in the URL. This is provided automatically during OAuth but must be configured manually when using store-level API tokens.
* ⚠️ **Webhook reliability:** BigCommerce webhooks may occasionally experience delays or duplicate deliveries. Implement idempotency keys and deduplication logic in your webhook handlers.
* ⚠️ **API version differences:** BigCommerce has V2 and V3 APIs with different structures. Ensure you're using the appropriate version for your integration needs.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.