---
title: "Changes to Create a new organization"
method: POST
path: "/v3/organizations"
---

# Changes to Create a new organization

`POST /v3/organizations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 14 revisions.

- **2026-06-14** `acca5642c0bc`: 9 info
- **2025-11-20** `978cf99a2ac0`: 5 info
- **2024-03-04** `c3123d7b7301`: 3 breaking, 2 warning, 6 info

## Changes

- **2026-06-14** `acca5642c0bc`: 9 info
  - the response property `avatar` became required for the status `201`
  - the response property `identifier` became required for the status `201`
  - the response property `isTrial` became required for the status `201`
  - the response property `name` became required for the status `201`
  - the response property `resthookSignatureKey` became required for the status `201`
  - the response property `showCustomFieldCreation` became required for the status `201`
  - the response property `userRole` became required for the status `201`
  - the response property `validationToolConfig` became required for the status `201`
  - added the required property `allowDataSourceRecordCreation` to the response with the `201` status
- **2025-11-20** `978cf99a2ac0`: 5 info
  - api tag `Add x-hidden to endpoints` added
  - api tag `Organization API - Organization` removed
  - added the optional property `validationToolConfig/disableManualAnnotationEditing` to the response with the `201` status
  - added the optional property `validationToolConfig/hideDocumentStatus` to the response with the `201` status
  - added the optional property `validationToolConfig/hideShowRawValues` to the response with the `201` status
- **2024-03-04** `c3123d7b7301`: 3 breaking, 2 warning, 6 info
  - response property `validationToolConfig/theme/typography/fontSize` list-of-types was widened by adding types `number` to media type `application/json` of response `201`
  - added `subschema #1, subschema #2` to the `validationToolConfig/theme/palette/background` response property `oneOf` list for the response status `201`
  - the `validationToolConfig/theme/palette/background` response's property type changed from `object` to no type for status `201`
  - removed the optional property `validationToolConfig/theme/palette/background/default` from the response with the `201` status
  - removed the optional property `validationToolConfig/theme/palette/background/paper` from the response with the `201` status
  - added the optional property `showCustomFieldCreation` to the response with the `201` status
  - added the optional property `validationToolConfig/disableEditDocumentMetadata` to the response with the `201` status
  - added the optional property `validationToolConfig/hideEditPages` to the response with the `201` status
  - added the optional property `validationToolConfig/hideReject` to the response with the `201` status
  - added the optional property `validationToolConfig/hideReparse` to the response with the `201` status
  - added the optional property `validationToolConfig/hideRunOcr` to the response with the `201` status

---

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