---
title: "Changes to Create a SAML Connection"
method: POST
path: "/saml_connections"
---

# Changes to Create a SAML Connection

`POST /saml_connections`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 49 revisions.

- **2026-10-02** (2025-11-10) `896a452e4c0c`: 3 info
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 2 info
- **2026-07-02** (2025-11-10) `98ec27b3a44e`: 2 info
- **2026-05-01** (2025-11-10) `688cb65fb0a6`: 1 info
- **2026-03-27** (2025-11-10) `ff30a1e76ea9`: 1 info
- **2026-03-09** (2025-11-10) `229652c48e01`: 1 info
- **2025-12-11** (2025-11-10) `569a9fe6f427`: 1 info

## Changes

- **2026-10-02** (2025-11-10) `896a452e4c0c`: 3 info
  - added the new optional request property `idp_certificates`
  - request property `idp_certificate` deprecated
  - added the required property `idp_certificates` to the response with the `200` status
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 2 info
  - added the new optional request property `login_hint`
  - added the required property `login_hint` to the response with the `200` status
- **2026-07-02** (2025-11-10) `98ec27b3a44e`: 2 info
  - added the required property `idp_certificate_expires_at` to the response with the `200` status
  - added the required property `idp_certificate_issued_at` to the response with the `200` status
- **2026-05-01** (2025-11-10) `688cb65fb0a6`: 1 info
  - added the non-success response with the status `409`
- **2026-03-27** (2025-11-10) `ff30a1e76ea9`: 1 info
  - added the required property `allow_organization_account_linking` to the response with the `200` status
- **2026-03-09** (2025-11-10) `229652c48e01`: 1 info
  - endpoint deprecated
- **2025-12-11** (2025-11-10) `569a9fe6f427`: 1 info
  - added the optional property `enterprise_connection_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/saml_connections/post.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/saml_connections/post)