Products
Get Products
Retreives the products.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalpage
integerperPage
integerMust be at least 1. Must not be greater than 100.
orderColumn
string"id" | "name" | "price" | "products_sold"
orderDirection
string"asc" | "desc"
ids
array<integer>paths
array<string>name
stringvariant_name
stringvisibilities
array<string>group_ids
array<integer>group_null
booleanbadge_text
stringstatus_text
stringdeliverable
stringdeliverables_type
stringall
stringPath Parameters
shopId
RequiredintegerCreate Product
Creates a new product.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredname
Requiredstringpath
stringMust match the regex /^[a-z0-9-]+$/.
description
RequiredstringMust not be greater than 65535 characters.
meta_title
stringMust not be greater than 255 characters.
meta_description
stringMust not be greater than 65535 characters.
meta_image_id
stringmeta_twitter_card
string"summary" | "summary_large_image"
instructions
stringMust not be greater than 65535 characters.
out_of_stock_message
stringMust not be greater than 65535 characters.
currency
Requiredstringtax_inclusive
booleandeliverables
stringdeliverables_type
string"serials" | "service" | "dynamic"
serial_selection_method
string"last" | "first" | "random"
dynamic_url
stringMust not be greater than 2048 characters.
stock
numberMust be at least -1.
group_id
stringimage_ids
array<string>type
Requiredstring"single" | "variant"
visibility
Requiredstring"public" | "unlisted" | "private" | "on_hold"
payment_methods
objectprice
stringThis field is required when type is single.
price_slash
numberquantity_min
numberMust be at least 1. Must not be greater than 999999.
quantity_max
numberMust be at least 0. Must not be greater than 999999.
volume_discounts
array<string>Must not have more than 10 items.
discord_required
booleanblock_vpn
booleanhide_stock_count
booleanstatus_color
stringstatus_text
stringshow_views_count
booleanshow_sales_count
booleanshow_sales_notifications
booleansales_count_hours
numberfeedback_coupon_id
stringfeedback_coupon_min_rating
numberMust be at least 1. Must not be greater than 5.
deliverables_label
stringMust not be greater than 255 characters.
custom_field_ids
array<string>product_tabs
array<string>Must not have more than 10 items.
product_badges
array<string>Must not have more than 10 items.
product_upsells
Requiredarray<string>variants
array<string>This field is required when type is variant. Must have at least 1 items.
Path Parameters
shopId
RequiredintegerUpdate Product and Group Order
Updates the order of products and groups.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
RequiredsortedIds
Requiredarray<integer>Path Parameters
shopId
RequiredintegerGet Product
Retrieves a product.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringDelete Product
Deletes a product.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringUpdate Product
Updates a product.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredname
Requiredstringpath
stringMust match the regex /^[a-z0-9-]+$/.
description
RequiredstringMust not be greater than 65535 characters.
meta_title
stringMust not be greater than 255 characters.
meta_description
stringMust not be greater than 65535 characters.
meta_image_id
stringmeta_twitter_card
string"summary" | "summary_large_image"
instructions
stringMust not be greater than 65535 characters.
out_of_stock_message
stringMust not be greater than 65535 characters.
currency
Requiredstringtax_inclusive
booleanserial_selection_method
string"last" | "first" | "random"
dynamic_url
stringMust not be greater than 2048 characters.
stock
numberMust be at least -1.
group_id
stringimage_ids
array<string>type
Requiredstring"single" | "variant"
visibility
Requiredstring"public" | "unlisted" | "private" | "on_hold"
payment_methods
objectprice
stringThis field is required when type is single.
price_slash
numberquantity_min
numberMust be at least 1. Must not be greater than 999999.
quantity_max
numberMust be at least 0. Must not be greater than 999999.
volume_discounts
array<string>Must not have more than 10 items.
discord_required
booleanblock_vpn
booleanhide_stock_count
booleanstatus_color
stringstatus_text
stringshow_views_count
booleanshow_sales_count
booleanshow_sales_notifications
booleansales_count_hours
numberfeedback_coupon_id
stringfeedback_coupon_min_rating
numberMust be at least 1. Must not be greater than 5.
deliverables_label
stringMust not be greater than 255 characters.
custom_field_ids
array<string>product_tabs
array<string>Must not have more than 10 items.
product_badges
array<string>Must not have more than 10 items.
product_upsells
Requiredarray<string>variants
array<string>This field is required when type is variant. Must have at least 1 items.
Path Parameters
shopId
RequiredintegerproductId
RequiredstringClone Product
Clones a product.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringGet Deliverables
Retrieves the deliverables for a product or variant.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringvariantId
RequiredstringOptional parameter.
Append Deliverables
Appends deliverables to a product or variant.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringvariantId
RequiredstringOptional parameter.
Overwrite Deliverables
Overwrites deliverables for a product or variant.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopId
RequiredintegerproductId
RequiredstringvariantId
RequiredstringOptional parameter.
Bulk Update Custom Fields
Bulk updates custom fields for products.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectcustom_field_ids
array<string>Path Parameters
shopId
RequiredintegerBulk Update Discord Integration
Bulk updates Discord integration for products.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectdiscord_required
booleanPath Parameters
shopId
RequiredintegerBulk Update Description
Bulk updates product descriptions.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredproduct_ids
objecttype
Requiredstring"overwrite" | "append" | "prepend"
description
stringPath Parameters
shopId
RequiredintegerBulk Update Instructions
Bulk updates product instructions.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectinstructions
stringMust not be greater than 65535 characters.
Path Parameters
shopId
RequiredintegerBulk Update Out of Stock Message
Bulk updates product out of stock message.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectout_of_stock_message
stringMust not be greater than 65535 characters.
Path Parameters
shopId
RequiredintegerBulk Update Payment Methods
Bulk updates product payment methods.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectpayment_methods
objectPath Parameters
shopId
RequiredintegerBulk Update Security
Bulk updates product security settings.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectblock_vpn
booleanPath Parameters
shopId
RequiredintegerBulk Update Badges
Bulk updates product badges.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredproduct_ids
objecttype
Requiredstring"overwrite" | "append" | "prepend"
product_badges
array<string>Must not have more than 10 items.
Path Parameters
shopId
RequiredintegerBulk Update Status
Bulk updates product status.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectstatus_color
stringstatus_text
stringPath Parameters
shopId
RequiredintegerBulk Update Visibility
Bulk updates product visibility.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredproduct_ids
objectvisibility
Requiredstring"public" | "unlisted" | "private" | "on_hold"
Path Parameters
shopId
RequiredintegerBulk Update Live Stats
Bulk updates product live stats.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectshow_views_count
booleanshow_sales_count
booleanshow_sales_notifications
booleansales_count_hours
numberPath Parameters
shopId
RequiredintegerBulk Update Feedback Coupon
Bulk updates product feedback coupon.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectfeedback_coupon_id
stringfeedback_coupon_min_rating
numberMust be at least 1. Must not be greater than 5.
Path Parameters
shopId
RequiredintegerBulk Update Volume Discounts
Bulk updates product volume discounts.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectvolume_discounts
array<string>Path Parameters
shopId
RequiredintegerBulk Update Redirect URL
Bulk updates product redirect URL.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Optionalproduct_ids
objectredirect_url
stringMust start with one of https Must not be greater than 2048 characters.
Path Parameters
shopId
RequiredintegerBulk Update Deliverables Label
Bulk updates product deliverables label.
Authorization
Authorization
RequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/json
Requiredproduct_ids
objectdeliverables_label
RequiredstringMust not be greater than 255 characters.
Path Parameters
shopId
Requiredinteger