# BigCommerce

Manage BigCommerce: products, orders, customers, carts, categories, webhooks. Exposes **43 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `bigcommerce_products_list` | List products - GET /catalog/products. |
| `bigcommerce_products_get` | Get one product - GET /catalog/products/{id}. |
| `bigcommerce_products_create` | Create a product - POST /catalog/products (JSON body). |
| `bigcommerce_products_update` | Update a product - PUT /catalog/products/{id} (JSON body, partial). |
| `bigcommerce_products_delete` | Delete a product - DELETE /catalog/products/{id}. |
| `bigcommerce_product_variants_list` | List product variants - GET /catalog/products/{product_id}/variants. |
| `bigcommerce_product_variants_get` | Get one product variant - GET /catalog/products/{product_id}/variants/{variant_id}. |
| `bigcommerce_product_variants_create` | Create a product variant - POST /catalog/products/{product_id}/variants (JSON body). |
| `bigcommerce_product_variants_update` | Update a product variant - PUT /catalog/products/{product_id}/variants/{variant_id} (JSON body, partial). |
| `bigcommerce_orders_list` | List orders - GET /orders. |
| `bigcommerce_orders_get` | Get one order - GET /orders/{id}. |
| `bigcommerce_orders_create` | Create an order - POST /orders (JSON body). |
| `bigcommerce_orders_update` | Update an order - PUT /orders/{id} (JSON body, partial). |
| `bigcommerce_orders_delete` | Delete an order - DELETE /orders/{id}. |
| `bigcommerce_order_items_list` | List order items (products in order) - GET /orders/{order_id}/products. |
| `bigcommerce_customers_list` | List customers - GET /customers. |
| `bigcommerce_customers_get` | Get one customer - GET /customers/{id}. |
| `bigcommerce_customers_create` | Create a customer - POST /customers (JSON body). |
| `bigcommerce_customers_update` | Update a customer - PUT /customers/{id} (JSON body, partial). |
| `bigcommerce_customers_delete` | Delete a customer - DELETE /customers/{id}. |
| `bigcommerce_categories_list` | List categories - GET /catalog/categories. |
| `bigcommerce_categories_get` | Get one category - GET /catalog/categories/{id}. |
| `bigcommerce_categories_create` | Create a category - POST /catalog/categories (JSON body). |
| `bigcommerce_categories_update` | Update a category - PUT /catalog/categories/{id} (JSON body, partial). |
| `bigcommerce_categories_delete` | Delete a category - DELETE /catalog/categories/{id}. |
| `bigcommerce_brands_list` | List brands - GET /catalog/brands. |
| `bigcommerce_brands_get` | Get one brand - GET /catalog/brands/{id}. |
| `bigcommerce_brands_create` | Create a brand - POST /catalog/brands (JSON body). |
| `bigcommerce_brands_update` | Update a brand - PUT /catalog/brands/{id} (JSON body, partial). |
| `bigcommerce_brands_delete` | Delete a brand - DELETE /catalog/brands/{id}. |
| `bigcommerce_carts_list` | List shopping carts - GET /carts. |
| `bigcommerce_carts_get` | Get one shopping cart - GET /carts/{id}. |
| `bigcommerce_carts_create` | Create a shopping cart - POST /carts (JSON body). |
| `bigcommerce_carts_delete` | Delete a shopping cart - DELETE /carts/{id}. |
| `bigcommerce_coupons_list` | List coupons - GET /coupons. |
| `bigcommerce_coupons_get` | Get one coupon - GET /coupons/{id}. |
| `bigcommerce_coupons_create` | Create a coupon - POST /coupons (JSON body). |
| `bigcommerce_coupons_update` | Update a coupon - PUT /coupons/{id} (JSON body, partial). |
| `bigcommerce_coupons_delete` | Delete a coupon - DELETE /coupons/{id}. |
| `bigcommerce_webhooks_list` | List webhooks - GET /hooks. |
| `bigcommerce_webhooks_create` | Create a webhook - POST /hooks (JSON body). |
| `bigcommerce_webhooks_delete` | Delete a webhook - DELETE /hooks/{id}. |
| `bigcommerce_store_info_get` | Get store configuration and metadata - GET /store. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`BIGCOMMERCE_STORE_HASH`** - From your API path store-{hash} (BigCommerce - Settings - API accounts).
- **`BIGCOMMERCE_ACCESS_TOKEN`** - BigCommerce - Settings - API - Store-level API accounts - Create. (https://support.bigcommerce.com/s/article/Store-API-Accounts)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `BIGCOMMERCE_STORE_HASH` | From your API path store-{hash} (BigCommerce - Settings - API accounts). |
| `BIGCOMMERCE_ACCESS_TOKEN` | BigCommerce - Settings - API - Store-level API accounts - Create. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [BigCommerce API documentation](https://developer.bigcommerce.com/docs/rest)