Skip to main content
POST
Create identity provider

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Request to create an identity provider.

alias
string
required

Unique alias. Ensure it's URL-safe and in lowercase.

display_name
string
required

Human-readable display name

provider_id
enum<string>
required

Protocol type.

Available options:
oidc,
saml,
ldap
enabled
boolean
default:true

Whether the IdP is active

known_provider
enum<string> | null

Known provider preset for this configuration.

Available options:
okta,
entra_id,
auth0,
google,
github,
ping_identity,
onelogin,
custom_oidc,
custom_saml,
active_directory
oidc_config
OidcConfig · object | null

OIDC config. Required when provider_id=oidc

saml_config
SamlConfig · object | null

SAML config. Required when provider_id=saml

ldap_config
LdapConfig · object | null

LDAP config. Required when provider_id=ldap

mappers
IdpMapperConfig · object[]

Claim/attribute mappers

Response

Identity provider created.

Response for a single identity provider.

alias
string
required
display_name
string
required
provider_id
string
required
enabled
boolean
required
internal_id
string | null
known_provider
enum<string> | null
Available options:
okta,
entra_id,
auth0,
google,
github,
ping_identity,
onelogin,
custom_oidc,
custom_saml,
active_directory
config
Config · object

Provider configuration. NexusOne masks the secrets.

mapper_count
integer
default:0

Number of configured mappers.