---
title: "Changes to Create Identity Provider"
method: POST
path: "/v3/portals/{portalId}/identity-providers"
---

# Changes to Create Identity Provider

`POST /v3/portals/{portalId}/identity-providers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
- **2026-09-25** `68d43091b84d`: 3 warning
- **2026-09-18** `f324fb7610e4`: 3 breaking, 24 info
- **2026-05-20** `ccc33535acb5`: 2 breaking, 2 warning, 3 info
- **2026-02-20** `8715e5b7ad96`: 1 breaking, 2 info
- **2025-10-23** `8ab3ec3ed301`: 1 warning
- **2025-08-22** `3c0154b2053a`: 9 breaking, 6 info
- **2025-08-14** `6333a0d3b095`: 6 info
- **2025-07-22** `76b0fefddb0d`: 6 info
- **2025-07-01** `9a3d26a00088`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-25** `68d43091b84d`: 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `409.00` enum value to the `status` response property for the response status `409`
- **2026-09-18** `f324fb7610e4`: 3 breaking, 24 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `409`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `409`
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `409` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - added the required property `detail` to the response with the `409` status
  - added the required property `instance` to the response with the `400` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `instance` to the response with the `409` status
  - added the required property `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `409` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `403` status
  - added the required property `title` to the response with the `409` status
- **2026-05-20** `ccc33535acb5`: 2 breaking, 2 warning, 3 info
  - removed `#/components/schemas/SAMLIdentityProviderConfig` from the `config` request property `oneOf` list
  - added `#/components/schemas/PortalSAMLIdentityProviderConfig` to the `config` response property `oneOf` list for the response status `201`
  - removed the request property `login_path`
  - removed the optional property `login_path` from the response with the `201` status
  - the `enabled` request property default value `false` was removed
  - added `#/components/schemas/PortalSAMLIdentityProviderConfig` to the `config` request property `oneOf` list
  - removed `#/components/schemas/SAMLIdentityProviderConfig` from the `config` response property `oneOf` list for the response status `201`
- **2026-02-20** `8715e5b7ad96`: 1 breaking, 2 info
  - removed `#/components/schemas/ConfigureOIDCIdentityProviderConfig` from the `config` request property `oneOf` list
  - added `#/components/schemas/OIDCIdentityProviderConfig` to the `config` request property `oneOf` list
  - added the optional write-only property `config/oneOf[subschema #1: OIDC Identity Provider Config]/client_secret` to the response with the `201` status
- **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`: 9 breaking, 6 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 `instance` became nullable for the status `401`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
  - the `email` request property default value `email` was added
  - the `groups` request property default value `groups` was added
  - the `name` request property default value `name` was added
  - the `email` response's property default value `email` was added for the status `201`
  - the `groups` response's property default value `groups` was added for the status `201`
  - the `name` response's property default value `name` was added for the status `201`
- **2025-08-14** `6333a0d3b095`: 6 info
  - the `email` request property default value `email` was removed
  - the `groups` request property default value `groups` was removed
  - the `name` request property default value `name` was removed
  - the `email` response's property default value `email` was removed for the status `201`
  - the `groups` response's property default value `groups` was removed for the status `201`
  - the `name` response's property default value `name` was removed for the status `201`
- **2025-07-22** `76b0fefddb0d`: 6 info
  - the `email` request property default value `email` was added
  - the `groups` request property default value `groups` was added
  - the `name` request property default value `name` was added
  - the `email` response's property default value `email` was added for the status `201`
  - the `groups` response's property default value `groups` was added for the status `201`
  - the `name` response's property default value `name` was added for the status `201`
- **2025-07-01** `9a3d26a00088`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v3/portals/:portalId/identity-providers/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/:portalId/identity-providers/post)
