authentication_settings_create
Create authentication settings for IdP SSO using metadata URL or provide SSO URL, issuer, and certificate. Configure SAML integration for user access.
Instructions
Create authentication settings for IdP SSO or metadata URL
Create authentication settings for IdP SSO or metadata URL. You must include either the metadata_url field or all of the following fields: idp_sso_url, idp_issuer, and idp_certificate.
You must have Instance Administrator permissions to run this endpoint.
[POST /public_api/v1/authentication-settings/create] · Authentication settings
Example request body:
{
"request_data": {
"name": "str",
"default_role": "",
"is_account_role": false,
"domain": " ",
"mappings": {
"email": "str",
"firstname": "str",
"lastname": "str",
"group_name": "str"
},
"advanced_settings": {
"relay_state": " ",
"idp_single_logout_url": " ",
"service_provider_public_cert": " ",
"service_provider_private_key": " ",
"authn_context_enabled": " ",
"force_authn": false
},
"idp_sso_url": " ",
"idp_certificate": " ",
"idp_issuer": " ",
"metadata_url": " "
}
}Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request_data": "<request_data>"
},
"name": "authentication_settings_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request_data | Yes |