---
title: "Create a new material vendor. DEPRECATED: use POST /v2/material-vendors instead,
which accepts the material id in the request body. This endpoint fails for material
ids that contain '/' characters (e.g. \"SS-301-CR 1/2 HD\") because ASP.NET Core routing
cannot match URL-encoded forward slashes in path segments."
method: POST
path: "/api/materials/{materialId}/vendors"
tags: ["Material Vendor"]
deprecated: true
---

# Create a new material vendor. DEPRECATED: use POST /v2/material-vendors instead,
which accepts the material id in the request body. This endpoint fails for material
ids that contain '/' characters (e.g. "SS-301-CR 1/2 HD") because ASP.NET Core routing
cannot match URL-encoded forward slashes in path segments.

`POST /api/materials/{materialId}/vendors`

> **Deprecated.**

## Path parameters

- `materialId` string, required

## Request body

- MaterialShapeVendorCreateDto — Vendor with additional context for a material.
  - `vendorId` string, required — Vendor id associated to this entity. Please reference /api/vendors endpoint.
  - `priceUnit` 'kilogram' | 'pound', required — Specifies how a routing input item quantity is measured.
  - `isPrimary` boolean — Signifies if this is the primary vendor for this material.
  - `leadTimeInDays` integer, nullable — Lead time for this vendor.
  - `priceBreaks` MaterialShapeVendorPriceBreakCreateDto[], required — Vendor price breaks
    - `quantity` integer, required — The minimum quantity to associate this price break to.
    - `price` number, double, required — The price per unit.

## Response `200`

Material vendor created

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input
- `404` — Item with the given id did not exist

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)