---
title: "Changes to Create custom field"
method: POST
path: "/customfields/{entity}"
---

# Changes to Create custom field

`POST /customfields/{entity}`

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

## Timeline

Changed in 1 of 30 revisions.

- **2026-08-08** `222e6fad7c1f`: 1 breaking, 1 warning, 9 info

## Changes

- **2026-08-08** `222e6fad7c1f`: 1 breaking, 1 warning, 9 info
  - removed the media type `application/octet-stream` from the request body
  - added the new `link` enum value to the `items/type` response property for the response status `200`
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `query` request parameter `skipWebhook`
  - added the new optional request property `fields/items/required`
  - added the new optional request property `fields/items/unlisted`
  - added the new enum value `lineItemPurchaseOrders` to the `path` request parameter `entity`
  - added the new enum value `purchaseOrders` to the `path` request parameter `entity`
  - added the new `link` enum value to the request property `fields/items/type`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`

---

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