Skip to main content
curl --location --request POST 'https://api-v2.production.higg.org/msi-api/v1/materials/create' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <<apiKey>>'
--header 'x-developer-request-token: <<apiKey>>'
--data-raw '{

    "name": "Organic/Poly Blend",
    "code": "my PLM code",
    "category": "TX",
    "baseMaterials":[{
        "baseMaterialId": "TX0010",
        "blendPercentage": 60,
        "processId": "PR0804000137"

    }, {
        "baseMaterialId": "TX0001",
        "blendPercentage": 40
    }]
    }'

{"success":true}
1

Set your API key

Set the authentication headers:
--header 'x-api-key: <<apiKey>>'
--header 'x-developer-request-token: <<apiKey>>'
2

Set your material name

This can be any name you like, but names must be unique within your MSI library.
"name": "Organic/Poly Blend",
3

Optionally set a code

Use this field if you have a unique material identifier from an external system.
"code": "my PLM code",
4

Set the category

The category is required. This does not impact calculation but is used for classifying materials in the library.See MSI Get Material Categories for additional information.
"category": "TX",
5

Set the base materials

Each of your custom material in MSI contains reference(s) to the MSI base materials. These are referenced by a BaseMaterialId.See MSI Get Base Materials for additional information about how to retrieve a master list of base materials and their IDs.
"baseMaterialId": "TX0010",

"baseMaterialId": "TX0001",
6

Set blend percentages

For blends, simply include the percentage of each base material.
"blendPercentage": 60,

"blendPercentage": 40