---
title: "Changes to Create new purchase order"
method: POST
path: "/purchaseorders"
---

# Changes to Create new purchase order

`POST /purchaseorders`

> Every recorded change to this operation, newest first.
> 30 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 30 revisions.

- **2026-10-15** `798ec5734e1a`: 7 warning
- **2026-08-08** `222e6fad7c1f`: 20 breaking, 5 warning, 34 info

## Changes

- **2026-10-15** `798ec5734e1a`: 7 warning
  - added the new `APPROVED` enum value to the `status` response property for the response status `201`
  - added the new `CANCELED` enum value to the `status` response property for the response status `201`
  - added the new `COMPLETED` enum value to the `status` response property for the response status `201`
  - added the new `DECLINED` enum value to the `status` response property for the response status `201`
  - added the new `PARTIALLY_FULFILLED` enum value to the `status` response property for the response status `201`
  - added the new `PENDING` enum value to the `status` response property for the response status `201`
  - added the new `REQUESTED` enum value to the `status` response property for the response status `201`
- **2026-08-08** `222e6fad7c1f`: 20 breaking, 5 warning, 34 info
  - removed the media type `application/octet-stream` from the request body
  - request property `costs/items/type` was restricted to a list of enum values
  - the response property `billingAddress` became nullable for the status `201`
  - the response property `items/items/price` became nullable for the status `201`
  - the response property `items/items/unitCost` became nullable for the status `201`
  - the response property `shippingAddress` became nullable for the status `201`
  - the response property `status` became nullable for the status `201`
  - the response property `vendorId` became nullable for the status `201`
  - the response property `costs` became optional for the status `201`
  - the response property `costs/items/id` became optional for the status `201`
  - the response property `items/items/name` became optional for the status `201`
  - the response property `items/items/partId` became optional for the status `201`
  - the response property `items/items/partNumber` became optional for the status `201`
  - the response property `items/items/price` became optional for the status `201`
  - the response property `items/items/quantityReceived` became optional for the status `201`
  - the response property `items/items/unitCost` became optional for the status `201`
  - the response property `vendorContactIds` became optional for the status `201`
  - the response property `vendorId` became optional for the status `201`
  - removed the required property `billingAddress/id` from the response with the `201` status
  - removed the required property `shippingAddress/id` from the response with the `201` status
  - removed the request property `reviewNote`
  - removed the request property `status`
  - added the new `AMOUNT_NON_TAXABLE` enum value to the `costs/items/type` response property for the response status `201`
  - added the new `AMOUNT_TAXABLE` enum value to the `costs/items/type` response property for the response status `201`
  - added the new `PERCENT_TAXABLE` enum value to the `costs/items/type` response property for the response status `201`
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `query` request parameter `skipWebhook`
  - added the new optional request property `billingAddressId`
  - added the new optional request property `deletedAt`
  - added the new optional request property `extraFields`
  - added the new optional request property `items/items/extraFields`
  - added the new optional request property `items/items/lineExtraFields`
  - added the new optional request property `shippingAddressId`
  - added the new optional request property `title`
  - the request property `billingAddress` became nullable
  - the request property `items/items/price` became nullable
  - the request property `items/items/unitCost` became nullable
  - the request property `shippingAddress` became nullable
  - the request property `vendorId` became nullable
  - added the new `AMOUNT_NON_TAXABLE` enum value to the request property `costs/items/type`
  - …19 more

---

[Operation](https://skmtc.dev/getmaintainx/apis/maintainx-api/docs/purchaseorders/post.md) - [API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [Page](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/purchaseorders/post)