Skip to main content

BigCommerce Component

BigCommerce is a SaaS ecommerce platform. Use the Bigcommerce component to manage your Products, Brands, Categories and more.

Component key: bigcommerce

Description

BigCommerce is a leading SaaS eCommerce platform that allows businesses to build, innovate, and grow their online stores. This component allows you to manage products, brands, categories, and other essential e-commerce features in a BigCommerce store.

Connections

BigCommerce OAuth 2.0

  1. To create an OAuth 2.0 app in BigCommerce, sign up for a BigCommerce developer account at https://developer.bigcommerce.com/ and create a new BigCommerce application.
  2. Take note of your application's Client ID and Secret and enter those values in Prismatic when you add a BigCommerce connection to your integration.
  3. Under Redirect URI, add Prismatic's callback URL, https://oauth2.prismatic.io/callback.
InputDefaultNotes
Authorize URL
string
/ Required
Hidden Field
authorizeUrl
https://login.bigcommerce.com/oauth2/authorize
The OAuth 2.0 Authorization URL for BigCommerce
Base URL
string
/ Required
Hidden Field
baseUrl
https://api.bigcommerce.com
The base URL for BigCommerce's API
Client ID
string
/ Required
clientId
 
Client Secret
password
/ Required
clientSecret
 
Scopes
string
/ Required
scopes
store_v2_default
A space-delimited set of one or more scopes to get the user's permission to access.
Token URL
string
/ Required
Hidden Field
tokenUrl
https://login.bigcommerce.com/oauth2/token
The OAuth 2.0 Token URL for BigCommerce

Triggers

Webhook

Receive and validate webhook requests from BigCommerce for webhooks you configure. | key: myTrigger


Data Sources

Select Brands

Select a brand from a specific store. | key: selectBrands | type: picklist

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Select Categories

Select a category from a specific store. | key: selectCategories | type: picklist

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Select Product Modifiers

Select a modifier from a specific product. | key: selectProductModifiers | type: picklist

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Product ID
string
/ Required
product_id
The ID of the Product to which the modifiers belong.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Select Product Variants

Select a variant from a specific product. | key: selectProductVariants | type: picklist

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Exclude Fields
text
exclude_fields
Fields to exclude, in a comma-separated list.
Include Fields
text
include_fields
Fields to include, in a comma-separated list.
Limit
text
limit
Controls the number of items per page in a limited (paginated) list of products.
Page Number
text
page
Specifies the page number in a limited (paginated) list of products.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Select Products

Select a product from a specific store. | key: selectProducts | type: picklist

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Actions

Create a Category Image

Upload an image for a specific category. | key: createCategoryImage

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category ID
string
/ Required
categoryId
The ID of the category to retrieve.
Image File
data
/ Required
imageFile
The image file to be uploaded.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create a Category Tree

Creates a new category tree in BigCommerce. | key: createCategoryTree

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category Name
string
/ Required
categoryNameTree
The name displayed for the category.
Parent ID
string
/ Required
parent_id_Tree
Set to 0 for top level category. Otherwise, set to the ID of the parent category.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create a Product Modifier

Creates a Product Modifier. | key: createProductModifierAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Configuration
code
config
The configuration values for the modifier.
Display Name
text
/ Required
display_name
The name of the option shown on the storefront.
Option Values
code
option_values
The option values for the modifier.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Required
boolean
/ Required
required
false
Whether or not this modifier is required at checkout.
Sort Order
text
sort_order
The order the modifiers display on the product detail page.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Modifier Type
text
/ Required
type
The type of the modifier. Acceptable values: date, checkbox, etc.

Create a Product Variant

Creates a new product variant in BigCommerce. | key: createProductVariantAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Variant Depth
text
/ Required
depth
Depth of the variant.
Variant Height
text
/ Required
height
Height of the variant.
Option Values
code
/ Required
option_values
Array of option and option values IDs that make up this variant.
Variant Price
text
/ Required
price
This variants base price on the storefront.
Product ID
string
/ Required
product_id
The ID of the Product to which the resource belongs.
Variant SKU
text
/ Required
sku
SKU for the variant. Must be between 1 and 255 characters.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Variant Weight
text
/ Required
weight
This variants base weight on the storefront.
Variant Width
text
/ Required
width
Width of the variant.

Create a Variant Image

Creates or updates an image for a specific product variant. | key: createVariantImageAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Image URL
string
image_url
 
Product ID
string
/ Required
product_id
The ID of the Product to which the resource belongs.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Variant ID
text
/ Required
variant_id
ID of the variant on a product, or on an associated Price List Record.

Create a Webhook

Creates a new webhook in BigCommerce. | key: createWebhookAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Destination
string
destination
 
Events History Enabled (Deprecated)
boolean
events_history_enabled
 
Headers
code
headers
 
Is Active
boolean
is_active
false
 
Scope
string
scope
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create Brand

Create a new brand in the store. | key: createBrand

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand Name
string
/ Required
brandNameToCreate
The unique name for the new Brand to be created.
Image URL
string
imageUrl
 
Meta Description
string
metaDescription
 
Meta Keywords
string
metaKeywords
Comma-separated list of meta keywords.
Page Title
string
pageTitle
 
Search Keywords
string
searchKeywords
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create Brand Image

Upload an image for a brand. | key: createBrandImage

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID
string
brandId
Filter brands by ID.
Image File
data
/ Required
imageFile
The image file to be uploaded.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create Category

Creates a new category in BigCommerce. | key: createCategory

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Category Description
text
categoryDescription
Description for the category, can include HTML.
Category Name
string
/ Required
categoryName
Name of the category. It should be unique among its siblings.
Custom URL
text
customUrl
Custom URL for the category on the storefront.
Default Product Sort
string
defaultProductSort
Determines how products are sorted on category page load.
Image URL
string
imageUrl
 
Is Visible
boolean
isVisible
false
Flag to determine if the category is visible on the storefront.
Layout File
string
layoutFile
Layout file for the category. Relevant for Blueprint themes.
Meta Description
string
metaDescription
 
Meta Keywords
string
metaKeywords
Comma-separated list of meta keywords.
Page Title
string
pageTitle
 
Parent ID
string
/ Required
parentId
ID of the parent category. Set to 0 for top-level category.
Search Keywords
string
searchKeywords
 
Sort Order
string
sortOrder
Priority of this category in the menu and category pages.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Views
string
views
Number of views the category has on the storefront.

Create Custom Field

Creates a custom field for a product. | key: createCustomField

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Custom Field Name
string
/ Required
customFieldName
The name of the custom field.
Custom Field Value
string
/ Required
customFieldValue
The value of the custom field.
Product ID
string
/ Required
productCustomFieldsProductId
The ID of the Product to retrieve custom fields for.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Create Modifier Image

Creates an image for a product modifier value. | key: createModifierImageAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Modifier Image File
data
/ Required
image_file
The image file to upload for the modifier.
Modifier ID
string
/ Required
modifier_id
The ID of the Modifier.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Modifier Value ID
text
/ Required
value_id
The ID of the Modifier Value.

Create Product

Creates a new product in the store. | key: createProduct

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Cost Price
text
uniqueCostPrice
The cost price of the product. Stored for reference only.
Product Depth
text
uniqueProductDepth
Depth of the product, which can be used when calculating shipping costs.
Product Description
text
uniqueProductDescription
The product description, which can include HTML formatting.
Product Height
text
uniqueProductHeight
Height of the product, which can be used when calculating shipping costs.
Product Name
text
/ Required
uniqueProductName
A unique product name. Length between 1 to 250 characters.
Product Price
text
/ Required
uniqueProductPrice
The price of the product. The price should include or exclude tax, based on the store settings.
Product SKU
text
uniqueProductSku
A unique user-defined alphanumeric product code/stock keeping unit (SKU). Length between 0 to 255 characters.
Product Type
text
/ Required
uniqueProductType
The product type. Either 'physical' or 'digital'.
Product Weight
text
/ Required
uniqueProductWeight
Weight of the product. This is based on the unit set on the store.
Product Width
text
uniqueProductWidth
Width of the product, which can be used when calculating shipping costs.
Retail Price
text
uniqueRetailPrice
The retail cost of the product. If entered, the retail cost price will be shown on the product page.
Sale Price
text
uniqueSalePrice
If entered, the sale price will be used instead of value in the price field when calculating the product's cost.

Create Product Image

Creates a Product Image. | key: createProductImageAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Image File
string
/ Required
image_file
The local path to the original image file uploaded to BigCommerce. A multipart/form-data media type.
Image URL
string
image_url
The fully qualified URL path of the image. Limit of 8MB per file.
Product ID
string
/ Required
product_id
The unique numeric identifier for the product with which the image is associated.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete a Category Image

Deletes an image associated with a given category. | key: deleteCategoryImage

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category ID
string
/ Required
categoryId
The ID of the category to retrieve.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete a Custom Field

Deletes a product custom field. | key: deleteCustomField

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Custom Field ID to Delete
string
/ Required
customFieldIdToDelete
The ID of the custom field to delete.
Product ID
string
/ Required
productCustomFieldsProductId
The ID of the Product to retrieve custom fields for.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete a Modifier

Deletes a Product Modifier. | key: deleteProductModifierAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Modifier ID
string
/ Required
modifier_id
The ID of the Modifier.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete a Product

Deletes a Product. | key: deleteProduct

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Product ID to Delete
text
/ Required
productIdToDelete
The ID of the Product to delete.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete a Product Variant

Deletes a specific product Variant. | key: deleteProductVariantAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Product ID
string
/ Required
product_id
The ID of the Product to which the resource belongs.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Variant ID
text
/ Required
variant_id
ID of the variant on a product, or on an associated Price List Record.

Delete a Webhook

Deletes a specific webhook from BigCommerce. | key: deleteWebhookAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Webhook ID
string
/ Required
webhook_id
 

Delete Brand

Delete a brand by ID. | key: deleteBrand

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID to Delete
string
/ Required
brandIdToDelete
The ID of the brand to delete.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete Brand Image

Delete an image for a brand by ID. | key: deleteBrandImage

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID
string
brandId
Filter brands by ID.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete Categories

Deletes categories based on provided filters. | key: deleteCategories

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
ID
string
id
Filter items by ID.
ID Greater Than
string
id_greater
Filter items by ID values greater than the specified value.
ID In
string
id_in
Filter items by multiple IDs.
ID Less Than
string
id_less
Filter items by ID values less than the specified value.
ID Max
string
id_max
Filter items by maximum ID value.
ID Min
string
id_min
Filter items by minimum ID value.
ID Not In
string
id_not_in
Exclude items by multiple IDs.
Is Visible
boolean
isVisible
false
Flag to determine if the category is visible on the storefront.
Keyword
string
keyword
Filter items by keywords.
Name
string
name
Filter items by name.
Name Contains
string
name_like
Filter items by names that contain the specified string.
Page Title
string
pageTitle
 
Page Title Like
string
pageTitle_like
Filter categories by page titles that contain this substring.
Parent ID Greater Than
string
parent_id_greater
Filter items by Parent ID values greater than the specified value.
Parent ID In
string
parent_id_in
Filter items by multiple parent IDs.
Parent ID Less Than
string
parent_id_less
Filter items by Parent ID values less than the specified value.
Parent ID Max
string
parent_id_max
Filter items by maximum Parent ID value.
Parent ID Min
string
parent_id_min
Filter items by minimum Parent ID value.
Parent ID
string
/ Required
parentId
ID of the parent category. Set to 0 for top-level category.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete Categories

Deletes specified categories in BigCommerce. | key: deleteCategoriesTree

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category ID
string
/ Required
category_id
Identifier for the category. Use this to specify a specific category using its ID.
Category UUID
string
category_uuid
Unique identifier for the category. Use this to specify a specific category using its UUID.
Parent ID
string
parent_id
Filter items by parent ID.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Tree ID
string
/ Required
tree_id
ID of the category tree.

Delete Category Trees

Deletes specific Category Trees. | key: deleteCategoryTrees

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
ID In
string
category_id_in
Filter by specific IDs.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete Instanced Webhooks

Deletes all webhooks that point to a flow in this instance. | key: deleteInstancedWebhooksAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Destination
string
destination
 
Instance URL Pattern
string
/ Required
instanceURLPattern
 
Is Active
boolean
is_active
false
 
Items Per Page
string
limit
 
Page Number
string
page
 
Scope
string
scope
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Delete Product Image

Deletes a Product Image. | key: deleteProductImageAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Image ID to Delete
string
/ Required
image_id
The ID of the Image that is being operated on.
Product ID
string
/ Required
product_id
The ID of the Product to which the image is associated.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get a Category

Returns a single Category. | key: getCategory

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category ID
string
/ Required
categoryId
The ID of the category to retrieve.
Exclude Fields
string
excludeFields
Fields to exclude, in a comma-separated list. The ID cannot be excluded.
Include Fields
string
includeFields
Fields to include, in a comma-separated list. The ID and the specified fields will be returned.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get a Category Tree

Returns a Category Tree. | key: getCategoryTree

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Depth
string
depth
Max depth for a tree of categories.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Tree ID
string
/ Required
tree_id
ID of the category tree.

Get a Modifier

Returns a single Product Modifier. | key: getModifierAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Exclude Fields
string
exclude_fields
Fields to exclude, in a comma-separated list. The ID cannot be excluded.
Include Fields
string
include_fields
Fields to include, in a comma-separated list.
Modifier ID
string
/ Required
modifier_id
The ID of the Modifier.
Product ID
string
/ Required
product_id
The ID of the Product to which the modifier belongs.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get a Product Variant

Returns a specific product Variant. | key: getProductVariantAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Exclude Fields
text
exclude_fields
Fields to exclude, in a comma-separated list.
Include Fields
text
include_fields
Fields to include, in a comma-separated list.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Variant ID
text
/ Required
variant_id
ID of the variant on a product, or on an associated Price List Record.

Get All Product Variants

Returns a list of product Variants. | key: getAllProductVariantsAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Exclude Fields
text
exclude_fields
Fields to exclude, in a comma-separated list.
Include Fields
text
include_fields
Fields to include, in a comma-separated list.
Limit
text
limit
Controls the number of items per page in a limited (paginated) list of products.
Page Number
text
page
Specifies the page number in a limited (paginated) list of products.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get Brand

Retrieve details of a specific brand. | key: getBrand

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID
string
brandId
Filter brands by ID.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get Catalog Summary

Returns a lightweight inventory summary from the BigCommerce Catalog. | key: getCatalogSummaryAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get Product Custom Fields

Returns a list of product custom fields. | key: getProductCustomFields

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Limit
string
limit
Controls the number of items per page.
Page
string
page
Specifies the page number in a limited list of products.
Product ID
string
/ Required
productCustomFieldsProductId
The ID of the Product to retrieve custom fields for.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get Product Image

Returns a single Product Image. | key: getProductImage

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Image ID
string
/ Required
productImageImageId
ID of the image to retrieve.
Product ID for Image
string
/ Required
productImageProductId
ID of the product for which to retrieve an image.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Get Webhooks

Returns a list of all webhooks on a store. | key: getWebhooksAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Destination
string
destination
 
Is Active
boolean
is_active
false
 
Items Per Page
string
limit
 
Page Number
string
page
 
Scope
string
scope
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Brands

List all of the store's brands. | key: listBrands

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand Name
string
brandName
Filter brands by name.
Limit
string
pageLimit
Controls the number of items per page in a limited (paginated) list of products.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Categories

Retrieve a list of categories with optional filters. | key: getAllCategories

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Exclude Fields
string
exclude_fields
Fields to exclude, in a comma-separated list.
ID
string
id
Filter items by ID.
ID Greater Than
string
id_greater
Filter items by ID values greater than the specified value.
ID In
string
id_in
Filter items by multiple IDs.
ID Less Than
string
id_less
Filter items by ID values less than the specified value.
ID Max
string
id_max
Filter items by maximum ID value.
ID Min
string
id_min
Filter items by minimum ID value.
ID Not In
string
id_not_in
Exclude items by multiple IDs.
Include Fields
string
include_fields
Fields to include, in a comma-separated list.
Is Visible
boolean
is_visible
false
Filter items by if visible on the storefront.
Keyword
string
keyword
Filter items by keywords.
Limit
string
limit
Controls the number of items per page.
Name
string
name
Filter items by name.
Name Contains
string
name_like
Filter items by names that contain the specified string.
Page
string
page
Specifies the page number in a limited list of products.
Page Title
string
page_title
Filter items by page title.
Page Title Contains
string
page_title_like
Filter items by page titles that contain the specified string.
Parent ID
string
parent_id
Filter items by parent ID.
Parent ID Greater Than
string
parent_id_greater
Filter items by Parent ID values greater than the specified value.
Parent ID In
string
parent_id_in
Filter items by multiple parent IDs.
Parent ID Less Than
string
parent_id_less
Filter items by Parent ID values less than the specified value.
Parent ID Max
string
parent_id_max
Filter items by maximum Parent ID value.
Parent ID Min
string
parent_id_min
Filter items by minimum Parent ID value.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Categories (Simplified)

Returns a list of categories. | key: getAllCategoriesSimple

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
ID In
string
category_id_in
Filter by specific IDs.
Limit
string
limit
Controls the number of items per page.
Page
string
page
Specifies the page number in a limited list of products.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Category Trees

Returns a list of Category Trees. | key: getAllCategoryTrees

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
ID In
string
category_id_in
Filter by specific IDs.
Channel ID In
string
channelId_in
Filter by Channel IDs.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Product Images

Returns a list of product images with optional filter parameters. | key: getAllProductImages

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Product ID for Images
string
/ Required
productImagesProductId
ID of the product for which to retrieve images.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Product Modifiers

Returns a list of all Product Modifiers. | key: getAllProductModifiersAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Exclude Fields
string
exclude_fields
Fields to exclude, in a comma-separated list. The ID cannot be excluded.
Include Fields
string
include_fields
Fields to include, in a comma-separated list.
Limit
string
limit
Controls the number of items per page in a limited (paginated) list of products.
Page
string
page
Specifies the page number in a limited (paginated) list of products.
Product ID
string
/ Required
product_id
The ID of the Product to which the modifiers belong.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

List Products

Returns a list of products with optional filter parameters. | key: getAllProducts

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID
string
productBrandId
Filter items by brand ID.
Product ID
string
productId
Filter items by product ID.
Limit
string
productLimit
Controls the number of items per page in a limited (paginated) list of products.
Product Name
string
productName
Filter items by product name.
Page
string
productPage
Specifies the page number in a limited (paginated) list of products.
Product Price
string
productPrice
Filter items by product price.
Product Type
string
productType
Filter items by product type.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Raw Request

Send raw HTTP request to BigCommerce | key: rawRequest

InputDefaultNotesExample
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
 
Data
string
data
The HTTP body payload to send to the URL.
{"exampleKey": "Example Data"}
Debug Request
boolean
debugRequest
false
Enabling this flag will log out the current request.
 
File Data
string
Key Value List
fileData
File Data to be sent as a multipart form upload.
[{key: "example.txt", value: "My File Contents"}]
File Data File Names
string
Key Value List
fileDataFileNames
File names to apply to the file data inputs. Keys must match the file data keys above.
 
Form Data
string
Key Value List
formData
The Form Data to be sent as a multipart form upload.
[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header
string
Key Value List
headers
A list of headers to send with the request.
User-Agent: curl/7.64.1
Max Retry Count
string
maxRetries
0
The maximum number of retries to attempt.
 
Method
string
/ Required
method
The HTTP method to use.
 
Query Parameter
string
Key Value List
queryParams
A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
 
Response Type
string
/ Required
responseType
json
The type of data you expect in the response. You can request json, text, or binary data.
 
Retry On All Errors
boolean
retryAllErrors
false
If true, retries on all erroneous responses regardless of type.
 
Retry Delay (ms)
string
retryDelayMS
0
The delay in milliseconds between retries.
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
 
Timeout
string
timeout
The maximum time that a client will await a response to its request
2000
URL
string
/ Required
url
This is the URL to call.
/v3/catalog/brands
Use Exponential Backoff
boolean
useExponentialBackoff
false
Specifies whether to use a pre-defined exponential backoff strategy for retries.
 

Update a Modifier

Updates a Product Modifier. | key: updateProductModifierAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Configuration
code
config
The configuration values for the modifier.
Display Name
text
/ Required
display_name
The name of the option shown on the storefront.
Modifier ID
string
/ Required
modifier_id
The ID of the Modifier.
Option Values
code
option_values
The option values for the modifier.
Product ID
text
/ Required
product_id
The ID of the Product to which the modifier will be added.
Required
boolean
/ Required
required
false
Whether or not this modifier is required at checkout.
Sort Order
text
sort_order
The order the modifiers display on the product detail page.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Modifier Type
text
/ Required
type
The type of the modifier. Acceptable values: date, checkbox, etc.

Update a Product

Updates a product in the catalog. | key: updateProduct

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Product ID
string
productId
Filter items by product ID.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Cost Price
text
uniqueCostPrice
The cost price of the product. Stored for reference only.
Product Depth
text
uniqueProductDepth
Depth of the product, which can be used when calculating shipping costs.
Product Height
text
uniqueProductHeight
Height of the product, which can be used when calculating shipping costs.
Product Name
text
/ Required
uniqueProductName
A unique product name. Length between 1 to 250 characters.
Product Price
text
/ Required
uniqueProductPrice
The price of the product. The price should include or exclude tax, based on the store settings.
Product Type
text
/ Required
uniqueProductType
The product type. Either 'physical' or 'digital'.
Product Weight
text
/ Required
uniqueProductWeight
Weight of the product. This is based on the unit set on the store.
Product Width
text
uniqueProductWidth
Width of the product, which can be used when calculating shipping costs.
Retail Price
text
uniqueRetailPrice
The retail cost of the product. If entered, the retail cost price will be shown on the product page.
Sale Price
text
uniqueSalePrice
If entered, the sale price will be used instead of value in the price field when calculating the product's cost.

Update a Product Variant

Updates a specific product Variant. | key: updateProductVariantAction

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Variant Depth
text
/ Required
depth
Depth of the variant.
Variant Height
text
/ Required
height
Height of the variant.
Option Values
code
/ Required
option_values
Array of option and option values IDs that make up this variant.
Variant Price
text
/ Required
price
This variants base price on the storefront.
Product ID
string
/ Required
product_id
The ID of the Product to which the resource belongs.
Variant SKU
text
/ Required
sku
SKU for the variant. Must be between 1 and 255 characters.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Variant ID
text
/ Required
variant_id
ID of the variant on a product, or on an associated Price List Record.
Variant Weight
text
/ Required
weight
This variants base weight on the storefront.
Variant Width
text
/ Required
width
Width of the variant.

Update a Webhook

Updates an existing webhook in BigCommerce. | key: updateWebhookAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Destination
string
destination
 
Headers
code
headers
 
Is Active
boolean
is_active
false
 
Scope
string
scope
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Webhook ID
string
/ Required
webhook_id
 

Update Brand

Update a brand's details. | key: updateBrand

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Brand ID to Update
string
/ Required
brandIdToUpdate
The ID of the brand to update.
New Brand Name
string
/ Required
newBrandName
The updated name for the brand.
New Image URL
string
newImageUrl
The updated image URL for the brand.
New Page Title
string
newPageTitle
The updated title shown in the browser while viewing the brand.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Update Categories

Updates existing categories in BigCommerce. | key: updateCategories

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Category ID
string
/ Required
category_id_update
Unique ID of the category to update.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Tree ID
string
/ Required
tree_id_update
Unique ID of the tree.

Update Category

Updates an existing category in BigCommerce. | key: updateCategory

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Category Description
text
categoryDescription
Description for the category, can include HTML.
Category ID
string
/ Required
categoryId
The ID of the category to retrieve.
Category Name
string
/ Required
categoryName
Name of the category. It should be unique among its siblings.
Custom URL
text
customUrl
Custom URL for the category on the storefront.
Default Product Sort
string
defaultProductSort
Determines how products are sorted on category page load.
Image URL
string
imageUrl
 
Is Visible
boolean
isVisible
false
Flag to determine if the category is visible on the storefront.
Layout File
string
layoutFile
Layout file for the category. Relevant for Blueprint themes.
Meta Description
string
metaDescription
 
Meta Keywords
string
metaKeywords
Comma-separated list of meta keywords.
Page Title
string
pageTitle
 
Parent ID
string
/ Required
parentId
ID of the parent category. Set to 0 for top-level category.
Search Keywords
string
searchKeywords
 
Sort Order
string
sortOrder
Priority of this category in the menu and category pages.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Views
string
views
Number of views the category has on the storefront.

Update Custom Field

Updates a custom field for a product. | key: updateCustomField

InputNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
Custom Field ID to Update
string
/ Required
customFieldIdToUpdate
The ID of the custom field to update.
Custom Field Name
string
/ Required
customFieldName
The name of the custom field.
Custom Field Value
string
/ Required
customFieldValue
The value of the custom field.
Product ID
string
/ Required
productCustomFieldsProductId
The ID of the Product to retrieve custom fields for.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.

Update Product Image

Updates a Product Image. | key: updateProductImageAction

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Image Description
string
description
The description for the image.
Image File
string
image_file
The local path to the original image file uploaded to BigCommerce.
Image ID to Update
string
/ Required
image_id
The ID of the Image that is being operated on.
Image URL
string
image_url
Must be a fully qualified URL path, including protocol.
Is Thumbnail
boolean
is_thumbnail
false
Flag for identifying whether the image is used as the product's thumbnail.
Product ID for Image
string
/ Required
product_id
The ID of the Product for which the image is associated.
Sort Order
string
sort_order
The order in which the image will be displayed on the product page.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Standard Image URL
string
url_standard
The standard URL for this image.
Thumbnail Image URL
string
url_thumbnail
The thumbnail URL for this image.
Tiny Image URL
string
url_tiny
The tiny URL for this image.
Zoom Image URL
string
url_zoom
The zoom URL for this image.

Update Products (Batch)

Updates products in batches. | key: updateProductsBatch

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.
Products (Batch)
code
/ Required
uniqueProductBatch
Array of products to update in batches.

Upsert Category Trees

Upserts Category Trees. This single endpoint updates and creates category trees. | key: upsertCategoryTrees

InputDefaultNotes
BigCommerce Connection
connection
/ Required
bigCommerceConnection
 
 
Category Tree Data
code
/ Required
categoryTreeData
Data to upsert for category trees. Should be a JSON array containing tree objects.
Store Hash
string
/ Required
storeHash
The unique identifier for the BigCommerce store.