Skip to main content
curl --request POST \
     --url https://api-v2.production.higg.org/pic-api/v1/products/create \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <<apiKey>>' \
     --header 'x-developer-request-token: <<apiKey>>' \
     -d '{
  			"name": "My Shiny Disco PJ Pants",
  			"weight": 0.47,
  			"weightMeasureUnit": "kilograms",
  			"weightIsPrimaryData": true,
        "categoryExpansionId": "ApparelAccessories-SleepwearLoungewear-PajamaBottoms",
				"size":"Adult",
  			"materials": [
    			{
      			"netUse": 75,
      			"materialId": "MatTX0001",
      			"composition": 100
    			}
  			]
			}'

{"success":true}
1

Provide your Product Name

​
field: name

Field type: string
  • Product Name must be unique.
"name": "My Shiny Disco PJ Pants",
2

Provide the Product Weight

​
field: weight

RequiredField type: numeric

​
field: weightMeasureUnit

Field type: enum
  • kilograms
  • grams
  • milligrams
  • pounds
  • ounces

​
French Eco Score

​
field: weightIsPrimaryData

Field type: boolean
  • Set this field to: “true”
  • To generate a French Eco Score, you must include primary data for Product Weight.
  • This means that the Weight value and Unit of Measure must reflect the product’s actual weight, rather than an industry average.
"weight": 0.47,
"weightMeasureUnit": "kilograms",
"weightIsPrimaryData": true,
3

Set the Product Category

​
field: categoryExpansionId

  • PIC’s default assumptions come from a controlled list of categories, maintained by Worldly.
  • Use the Get Categories endpoint for the full list of available categories.
"categoryExpansionId": "ApparelAccessories-SleepwearLoungewear-PajamaBottoms",
4

Set the Product Size

​
field: size

​
Apparel

  • Adult
  • Childrens/Youth

​
Backpacks

  • Under 35L
  • 35-60L
  • Over 60L

​
Sleeping Bags

  • Short
  • Regular
  • Long

​
Tents

  • 1-2 Person
  • 3-5 Person
  • 6-8 Person
"size":"Adult",
5

Set the Materials

​
field: materials

Field type: array

​
field: materialId

  • Use the Get Materials endpoint to identify the materialId for each material.
  • PIC has a list of default materials; however, you may also include materials you custom built using the Higg MSI, or the PIC Material Library.
PIC Default Materials
  • The material IDs for the default PIC materials are maintained in the PIC Materials Taxonomy.
  • For example: MatTX0001
Higg MSI Custom Materials
  • MSI Example Materials are not available in PIC. If you want to use an Example Material in your PIC product, first duplicate it and then save it as a MSI Custom Material. Once the Custom Material is saved, it will be available as a material in PIC.
  • The materialID for an MSI Custom Material is a system-generated unique identifier.
  • For example: -12a3bc45d678e91011fg1ab2c
French Eco-Scores
  • Products built with MSI custom materials are not eligible for an Eco-Score

​
field: composition

Field type: integer
  • Enter a number between 1-100
  • The sum of all composition fields must be exactly 100%

​
field: netUse

Field type: numeric
  • number between 1-100
  • Net Use refers to cutting efficiency.
  • PIC assumes an average Loss Rate for Apparel products of 25%; therefore, the default value for this field is 75.
"materials": [
    {
        "netUse": 75,
        "materialId": "MatTX0001",
        "composition": 100
    }
]