---
title: "Changes to Create a new custom object schema."
method: POST
path: "/crm-object-schemas/2026-09/schemas"
---

# Changes to Create a new custom object schema.

`POST /crm-object-schemas/2026-09/schemas`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-09-03** (2026-09) `8e557699eb26`: 1 breaking, 4 info

## Changes

- **2026-09-03** (2026-09) `8e557699eb26`: 1 breaking, 4 info
  - added the new required request property `shouldCreateSameObjectAssociation`
  - the endpoint scheme security `private_apps` was removed from the API
  - added the optional property `properties/items/currencyPropertyName` to the response with the `201` status
  - added the optional property `properties/items/numberDisplayHint` to the response with the `201` status
  - added the optional property `properties/items/textDisplayHint` to the response with the `201` status

---

[Operation](https://skmtc.dev/hubspot/apis/crm-schemas/docs/crm-object-schemas/2026-09/schemas/post.md) - [API](https://skmtc.dev/hubspot/apis/crm-schemas.md) - [Page](https://skmtc.dev/hubspot/apis/crm-schemas/changes/crm-object-schemas/2026-09/schemas/post)