Overview
BigCommerce is a hosted SaaS e-commerce platform aimed at mid-market. The Automize BigCommerce connector covers products, orders, customers, brands, categories, and coupons.
- Regions: BigCommerce is global, hosted. Stores have a custom domain or a {storehash}.mybigcommerce.com URL.
- Plans: Standard, Plus, Pro, Enterprise – all expose the API.
Setting up the connection
Auth type: API Key.
- Sign in to BigCommerce admin → Settings → API → API accounts → Create API account → Store API account.
- Set OAuth scopes (Products, Orders, Customers – read/write per your needs).
- Copy Access Token + Client ID + Store Hash.
- In Automize, open Settings → Connectors → BigCommerce → Add connection. Paste store hash + access token.
Find your credentials at https://login.bigcommerce.com/.
Rate limits
BigCommerce enforces 450 requests / 30 sec on most plans, higher on Enterprise. The connector reads X-Rate-Limit-Requests-Left headers and pauses.
Data model
Hierarchy:
Store ─┬─ Products ─── Variants ─── Options ── Option Values
├─ Categories ─── (hierarchical via parent_id)
├─ Brands
├─ Orders ─── Products (line items)
├─ Customers ─── Addresses
└─ Coupons (price rules)
Two API versions: v2 (legacy, some endpoints still here) + v3 (modern,
paginated). Connector mixes both per resource.Available operations
11 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Customer | General | Create a new customer |
| Create Product | General | Create a new product |
| Get Order | General | Get order by ID |
| Get Product | General | Get product by ID |
| List Brands | General | List all brands |
| List Categories | General | List product categories |
| List Coupons | General | List all coupons |
| List Customers | General | List all customers |
| List Orders | General | List all orders (v2) |
| List Products | General | List all products |
| Update Product | General | Update a product |
Operations
Create Customer
Create a new customer
| Parameter | Required | Type | Description |
|---|---|---|---|
Email email | Yes | text | |
First Name first_name | Yes | text | |
Last Name last_name | Yes | text |
Tips
- email + first_name + last_name. addresses[] for shipping/billing.
Create Product
Create a new product
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Type type | Yes | text | |
Weight weight | Yes | text | |
Price price | Yes | number |
Tips
- name + type (physical or digital) + weight + price required.
- For variants, send variants[] array after creation.
Get Order
Get order by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Order Id order_id | Yes | text |
Tips
- Returns order + products + shipping_addresses (separate endpoint).
Get Product
Get product by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Product Id product_id | Yes | text |
Tips
- Returns product. include=variants,images,custom_fields to expand nested.
List Brands
List all brands
No input parameters.
Tips
- v3 endpoint. Brands group products.
List Categories
List product categories
No input parameters.
Tips
- v3 endpoint. Tree structure via parent_id.
List Coupons
List all coupons
No input parameters.
Tips
- v2 endpoint. Coupons attached to one promotion at a time.
List Customers
List all customers
No input parameters.
Tips
- v3 endpoint. Filter by email:in, name:like.
List Orders
List all orders (v2)
No input parameters.
Tips
- v2 endpoint. Filter by status_id, min_date_created, customer_id.
- Pages via page parameter.
List Products
List all products
No input parameters.
Tips
- v3 endpoint – page via page + limit (max 250).
- Filter by name:like, sku, is_visible, categories, brand_id.
Update Product
Update a product
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Price price | Yes | number | |
Product Id product_id | Yes | text |
Tips
- PUT-style. Returns updated product.
FAQ
- v2 vs v3 – which?
- BigCommerce is migrating from v2 → v3. New endpoints (Products, Customers, Brands, Categories) use v3. Orders + Coupons are still v2. Connector hides this – pass the same args, it routes to the right version.
- Multi-storefront – supported?
- BigCommerce's multi-storefront feature ties multiple front-ends to one backend. The API is multi-channel aware – pass channel_id where supported. This connector currently targets the default channel.
- Why does Create Product fail with 'weight required'?
- BigCommerce strictly requires weight on physical products (for shipping calculations). For digital, pass type='digital' to skip.