> ## Documentation Index
> Fetch the complete documentation index at: https://developer.worldly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MSI - Create Material Blend

> This recipe shows how to create a new custom material blend in MSI.

```bash theme={null}
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
    }]
    }'
```

```json theme={null}
{"success":true}
```

<Steps>
  <Step title="Set your API key">
    Set the authentication headers:

    ```bash theme={null}
    --header 'x-api-key: <<apiKey>>'
    --header 'x-developer-request-token: <<apiKey>>'
    ```
  </Step>

  <Step title="Set your material name">
    This can be any name you like, but names must be unique within your MSI library.

    ```json theme={null}
    "name": "Organic/Poly Blend",
    ```
  </Step>

  <Step title="Optionally set a code">
    Use this field if you have a unique material identifier from an external system.

    ```json theme={null}
    "code": "my PLM code",
    ```
  </Step>

  <Step title="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](/api-reference/product-tools/msi-api-full/get-material-categories) for additional information.

    ```json theme={null}
    "category": "TX",
    ```
  </Step>

  <Step title="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](/api-reference/product-tools/msi-api-full/get-base-materials) for additional information about how to retrieve a master list of base materials and their IDs.

    ```json theme={null}
    "baseMaterialId": "TX0010",
    ```

    ```json theme={null}
    "baseMaterialId": "TX0001",
    ```
  </Step>

  <Step title="Set blend percentages">
    For blends, simply include the percentage of each base material.

    ```json theme={null}
    "blendPercentage": 60,
    ```

    ```json theme={null}
    "blendPercentage": 40
    ```
  </Step>
</Steps>