curl --request POST \
  --url https://api.fabric.inc/v3/products/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "products": [
    {
      "sku": "QWERTTY56DDFFVVV",
      "type": "ITEM",
      "status": "LIVE",
      "categoryId": "5e7329dfd5288b0011332377",
      "attributes": [
        {
          "id": "2f7329dfd5288b0011332317",
          "value": "blue"
        }
      ],
      "localizedProperties": {
        "en-US": {
          "attributes": [
            {
              "id": "5g7329dfd5288b0011332313",
              "value": "blue"
            }
          ]
        },
        "en-IN": {
          "attributes": [
            {
              "id": "3d7329dfd5288b0011332314",
              "value": "blue"
            }
          ]
        }
      }
    }
  ]
}
'

{
  "data": [
    {
      "success": [
        {
          "id": "AASSBCC12334FCD12334V",
          "sku": "XP-123345"
        }
      ],
      "errors": [
        {
          "id": "AASSBCC12334FCD23456A",
          "sku": "XP-23456",
          "message": [
            "Attribute ID 6d7329dfd5288b0011332311 can not be null"
          ]
        }
      ]
    }
  ]
}

Create

Add Products

At fabric, the term products refers to items, variants, and/or bundles. With this endpoint, you can add up to 25 products. Refer to the examples added for each type. Note:
1. If product type is Variant, they can be added using either SKU or ID.
2. When product type is Item, either parentCategoryId or parentCategorySKU must be specified.
3. When product type is Bundle, items in a bundle can be added using either SKU or ID.
4. In the response you can see the products that are added successfully and the ones that couldn’t be added.

POST

products

batch

curl --request POST \
  --url https://api.fabric.inc/v3/products/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "products": [
    {
      "sku": "QWERTTY56DDFFVVV",
      "type": "ITEM",
      "status": "LIVE",
      "categoryId": "5e7329dfd5288b0011332377",
      "attributes": [
        {
          "id": "2f7329dfd5288b0011332317",
          "value": "blue"
        }
      ],
      "localizedProperties": {
        "en-US": {
          "attributes": [
            {
              "id": "5g7329dfd5288b0011332313",
              "value": "blue"
            }
          ]
        },
        "en-IN": {
          "attributes": [
            {
              "id": "3d7329dfd5288b0011332314",
              "value": "blue"
            }
          ]
        }
      }
    }
  ]
}
'

{
  "data": [
    {
      "success": [
        {
          "id": "AASSBCC12334FCD12334V",
          "sku": "XP-123345"
        }
      ],
      "errors": [
        {
          "id": "AASSBCC12334FCD23456A",
          "sku": "XP-23456",
          "message": [
            "Attribute ID 6d7329dfd5288b0011332311 can not be null"
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

S2S access token (JWT) from fabric Identity service (during Login)

Headers

x-fabric-tenant-id

string

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

Example:

"517fa9dfd42d8b00g1o3k312"

x-fabric-request-id

string

Unique request ID

Example:

"263e731c-45c8-11ed-b878-0242ac120002"

Body

application/json

products

object[]

required

Minimum array length: 1

Show child attributes

products.sku

string

required

Unique product ID that maps to fabric's standard attribute called SKU.
Note: sku shouldn't include ; or =

Example:

"XP-123345"

products.categoryId

string

required

24-character system-generated category ID

Example:

"QWE1234CCVFDDERW21"

products.type

enum<string>

required

Supported product types

Available options:

ITEM,

VARIANT,

BUNDLE

Example:

"ITEM"

products.status

enum<string>

required

Represents the current status of product. This value takes precedence over isActive if both are sent in the request.

Available options:

DRAFT,

LIVE

Example:

"LIVE"

products.isActive

boolean

deprecated

Determines if the Product is published or unpublished. Status parameter takes precedence

Example:

true

products.attributes

object[]

Array of product attributes

Show child attributes

products.attributes.id

string

required

24-character system-generated attribute ID

Example:

"6d7329dfd5288b0011332311"

products.attributes.value

required

Attribute value

Example:

"blue"

products.parentProduct

object

ID or SKU of parent product

Option 1
Option 2

Show child attributes

products.parentProduct.id

string

Product ID

Example:

"AASSBCC12334FCD12334V"

products.bundleProducts

object

Option 1 · object[]
Option 2 · object[]

Show child attributes

products.bundleProducts.sku

string

required

Unique product ID that maps to fabric's standard attribute called SKU.
Note: sku shouldn't include ; or =

Example:

"XP-123345"

products.bundleProducts.quantity

integer<int32>

required

Number of items or variants in bundle

Example:

2

products.localizedProperties

object

Show child attributes

products.localizedProperties.{key}

object

Localized attribute names

Show child attributes

products.localizedProperties.{key}.attributes

object[]

Array of product attributes

Show child attributes

products.localizedProperties.{key}.attributes.id

string

required

24-character system-generated attribute ID

Example:

"6d7329dfd5288b0011332311"

products.localizedProperties.{key}.attributes.value

required

Attribute value

Example:

"blue"

Example:

{
  "en-US": {
    "attributes": [
      { "id": "W123333RRTT555y1", "value": "blue" }
    ]
  },
  "en-IN": {
    "attributes": [
      { "id": "W123333RRTT555AA", "value": "blue" }
    ]
  }
}

Response

Add product response

data

object[]

Show child attributes

data.success

object[]

Show child attributes

data.success.id

string

Product ID

Example:

"AASSBCC12334FCD12334V"

data.success.sku

string

Unique product ID that maps to fabric's standard attribute called SKU.
Note: sku shouldn't include ; or =

Example:

"XP-123345"

data.errors

object[]

Show child attributes

data.errors.id

string

Product ID

Example:

"AASSBCC12334FCD12334V"

data.errors.sku

string

Unique product ID that maps to fabric's standard attribute called SKU.
Note: sku shouldn't include ; or =

Example:

"XP-123345"

data.errors.message

string[]

Error detail

Add Product Update Product by ID

⌘I

Product Catalog

Product Catalog User Guides

Product Catalog API

Developer Guide

Catalog Connector User Guides

Catalog Connector API

Add Products

Authorizations

Headers

Body

Response