Skip to main content
POST
Create a staff SSO connection

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Path Parameters

orgId
integer<int32>
required

Body

application/json
name
string
required

Human-readable connection name, e.g. the IdP it points at

Maximum string length: 120
signInScope
enum<string> | null

Who may sign in through the connection (default: ROUTED_DOMAINS)

Available options:
ROUTED_DOMAINS,
ANY_IDP_USER
provider
enum<string> | null

Identity provider kind (ENTRA, OKTA, GOOGLE, OTHER); labels the setup copy and the connection mark

Available options:
ENTRA,
OKTA,
GOOGLE,
OTHER

Response

Created

data
object
required