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

# Changes to Create a new custom object schema.

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

> Every recorded change to this operation, newest first.
> 14 revisions in range; 1 not diffed, 2 could not be searched.

## Timeline

Changed in 4 of 14 revisions.

- **2026-04-08** `b0d8bc008db9`: 1 info
- **2026-04-03** `3578967e48df`: 1 info
- **2026-03-30** `dc2fdad57f7f`: 22 breaking, 5 warning, 2 info
- **2026-03-25** `62586336cea2`: 1 info

## Changes

- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/crm-object-schemas/2026-03/schemas_create` removed and replaced with `post-/crm-object-schemas/2026-03/schemas`
- **2026-04-03** `3578967e48df`: 1 info
  - added the optional property `properties/items/currencyPropertyName` to the response with the `201` status
- **2026-03-30** `dc2fdad57f7f`: 22 breaking, 5 warning, 2 info
  - the response property `associations/items/name` became optional for the status `201`
  - the `associations/items/id` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `201`
  - removed the required property `associations/items/allowsCustomLabels` from the response with the `201` status
  - removed the required property `associations/items/cardinality` from the response with the `201` status
  - removed the required property `associations/items/category` from the response with the `201` status
  - removed the required property `associations/items/hasAllAssociatedObjects` from the response with the `201` status
  - removed the required property `associations/items/hasCascadingDeletes` from the response with the `201` status
  - removed the required property `associations/items/hasUserEnforcedMaxFromObjectIds` from the response with the `201` status
  - removed the required property `associations/items/hasUserEnforcedMaxToObjectIds` from the response with the `201` status
  - removed the required property `associations/items/hidden` from the response with the `201` status
  - removed the required property `associations/items/inverseAllowsCustomLabels` from the response with the `201` status
  - removed the required property `associations/items/inverseCardinality` from the response with the `201` status
  - removed the required property `associations/items/inverseHasAllAssociatedObjects` from the response with the `201` status
  - removed the required property `associations/items/inverseId` from the response with the `201` status
  - removed the required property `associations/items/inverseName` from the response with the `201` status
  - removed the required property `associations/items/isDefault` from the response with the `201` status
  - removed the required property `associations/items/isInversePrimary` from the response with the `201` status
  - removed the required property `associations/items/isPrimary` from the response with the `201` status
  - removed the required property `associations/items/maxFromObjectIds` from the response with the `201` status
  - removed the required property `associations/items/maxToObjectIds` from the response with the `201` status
  - removed the required property `associations/items/portalUniqueIdentifier` from the response with the `201` status
  - removed the required property `associations/items/readOnly` from the response with the `201` status
  - removed the optional property `associations/items/fromObjectType` from the response with the `201` status
  - removed the optional property `associations/items/hiddenReason` from the response with the `201` status
  - removed the optional property `associations/items/inverseLabel` from the response with the `201` status
  - removed the optional property `associations/items/label` from the response with the `201` status
  - removed the optional property `associations/items/toObjectType` from the response with the `201` status
  - added the optional property `associations/items/createdAt` to the response with the `201` status
  - added the optional property `associations/items/updatedAt` to the response with the `201` status
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

---

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