---
title: "Changes to Create Portal"
method: POST
path: "/v3/portals"
---

# Changes to Create Portal

`POST /v3/portals`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 75 revisions.

- **2026-06-23** `bb5e056b7c6d` — 2 info
- **2026-04-07** `f8b12cdd4a06` — 2 info
- **2025-10-30** `845120e19d45` — 2 breaking
- **2025-10-23** `8ab3ec3ed301` — 1 warning
- **2025-08-22** `3c0154b2053a` — 11 breaking, 10 info
- **2025-08-14** `6333a0d3b095` — 3 breaking, 1 warning, 27 info
- **2025-07-22** `76b0fefddb0d` — 18 breaking, 12 warning, 1 info
- **2025-07-01** `9a3d26a00088` — 1 info

## Changes

- **2026-06-23** `bb5e056b7c6d` — 2 info
  - added the new optional request property `notifications_developer_pii_visibility_enabled`
  - added the optional property `notifications_developer_pii_visibility_enabled` to the response with the `201` status
- **2026-04-07** `f8b12cdd4a06` — 2 info
  - added the new optional request property `sipr_enabled`
  - added the required property `sipr_enabled` to the response with the `201` status
- **2025-10-30** `845120e19d45` — 2 breaking
  - the request property `display_name` became not nullable
  - the request property `name` became not nullable
- **2025-10-23** `8ab3ec3ed301` — 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `3c0154b2053a` — 11 breaking, 10 info
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/source` became nullable for the status `400`
  - the response property `detail` became nullable for the status `401`
  - the response property `display_name` became nullable for the status `201`
  - the response property `instance` became nullable for the status `401`
  - the response property `name` became nullable for the status `201`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
  - the request property `display_name` became nullable
  - the request property `name` became nullable
  - the `authentication_enabled` request property default value `true` was added
  - the `auto_approve_applications` request property default value `false` was added
  - the `auto_approve_developers` request property default value `false` was added
  - the `rbac_enabled` request property default value `false` was added
  - the `authentication_enabled` response's property default value `true` was added for the status `201`
  - the `auto_approve_applications` response's property default value `false` was added for the status `201`
  - the `auto_approve_developers` response's property default value `false` was added for the status `201`
  - the `rbac_enabled` response's property default value `false` was added for the status `201`
- **2025-08-14** `6333a0d3b095` — 3 breaking, 1 warning, 27 info
  - added the new required request property `name`
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `201`
  - removed `#/components/schemas/Portal, subschema #2` from the request body `allOf` list
  - added the new optional request property `authentication_enabled`
  - added the new optional request property `auto_approve_applications`
  - added the new optional request property `auto_approve_developers`
  - added the new optional request property `default_api_visibility`
  - added the new optional request property `default_application_auth_strategy_id`
  - added the new optional request property `default_page_visibility`
  - added the new optional request property `description`
  - added the new optional request property `display_name`
  - added the new optional request property `labels`
  - added the new optional request property `rbac_enabled`
  - removed `#/components/schemas/Portal, subschema #2` from the response body `allOf` list for the response status `201`
  - added the optional property `labels` to the response with the `201` status
  - added the required property `authentication_enabled` to the response with the `201` status
  - added the required property `auto_approve_applications` to the response with the `201` status
  - added the required property `auto_approve_developers` to the response with the `201` status
  - added the required property `canonical_domain` to the response with the `201` status
  - added the required property `created_at` to the response with the `201` status
  - added the required property `default_api_visibility` to the response with the `201` status
  - added the required property `default_application_auth_strategy_id` to the response with the `201` status
  - added the required property `default_domain` to the response with the `201` status
  - added the required property `default_page_visibility` to the response with the `201` status
  - added the required property `description` to the response with the `201` status
  - added the required property `display_name` to the response with the `201` status
  - added the required property `id` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `rbac_enabled` to the response with the `201` status
  - added the required property `updated_at` to the response with the `201` status
- **2025-07-22** `76b0fefddb0d` — 18 breaking, 12 warning, 1 info
  - added `#/components/schemas/Portal, subschema #2` to the request body `allOf` list
  - the request's body type/format changed from `object`/`` to ``/``
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `authentication_enabled` from the response with the `201` status
  - removed the required property `auto_approve_applications` from the response with the `201` status
  - removed the required property `auto_approve_developers` from the response with the `201` status
  - removed the required property `canonical_domain` from the response with the `201` status
  - removed the required property `created_at` from the response with the `201` status
  - removed the required property `default_api_visibility` from the response with the `201` status
  - removed the required property `default_application_auth_strategy_id` from the response with the `201` status
  - removed the required property `default_domain` from the response with the `201` status
  - removed the required property `default_page_visibility` from the response with the `201` status
  - removed the required property `description` from the response with the `201` status
  - removed the required property `display_name` from the response with the `201` status
  - removed the required property `id` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the required property `rbac_enabled` from the response with the `201` status
  - removed the required property `updated_at` from the response with the `201` status
  - removed the request property `authentication_enabled`
  - removed the request property `auto_approve_applications`
  - removed the request property `auto_approve_developers`
  - removed the request property `default_api_visibility`
  - removed the request property `default_application_auth_strategy_id`
  - removed the request property `default_page_visibility`
  - removed the request property `description`
  - removed the request property `display_name`
  - removed the request property `labels`
  - removed the request property `name`
  - removed the request property `rbac_enabled`
  - removed the optional property `labels` from the response with the `201` status
  - added `#/components/schemas/Portal, subschema #2` to the response body `allOf` list for the response status `201`
- **2025-07-01** `9a3d26a00088` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v3/portals/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/post)
