POST
Create Product
Creates a new SKU under an organization. Required before attaching AR assets or enabling try-on.
Note
Use this endpoint when: onboarding new catalog items, before configuring AR Try-On assets, before publishing a product.
Request body
orgIdstring
Organization identifier that owns the SKU. Use the orgId provided within the PixelBin account.
categorystring
High-level product category. This influences which AR fields and metadata are applicable.
subCategorystring
More specific product type within a category. Must match the selected category.
isActiveboolean
Controls whether the SKU is currently enabled/visible for try-on. Disable to keep it in the catalog but hidden from experiences.
statusstring
Lifecycle state of the SKU. Typically used to control publish/unpublish behavior beyond isActive.
productNamestring
Display name of the product shown in catalogs and UI surfaces.
productImagestring
Publicly accessible image URL used for thumbnails and product cards.
brandstring
Brand or manufacturer name associated with the product.
barcodestring
Optional product identifier such as UPC/EAN or internal barcode value.
actionUrlstring
Optional URL to open when a user clicks the product (e.g., PDP link). Can be null/empty if not used.
versionstring
Version string for the SKU definition (useful when you update AR configs/assets over time).
arEffectobject
AR configuration for the product (assets + rendering settings). Structure varies by category (makeup vs 3D categories)
metaobject
meta is optional descriptive/fit data used for filtering, analytics, or scaling/fit behaviors for certain categories (especially eyewear).
collectionIdsarray of string
List of collection identifiers used to group SKUs (e.g., seasonal drops, curated sets). Useful for organizing catalogs without duplicating products.
POST/skus
curl -X POST "https://api.pixelbin.io/service/platform/misc/v2.0/skus" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {apitoken}" \
-d '{"orgId":"","category":"eyewear","subCategory":"sunglasses","isActive":true,"status":"PUBLISHED","productName":"Smoke Aviator","productImage":"https://cdn.pixelbinz0.de/v2/calm-term-553038/original/01_Smoke_Aviator.png","brand":"Generic","barcode":"031000110KY","actionUrl":"","version":"1.0.0","arEffect":{"transform":{"position":{"x":0,"y":0,"z":0},"rotation":{"x":0,"y":0,"z":0}},"envSettings":{"useDefaultEnvironment":true},"effectAssets2D":[],"effectAssets3D":[{"id":"full","url":"https://cdn.pixelbinz0.de/v2/calm-term-553038/original/Titan_sunglasses_01.glb"}]},"meta":{}}'
Response
No example available.