---
title: "Changes to Create an Identity Federation app"
method: POST
path: "/api/v1/identity-federation"
---

# Changes to Create an Identity Federation app

`POST /api/v1/identity-federation`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 50 revisions.

- **2026-02-03** `04750dcfd487` — 2 info
- **2026-01-18** `b0303bb023ff` — 2 info
- **2025-06-12** `0b40e4fcf469` — 2 breaking, 4 info
- **2025-06-10** `8164fb8aa9f5` — 2 info
- **2025-04-30** `0c7cf3c5abc6` — 1 breaking, 4 info
- **2025-03-20** `beea10f3e7fb` — 1 breaking
- **2025-02-05** `f02a45abeffc` — 1 breaking, 1 info
- **2024-12-22** `d49c203898c2` — 2 breaking

## Changes

- **2026-02-03** `04750dcfd487` — 2 info
  - added the new optional request property `includeOidcTokensInAssertion`
  - added the optional property `data/allOf[#/components/schemas/IdentityFederationAppCreate]/includeOidcTokensInAssertion` to the response with the `200` status
- **2026-01-18** `b0303bb023ff` — 2 info
  - added the new optional request property `ttlInMinutes`
  - added the optional property `data/allOf[#/components/schemas/IdentityFederationAppCreate]/ttlInMinutes` to the response with the `200` status
- **2025-06-12** `0b40e4fcf469` — 2 breaking, 4 info
  - the `mappings/items/` request property type changed from `string` to `object`
  - the `data/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/` response's property type changed from `string` to `object` for status `200`
  - added the new optional request property `mappings/items/key`
  - added the new optional request property `mappings/items/value`
  - added the optional property `data/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/key` to the response with the `200` status
  - added the optional property `data/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/value` to the response with the `200` status
- **2025-06-10** `8164fb8aa9f5` — 2 info
  - added the new optional request property `samlAudienceOverride`
  - added the optional property `data/allOf[#/components/schemas/IdentityFederationAppCreate]/samlAudienceOverride` to the response with the `200` status
- **2025-04-30** `0c7cf3c5abc6` — 1 breaking, 4 info
  - the response's body type changed from `array` to `object` for status `200`
  - the request property `acsUrl` became optional
  - the request property `entityId` became optional
  - added the optional property `data` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
- **2025-03-20** `beea10f3e7fb` — 1 breaking
  - removed the media type `application/x-www-form-urlencoded` from the request body
- **2025-02-05** `f02a45abeffc` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **2024-12-22** `d49c203898c2` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

---

[Operation](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync/docs/api/v1/identity-federation/post.md) · [API](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync.md) · [Page](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync/changes/api/v1/identity-federation/post)