---
title: "Create a new material vendor. Use this endpoint instead of the path-based v1
when your material ids may contain '/' characters, which ASP.NET Core routing
cannot match once URL-encoded."
method: POST
path: "/api/v2/material-vendors"
tags: ["Material Vendor"]
---

# Create a new material vendor. Use this endpoint instead of the path-based v1
when your material ids may contain '/' characters, which ASP.NET Core routing
cannot match once URL-encoded.

`POST /api/v2/material-vendors`

## Request body

- MaterialVendorCreateMaterialVendorRequestDto — Request parameters for creating a vendor on a material. Introduced for the v2 endpoint because material ids may contain '/' characters, which cannot be round-tripped through URL path segments.
  - `materialId` string, required — Unique id of the material to create the vendor on.
  - `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)