Create IDP configuration

POST

/api/v5/rest/auth/saml2/:centralized_organization_slug/idp/

POST

/api/v5/rest/auth/saml2/:centralized_organization_slug/idp/

$ curl -X POST https://qa.creha.co/api/v5/rest/auth/saml2/centralized_organization_slug/idp/ \
>      -H "Secret-Access: Secret-Access" \
>      -H "Api-Key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "entity_id": "https://idp.crehana.com/saml2/org/123",
>   "name_id_format": "email",
>   "validity_days": 365
> }'

1 {
2   "message": "IDP configuration retrieved successfully",
3   "datetime": "2026-03-04T12:00:00",
4   "data": {
5     "id": "1",
6     "centralized_organization_id": "123",
7     "entity_id": "https://idp.crehana.com/saml2/org/123",
8     "certificate": "MIIDxTCCAq2gAwIBA...",
9     "certificate_expires_at": "2027-03-04T12:00:00Z",
10     "name_id_format": "email",
11     "is_active": true,
12     "created_at": "2026-03-04T12:00:00Z",
13     "updated_at": "2026-03-04T12:00:00Z"
14   }
15 }

Creates the SAML2 IDP configuration for an organization. Automatically generates an RSA key pair and a self-signed X.509 certificate. Only one IDP configuration per organization is allowed.

Authentication

Api-Keystring

API key of the organization. Always sent together with the Secret-Access header.

Path parameters

centralized_organization_slugstringRequired

Request

This endpoint expects an object.

entity_idstringRequired

Entity ID URI for the IDP

name_id_formatenumOptionalDefaults to email

Name ID format for SAML assertions

validity_daysintegerOptionalDefaults to 365

Certificate validity in days

Response

Successful Response

messagestring

Message of the response

datetimestring

Datetime of the API in ISO Format

dataobjectOptional

Errors

400

Bad Request Error

409

Conflict Error

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors