Skip to main content
POST
Create Identity Setup Link

Authorizations

Authorization
string
header
required

Bearer scheme name used by typed customer admin operations.

Body

application/json
intent
string | null
Example:

"sso"

reason
string | null

Optional audit reason (8..=1000 chars when present). The portal can send a short context string like "customer admin clicked Setup SSO Logins". When omitted, the audit row records a stock reason naming the actor type.

Example:

"customer admin clicked Setup SSO Logins"

return_url
string | null
deprecated
Example:

"https://api.mountthor.com/identity/setup-completed"

Response

Setup link minted

expires_at
string
required
identity_integration_id
string<uuid>
required

UUID of the underlying identity integration the link is scoped to.

intent
string
required

Echoed intent (sso, dsync, domain_verification).

Example:

"sso"

provider
string
required
Example:

"workos"

url
string
required