Printago API
POST
/v1/skus
Create a new SKU
Request Body
The SKU data including name, price, and linked parts
SkuInsert
customMetadataoptional
Record<string, any>
Construct a type with a set of properties K of type T
descriptionrequired
string
externalIdrequired
string
externalProviderrequired
any
folderIdoptional
string
inputsoptional
object[]
connectedPropertyIdoptional
string
idoptional
string
namerequired
string
typerequired
any
linkedPartsrequired
object[]
exposedParametersrequired
string[]
extensionsoptional
object
labelrequired
string
materialAssignmentsoptional
Record<string, object[]>
parameterBindingsoptional
Record<string, string>
parametersrequired
object[]
namerequired
string
typerequired
any
valueoptional
number | string | boolean
partIdrequired
string
pattern: ^[a-z0-9]{24}$
plateQuantitiesBindingoptional
string
quantityrequired
number
min: 0max: 500
sequenceBindingsoptional
Record<string, string>
Text-parameter name → sequence id: each queued unit consumes the next serial.
skuIdoptional
string
pattern: ^[a-z0-9]{24}$
optionBindingsoptional
string[]
skurequired
string
titlerequired
string
Example Request
application/json
{
"linkedParts": [
{
"skuId": "string",
"parameters": [
{
"name": "string"
}
],
"partId": "string",
"quantity": 0,
"label": "string",
"exposedParameters": [
"string"
]
}
],
"inputs": [
{
"id": "string",
"name": "string"
}
],
"optionBindings": [
"string"
],
"description": "string",
"customMetadata": {},
"sku": "string",
"title": "string"
}
Response Schema
SkuLinkedPartsRelation
createdAtrequired
string
format: date-time
customMetadataoptional
Record<string, any>
Construct a type with a set of properties K of type T
descriptionrequired
string
externalIdrequired
string
externalProviderrequired
any
folderIdoptional
string
idrequired
string
pattern: ^[a-z0-9]{24}$
linkedPartsrequired
object[]
createdAtrequired
string
format: date-time
exposedParametersrequired
string[]
extensionsoptional
object
idrequired
string
pattern: ^[a-z0-9]{24}$
labelrequired
string
materialAssignmentsoptional
Record<string, object[]>
parameterBindingsoptional
Record<string, string>
parametersrequired
object[]
namerequired
string
typerequired
any
valueoptional
number | string | boolean
partIdrequired
string
pattern: ^[a-z0-9]{24}$
plateQuantitiesBindingoptional
string
quantityrequired
number
min: 0max: 500
sequenceBindingsoptional
Record<string, string>
Text-parameter name → sequence id: each queued unit consumes the next serial.
skuIdrequired
string
pattern: ^[a-z0-9]{24}$
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
updatedAtrequired
string
format: date-time
skurequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
titlerequired
string
totalCogsrequired
number
updatedAtrequired
string
format: date-time
Example Response
201 OK — application/json
{
"sku": "string",
"title": "string",
"description": "string",
"totalCogs": 1,
"customMetadata": {},
"id": "string",
"storeId": "string",
"createdAt": "2026-09-09T20:31:47.444Z",
"updatedAt": "2026-09-09T20:31:47.444Z",
"linkedParts": [
{
"skuId": "string",
"partId": "string",
"parameters": [
{
"name": "string"
}
],
"quantity": 0,
"label": "string",
"exposedParameters": [
"string"
],
"id": "string",
"storeId": "string",
"createdAt": "2026-09-09T20:31:47.444Z",
"updatedAt": "2026-09-09T20:31:47.444Z"
}
]
}