Raw schema
{
"type": "object",
"properties": {
"recipient": {
"type": "object",
"properties": {
"name": {
"description": "Full name.",
"type": "string"
},
"company": {
"description": "Company name.",
"type": "string"
},
"address1": {
"description": "Address line 1.",
"type": "string"
},
"address2": {
"description": "Address line 2.",
"type": "string"
},
"city": {
"description": "City.",
"type": "string"
},
"state_code": {
"description": "State code — required for US, CA and AU.",
"type": "string"
},
"country_code": {
"type": "string",
"description": "Two-letter ISO country code, e.g. US."
},
"zip": {
"description": "ZIP / postal code.",
"type": "string"
},
"phone": {
"description": "Phone number.",
"type": "string"
},
"email": {
"description": "Email address.",
"type": "string"
},
"tax_number": {
"description": "Tax number (required for Brazil: CPF/CNPJ).",
"type": "string"
}
},
"required": [
"country_code"
],
"description": "Ship-to address (name, address1, city, country_code, zip are normally needed)."
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"external_id": {
"description": "Your line-item id.",
"type": "string"
},
"variant_id": {
"description": "Catalog variant id (then give files).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"sync_variant_id": {
"description": "Sync Variant id from your Printful store.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"external_variant_id": {
"description": "Your platform's variant id for a Sync Variant.",
"type": "string"
},
"warehouse_product_variant_id": {
"description": "Warehouse product variant id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"product_template_id": {
"description": "Product Template to generate print files from (variant_id is then required).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Quantity (max 1000 per item)."
},
"retail_price": {
"description": "Retail price shown on the packing slip, e.g. \"29.99\".",
"type": "string"
},
"name": {
"description": "Display name on the packing slip.",
"type": "string"
},
"sku": {
"description": "Your SKU.",
"type": "string"
},
"files": {
"description": "Print files (needed with a plain catalog variant_id).",
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Placement / role of the file, e.g. default, front, back, preview (see the catalog product's files).",
"type": "string"
},
"url": {
"description": "Public URL of the print file. Give url or id.",
"type": "string"
},
"id": {
"description": "Id of a file already in the File Library. Give url or id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"options": {
"description": "Additional file options.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Option id, e.g. stitch_color or thread_colors."
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Option value."
}
},
"required": [
"id",
"value"
]
}
},
"filename": {
"description": "File name.",
"type": "string"
}
}
}
},
"options": {
"description": "Product options, e.g. embroidery thread colors.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Option id, e.g. stitch_color or thread_colors."
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Option value."
}
},
"required": [
"id",
"value"
]
}
}
},
"required": [
"quantity"
]
},
"description": "Order items."
},
"external_id": {
"description": "Your own order id; the order is then also addressable as @<external_id>.",
"type": "string"
},
"shipping": {
"description": "Shipping method id from printful_calculate_shipping_rates (default STANDARD).",
"type": "string"
},
"retail_costs": {
"description": "Retail costs to show on the packing slip.",
"type": "object",
"properties": {
"currency": {
"description": "3-letter currency code.",
"type": "string"
},
"subtotal": {
"type": "string"
},
"discount": {
"type": "string"
},
"shipping": {
"type": "string"
},
"tax": {
"type": "string"
}
}
},
"gift": {
"description": "Gift message for the packing slip.",
"type": "object",
"properties": {
"subject": {
"description": "Gift message title.",
"type": "string"
},
"message": {
"description": "Gift message text.",
"type": "string"
}
}
},
"packing_slip": {
"description": "Custom packing slip.",
"type": "object",
"properties": {
"email": {
"description": "Customer-service email.",
"type": "string"
},
"phone": {
"description": "Customer-service phone.",
"type": "string"
},
"message": {
"description": "Custom packing-slip message.",
"type": "string"
},
"logo_url": {
"description": "Logo / sticker URL (printed monochrome).",
"type": "string"
},
"store_name": {
"description": "Store name override for the return address.",
"type": "string"
},
"custom_order_id": {
"description": "Your own order id to print instead of Printful's.",
"type": "string"
}
}
},
"store_id": {
"description": "Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.",
"type": "string"
}
},
"required": [
"recipient",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}