Bulk create product variants
Creates multiple product variants in a single batch operation. Each variant can be associated with different products and includes stock levels, dimensions, and custom fields. Supports up to 50 variants per batch. Returns arrays of successful and failed creations.
/api/v1/{team_slug}/{app_slug}/variants/bulkAuthorizationBearer token · headerrequiredManagement API token, sent as Authorization: Bearer <token>.
team_slugstringrequiredTeam slug
app_slugstringrequiredApp slug
application/jsonVariants data to create
variantsinternal_pkg_webserver_v1.BulkCreateVariantItem[]requiredShow propertiesHide properties
internal_pkg_webserver_v1.BulkCreateVariantItemcustom_fieldsobjectproduct_idstringrequiredpurchase_pricegithub_com_enadhq_nabbit_internal_pkg_webserver_models.PurchasePriceShow propertiesHide properties
currencystringvalue_centsintegerstatusstringrequiredStatus of the product
activedraftinactivestockinternal_pkg_webserver_v1.InputVariantStock[]Stock level of the variant
Show propertiesHide properties
internal_pkg_webserver_v1.InputVariantStockinventory_datestringISO 8601 date format with time zone e.g. 2024-12-12T09:13:31.039Z.
quantityintegerwarehouse_slugstringrequiredvalidate_stockbooleanvariant_dimensionsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.DimensionsShow propertiesHide properties
capacity_milliliterintegerthe capacity in milliliter
depthintegerThe products depth in millimeter
diameterintegerthe products diameter in millimeter
heightintegerThe products height in millimeter
lengthintegerThe products length in millimeter
weightintegerThe products weight in grams
widthintegerThe products width in millimeter
variant_group_idstringvariant_namestringrequiredVariantName of the variant
variant_numberstringrequiredNumber of the variant
Variants created successfully
datainternal_pkg_webserver_v1.BulkCreateVariantsResponserequiredShow propertiesHide properties
failedinternal_pkg_webserver_v1.BulkCreateVariantFailedCreation[] | nullShow propertiesHide properties
internal_pkg_webserver_v1.BulkCreateVariantFailedCreationreasonstringvariant_numberstringsuccessfulgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Variant[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Variantattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Attributecreated_atstringdescriptionstring | nullfilterableboolean | nullidstringkeystringnamestring | nulltemplate_keystringtemplate_namestringtranslatableboolean | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.AttributeTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]updated_atstring | nullvaluesobject | nullcreated_atstringcustom_fieldsobject | nullidstringimagesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ImageWithPriority[] | nullImages of the product
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ImageWithPriorityaltstring | nullapp_idstring | nullattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullblurhashstringcopyrightstring | nullcustomobject | nullfolder_idstringidstringparent_idstring | nullpriorityintegerpublicbooleanstatusstringtitlestring | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ImageTranslationShow propertiesHide properties
altgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullcopyrightgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nulltitlegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullurlstringlistingsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListingsShow propertiesHide properties
smartgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListing[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListingidstringslugstringstaticgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListing[] | nullparent_product_idstringpurchase_pricegithub_com_enadhq_nabbit_internal_pkg_webserver_models.PurchasePrice | nullShow propertiesHide properties
currencystringvalue_centsintegernullshipping_attributesstring[] | nullstatusstringstore_groupgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantStoreGroupWithPrices[] | nullProduct StoreGroup
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantStoreGroupWithPricescreated_atstringidstringnamestringpricesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantPrice[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantPriceamount_cents_with_taxintegercreated_atstringidstringmarketgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Marketon_salebooleanreference_price_with_taxinteger | nullsale_end_timestampstring | nullsale_price_with_taxinteger | nullsale_start_timestampstring | nullstatusgithub_com_enadhq_nabbit_internal_pkg_webserver_models.PriceStatusactiveinactivedraftupdated_atstring | nullslugstringstore_typestringupdated_atstring | nulltagsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Tag[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Tagattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullcreated_atstringfilterablebooleanidstringkeystringmarketsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Market[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Marketactivebooleancountry_codesstring[] | nullcreated_atstringcurrency_codestringidstringlocalestringnamestringslugstringupdated_atstring | nullnamestringschedulesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Job[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Jobadd_category_namesstring[]add_collection_namesstring[]add_tag_namesstring[]execute_atstringDate when the job should run
finished_atstring | nullIf a job is finished will this timestamp be filled
group_idstringidstringitem_idstringitem_namestringitem_typestringremove_category_namesstring[]remove_collection_namesstring[]remove_tag_namesstring[]to_amount_cents_with_taxinteger | nullto_market_idstringto_market_statusstringto_on_saleboolean | nullto_sale_amount_cents_with_taxinteger | nullto_start_sale_timestampstringto_statusstring | nullto_stop_sale_timestampstringto_store_group_idstringstatusstringtranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.TagTranslationsShow propertiesHide properties
namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]updated_atstring | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantTranslationsShow propertiesHide properties
namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Translationidstringlocalestringvaluestringupdated_atstring | nullvalidate_stockbooleanvariant_dimensionsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Dimensions | nullShow propertiesHide properties
capacity_milliliterintegerthe capacity in milliliter
depthintegerThe products depth in millimeter
diameterintegerthe products diameter in millimeter
heightintegerThe products height in millimeter
lengthintegerThe products length in millimeter
weightintegerThe products weight in grams
widthintegerThe products width in millimeter
nullvariant_group_idstringvariant_namestringvariant_numberstringvideosgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Video[] | nullVideos of the product
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Videoattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nulldescriptionstringfolder_idstringidstringpathstringpublicbooleanstatusstringtitlestringtranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VideoTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nulltitlegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullvariantsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VideoVariant[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.VideoVariantformatstringheightintegerurlstringwidthintegerwarehouse_variant_stockgithub_com_enadhq_nabbit_internal_pkg_webserver_models.WarehouseVariantStock[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.WarehouseVariantStockavailable_onlinebooleancreated_atstringidstringinventory_datestring | nullquantityintegerupdated_atstring | nullwarehouse_namestringwarehouse_slugstringdetailsstring[]Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes
successbooleanrequiredInvalid request
detailsstring[]messagestringsuccessbooleanrequiredUnauthorized access
detailsstring[]messagestringsuccessbooleanrequiredInternal server error
detailsstring[]messagestringsuccessbooleanrequired