Sign in
Products API

Create a new Sync Variant

Creates a new Sync Variant for an existing Sync Product (See examples).

post/store/products/{id}/variants

Path parameters

integer required
OR
string required

Sync Product ID (integer) or External ID (if prefixed with @)

Headers

X-PF-Store-Idstring

Use this to specify which store you want to use (required only for account level token).

The store IDs can be retrieved with the Get basic information about stores endpoint.

Request body

idinteger

Sync Variant ID

external_idstring

Variant ID from the Ecommerce platform

sync_product_idinteger

Sync Product ID that this variant belongs to

namestring

Sync Variant name

syncedboolean

Indicates if this Sync Variant is properly linked with Printful product

variant_idinteger required

Printful Variant ID that this Sync Variant is synced to

retail_pricestring

Retail price that this item is sold for

currencystring

Currency in which prices are returned

is_ignoredboolean

Indicates if this Sync Variant is ignored

skustring nullable

SKU of this Sync Variant

main_category_idinteger nullable

Printful Variant catalog category ID

warehouse_product_idinteger nullable

Warehousing product ID. If the sync variant is connected with a warehousing item, this is the ID of corresponding warehouse product.

warehouse_product_variant_idinteger nullable

Warehousing variant ID. If the sync variant is connected with a warehousing item, this is its ID.

sizestring nullable

The size of the associated Catalog Variant

colorstring nullable

The color of the associated Catalog Variant

availability_status'active' | 'discontinued' | 'out_of_stock' | 'temporary_out_of_stock'

Indicates the status of the Sync Variant.

Example request

{
  "id": 10,
  "external_id": "12312414",
  "sync_product_id": 71,
  "name": "Red T-Shirt",
  "synced": true,
  "variant_id": 3001,
  "retail_price": "29.99",
  "currency": "USD",
  "is_ignored": true,
  "sku": "SKU1234",
  "product": {
    "variant_id": 3001,
    "product_id": 301,
    "image": "https://files.cdn.printful.com/products/71/5309_1581412541.jpg",
    "name": "Bella + Canvas 3001 Unisex Short Sleeve Jersey T-Shirt with Tear Away Label (White / 4XL)"
  },
  "files": [
    {
      "type": "default",
      "id": 10,
      "url": "​https://www.example.com/files/tshirts/example.png",
      "options": [
        {
          "id": "template_type",
          "value": "native"
        }
      ],
      "hash": "ea44330b887dfec278dbc4626a759547",
      "filename": "shirt1.png",
      "mime_type": "image/png",
      "size": 45582633,
      "width": 1000,
      "height": 1000,
      "dpi": 300,
      "status": "ok",
      "created": 1590051937,
      "thumbnail_url": "https://files.cdn.printful.com/files/ea4/ea44330b887dfec278dbc4626a759547_thumb.png",
      "preview_url": "https://files.cdn.printful.com/files/ea4/ea44330b887dfec278dbc4626a759547_thumb.png",
      "visible": true,
      "stitch_count_tier": "stitch_tier_1"
    }
  ],
  "options": [
    {
      "id": "embroidery_type",
      "value": "flat"
    }
  ],
  "main_category_id": 24,
  "warehouse_product_id": 3002,
  "warehouse_product_variant_id": 3002,
  "size": "XS",
  "color": "White"
}

Response

OK

codeinteger

Response status code 200

Example response

{
  "code": 200,
  "result": {
    "id": 10,
    "external_id": "12312414",
    "sync_product_id": 71,
    "name": "Red T-Shirt",
    "synced": true,
    "variant_id": 3001,
    "retail_price": "29.99",
    "currency": "USD",
    "is_ignored": true,
    "sku": "SKU1234",
    "product": {
      "variant_id": 3001,
      "product_id": 301,
      "image": "https://files.cdn.printful.com/products/71/5309_1581412541.jpg",
      "name": "Bella + Canvas 3001 Unisex Short Sleeve Jersey T-Shirt with Tear Away Label (White / 4XL)"
    },
    "files": [
      {
        "type": "default",
        "id": 10,
        "url": "​https://www.example.com/files/tshirts/example.png",
        "options": [
          {
            "id": "template_type",
            "value": "native"
          }
        ],
        "hash": "ea44330b887dfec278dbc4626a759547",
        "filename": "shirt1.png",
        "mime_type": "image/png",
        "size": 45582633,
        "width": 1000,
        "height": 1000,
        "dpi": 300,
        "status": "ok",
        "created": 1590051937,
        "thumbnail_url": "https://files.cdn.printful.com/files/ea4/ea44330b887dfec278dbc4626a759547_thumb.png",
        "preview_url": "https://files.cdn.printful.com/files/ea4/ea44330b887dfec278dbc4626a759547_thumb.png",
        "visible": true,
        "stitch_count_tier": "stitch_tier_1"
      }
    ],
    "options": [
      {
        "id": "embroidery_type",
        "value": "flat"
      }
    ],
    "main_category_id": 24,
    "warehouse_product_id": 3002,
    "warehouse_product_variant_id": 3002,
    "size": "XS",
    "color": "White"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.