---
title: "Create a new vendor"
method: POST
path: "/api/vendors"
tags: ["Vendor"]
---

# Create a new vendor

`POST /api/vendors`

## Request body

- VendorCreateDto — Definition for creating a vendor.
  - `name` string, required — The name to give the entity. Must be unique to all active vendors.
  - `paymentTermsId` string, nullable — Payment terms key identifier. Please reference /api/payment-terms endpoint.
  - `vendorCode` string, nullable — Unique identifier for this vendor.
  - `notes` string, nullable — General notes associated to this vendor
  - `currencyCode` string, nullable — The currency of the vendor
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for the vendor

## Response `200`

Vendor created

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

## Other responses

- `400` — Validation issues with input

---

[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)