Products
Get Products
Retreives the products.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalpageintegerperPageintegerMust be at least 1. Must not be greater than 100.
orderColumnstring"id" | "name" | "price" | "products_sold"orderDirectionstring"asc" | "desc"typestring"variant" | "addon"idsarray<integer>pathsarray<string>namestringvariant_namestringvisibilitiesarray<string>group_idsarray<integer>group_nullbooleanbadge_textstringstatus_textstringdeliverablestringdeliverables_typestringallstringPath Parameters
shopIdRequiredintegerCreate Product
Creates a new product.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredtypestring"variant" | "addon"nameRequiredstringpathstringMust match the regex /^[a-z0-9-]+$/.
descriptionstringMust not be greater than 65535 characters.
meta_titlestringMust not be greater than 255 characters.
meta_descriptionstringMust not be greater than 65535 characters.
meta_image_idstringThe id of an existing record in the images table.
meta_twitter_cardstring"summary" | "summary_large_image"instructionsstringMust not be greater than 65535 characters.
out_of_stock_messagestringMust not be greater than 65535 characters.
currencyRequiredstringtax_inclusivebooleandeliverables_typestring"serials" | "service" | "dynamic"group_idstringThe id of an existing record in the groups table.
image_idsarray<string>The id of an existing record in the images table.
visibilityRequiredstring"public" | "unlisted" | "private" | "on_hold"volume_discountsarray<object>Must not have more than 10 items.
disable_volume_discounts_if_couponbooleandiscord_requiredbooleanblock_vpnbooleanhide_stock_countbooleanstatus_colorstringstatus_textstringshow_views_countbooleanshow_sales_countbooleanshow_sales_notificationsbooleansales_count_hoursnumberfeedback_coupon_idstringThe id of an existing record in the coupons table.
feedback_coupon_min_ratingnumberMust be at least 1. Must not be greater than 5.
deliverables_labelstringMust not be greater than 255 characters.
custom_field_idsarray<string>The id of an existing record in the custom_fields table.
product_tabsarray<object>Must not have more than 10 items.
product_badgesarray<object>Must not have more than 10 items.
product_addonsRequiredarray<string>product_upsellsRequiredarray<string>variantsarray<object>This field is required when type is variant. Must have at least 1 items.
Path Parameters
shopIdRequiredintegerUpdate Product and Group Order
Updates the order of products and groups.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredsortedIdsRequiredarray<object>Path Parameters
shopIdRequiredintegerGet Product
Retrieves a product.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringDelete Product
Deletes a product.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringUpdate Product
Updates a product.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredtypestring"variant" | "addon"nameRequiredstringpathstringMust match the regex /^[a-z0-9-]+$/.
descriptionstringMust not be greater than 65535 characters.
meta_titlestringMust not be greater than 255 characters.
meta_descriptionstringMust not be greater than 65535 characters.
meta_image_idstringThe id of an existing record in the images table.
meta_twitter_cardstring"summary" | "summary_large_image"instructionsstringMust not be greater than 65535 characters.
out_of_stock_messagestringMust not be greater than 65535 characters.
currencyRequiredstringtax_inclusivebooleandeliverables_typestring"serials" | "service" | "dynamic"group_idstringThe id of an existing record in the groups table.
image_idsarray<string>The id of an existing record in the images table.
visibilityRequiredstring"public" | "unlisted" | "private" | "on_hold"volume_discountsarray<object>Must not have more than 10 items.
disable_volume_discounts_if_couponbooleandiscord_requiredbooleanblock_vpnbooleanhide_stock_countbooleanstatus_colorstringstatus_textstringshow_views_countbooleanshow_sales_countbooleanshow_sales_notificationsbooleansales_count_hoursnumberfeedback_coupon_idstringThe id of an existing record in the coupons table.
feedback_coupon_min_ratingnumberMust be at least 1. Must not be greater than 5.
deliverables_labelstringMust not be greater than 255 characters.
custom_field_idsarray<string>The id of an existing record in the custom_fields table.
product_tabsarray<object>Must not have more than 10 items.
product_badgesarray<object>Must not have more than 10 items.
product_addonsRequiredarray<string>product_upsellsRequiredarray<string>variantsarray<object>This field is required when type is variant. Must have at least 1 items.
Path Parameters
shopIdRequiredintegerproductIdRequiredstringClone Product
Clones a product.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringUpdate Stock
Updates the stock count of a service or dynamic product variant.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringvariantIdRequiredstringGet Deliverables
Retrieves the deliverables for a product or variant.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringvariantIdRequiredstringOptional parameter.
Append Deliverables
Appends deliverables to a product or variant.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringvariantIdRequiredstringOptional parameter.
Overwrite Deliverables
Overwrites deliverables for a product or variant.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Path Parameters
shopIdRequiredintegerproductIdRequiredstringvariantIdRequiredstringOptional parameter.
Bulk Update Disabled Payment Methods
Bulk updates disabled payment methods for products.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectdisabled_payment_method_idsarray<string>The id of an existing record in the payment_methods table.
Path Parameters
shopIdRequiredintegerBulk Update Custom Fields
Bulk updates custom fields for products.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectcustom_field_idsarray<string>The id of an existing record in the custom_fields table.
Path Parameters
shopIdRequiredintegerBulk Update Discord Integration
Bulk updates Discord integration for products.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectdiscord_requiredbooleandiscord_rolesarray<object>Must not have more than 10 items.
Path Parameters
shopIdRequiredintegerBulk Update Description
Bulk updates product descriptions.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredproduct_idsobjecttypeRequiredstring"overwrite" | "append" | "prepend"descriptionstringPath Parameters
shopIdRequiredintegerBulk Update Instructions
Bulk updates product instructions.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectinstructionsstringMust not be greater than 65535 characters.
Path Parameters
shopIdRequiredintegerBulk Update Out of Stock Message
Bulk updates product out of stock message.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectout_of_stock_messagestringMust not be greater than 65535 characters.
Path Parameters
shopIdRequiredintegerBulk Update Security
Bulk updates product security settings.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectblock_vpnbooleanPath Parameters
shopIdRequiredintegerBulk Update Badges
Bulk updates product badges.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredproduct_idsobjecttypeRequiredstring"overwrite" | "append" | "prepend"product_badgesarray<object>Must not have more than 10 items.
Path Parameters
shopIdRequiredintegerBulk Update Status
Bulk updates product status.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectstatus_colorstringstatus_textstringPath Parameters
shopIdRequiredintegerBulk Update Visibility
Bulk updates product visibility.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredproduct_idsobjectvisibilityRequiredstring"public" | "unlisted" | "private" | "on_hold"Path Parameters
shopIdRequiredintegerBulk Update Live Stats
Bulk updates product live stats.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectshow_views_countbooleanshow_sales_countbooleanshow_sales_notificationsbooleansales_count_hoursnumberPath Parameters
shopIdRequiredintegerBulk Update Feedback Coupon
Bulk updates product feedback coupon.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectfeedback_coupon_idstringThe id of an existing record in the coupons table.
feedback_coupon_min_ratingnumberMust be at least 1. Must not be greater than 5.
Path Parameters
shopIdRequiredintegerBulk Update Volume Discounts
Bulk updates product volume discounts.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectvolume_discountsarray<object>disable_volume_discounts_if_couponbooleanPath Parameters
shopIdRequiredintegerBulk Update Redirect URL
Bulk updates product redirect URL.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectredirect_urlstringMust start with one of https Must not be greater than 2048 characters.
Path Parameters
shopIdRequiredintegerBulk Update Deliverables Type
Bulk updates product deliverables label.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonOptionalproduct_idsobjectdeliverables_typestring"serials" | "service" | "dynamic"Path Parameters
shopIdRequiredintegerBulk Update Deliverables Label
Bulk updates product deliverables label.
Authorization
AuthorizationRequiredBearer <token>You can retrieve your API key by visiting your dashboard and clicking Account > API.
In: header
Request Body
application/jsonRequiredproduct_idsobjectdeliverables_labelRequiredstringMust not be greater than 255 characters.
Path Parameters
shopIdRequiredinteger