Skip to main content
POST
/
orgs
/
{org_id}
/
sso
/
domains
/
code
Request SSO Domain Creation Code
curl --request POST \
  --url https://api.useinvent.com/orgs/{org_id}/sso/domains/code \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "auto_join": true,
  "default_role": "ADMIN",
  "sync_profile": true,
  "allow_email_change": true,
  "allow_profile_change": true
}
'
null

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

​
org_id
string
required

Org ID

Body

Request a verification code to claim an SSO domain

​
email
string<email>
required

Admin email address to receive the verification code. Must belong to the claimed domain.

Maximum string length: 255
​
auto_join
boolean
required

Whether to auto-join new users matching this domain. Defaults to false.

​
default_role
enum<string>
required

Role assigned to auto-joined members. Defaults to STAFF.

Available options:
ADMIN,
DEVELOPER,
MANAGER,
STAFF
​
sync_profile
boolean

Whether to sync profile fields from the IdP on each sign-in. Defaults to true.

​
allow_email_change
boolean

Whether users on this domain can self-serve change their email. Defaults to false.

​
allow_profile_change
boolean

Whether users on this domain can self-serve change their name and avatar. Defaults to true.

Response

200 - application/json