---
title: "Changes to Create a vendor"
method: POST
path: "/v3/vendors"
---

# Changes to Create a vendor

`POST /v3/vendors`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `54edddceb0a5`: 16 breaking, 3 info

## Changes

- **2026-11-03** `54edddceb0a5`: 16 breaking, 3 info
  - added `#/components/schemas/CountryCode, subschema #2` to the `address/allOf[#/components/schemas/Address]/country` request property `allOf` list
  - the request property `address/allOf[#/components/schemas/Address]/city` became required
  - the request property `address/allOf[#/components/schemas/Address]/country` became required
  - the request property `address/allOf[#/components/schemas/Address]/line1` became required
  - the request property `address/allOf[#/components/schemas/Address]/zipOrPostalCode` became required
  - the `address/allOf[#/components/schemas/Address]/city` request property's minLength was increased from `0` to `1`
  - the `address/allOf[#/components/schemas/Address]/line1` request property's minLength was increased from `0` to `1`
  - the `address/allOf[#/components/schemas/Address]/zipOrPostalCode` request property's minLength was increased from `0` to `1`
  - added the pattern `^.{0,1000}$` to the request property `address/allOf[#/components/schemas/Address]/line1`
  - added the pattern `^.{0,100}$` to the request property `address/allOf[#/components/schemas/Address]/city`
  - added the pattern `^.{0,100}$` to the request property `address/allOf[#/components/schemas/Address]/line2`
  - added the pattern `^.{0,100}$` to the request property `address/allOf[#/components/schemas/Address]/stateOrProvince`
  - added the pattern `^.{0,30}$` to the request property `address/allOf[#/components/schemas/Address]/zipOrPostalCode`
  - the `address/allOf[#/components/schemas/Address]/country` request property type changed from `string` to no type
  - the `paymentInformation/allOf[#/components/schemas/PaymentInformationResponse]/allOf[subschema #2]/virtualCard/allOf[#/components/schemas/VirtualCard]/alternatePayByType` response's property type changed from `string` to no type for status `201`
  - the `paymentInformation/allOf[#/components/schemas/PaymentInformationResponse]/allOf[subschema #2]/virtualCard/allOf[#/components/schemas/VirtualCard]/status` response's property type changed from `string` to no type for status `201`
  - added the optional property `relevanceScore` to the response with the `201` status
  - added `#/components/schemas/DisbursementType, subschema #2` to the `paymentInformation/allOf[#/components/schemas/PaymentInformationResponse]/allOf[subschema #2]/virtualCard/allOf[#/components/schemas/VirtualCard]/alternatePayByType` response property `allOf` list for the response status `201`
  - added `#/components/schemas/VirtualCardStatus, subschema #2` to the `paymentInformation/allOf[#/components/schemas/PaymentInformationResponse]/allOf[subschema #2]/virtualCard/allOf[#/components/schemas/VirtualCard]/status` response property `allOf` list for the response status `201`

---

[Operation](https://skmtc.dev/bill/apis/bill-v3-api/docs/v3/vendors/post.md) - [API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [Page](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/vendors/post)