Developers

Create Tenant

Scopes
write:tenant

Request Body

region
string
REQUIRED
tenant_id
string
REQUIRED

Your tenant's identifier.

settings
object
settings.
api_version
string

Available Values:2021-07-04

settings.
auto_sign_in
boolean
settings.
default_strategy
string
settings.
expose_unsafe_errors
boolean
settings.
extra_params
array<string>
settings.
extra_scopes
array<string>
settings.
force_email_verification
boolean
settings.
forgot_password_enabled
boolean
settings.
hash_function
string

Available Values:bcryptargon2pbkdf2

Default value:"bcrypt"

settings.
register_enabled
boolean
settings.
tenant_login_url
string
settings.
welcome_emails_enabled
boolean
settings.
authenticator
object

PlusAuth Authenticator Application related settings

settings.authenticator.
bind_sim
boolean

Should authenticator application logout if a SIM card change detected on device

settings.
ciba
object
settings.ciba.
delivery_mode
string

Available Values:pingpoll

settings.ciba.
notifier_endpoint
string
settings.
environment_variables
object
settings.
policies
object
settings.policies.
account_blocking
object
settings.policies.account_blocking.
allow_user_unblock
boolean

If true, users will be able to unblock their accounts by the link received in notification email.

settings.policies.account_blocking.
allowed_attempts
integer
min5
max
250

Maximum failed login attempts to block user for specified duration.

settings.policies.account_blocking.
block_duration
integer
min60
max
630720000

Number of seconds to block the account.

settings.policies.account_blocking.
duration
integer
min60
max
7776000

Number of seconds before attempts are reset

settings.policies.account_blocking.
enabled
boolean
settings.policies.account_blocking.
notification
boolean

Send an email to user's email address about the activity.

settings.policies.account_blocking.
reset_after_success
boolean

Reset failed attempts count after successful login.

settings.policies.
brute_force
object
settings.policies.brute_force.
allowed_attempts
integer
min5
max
50

Allowed consecutive login attempts

settings.policies.brute_force.
block_duration
integer
min60
max
630720000

Number of seconds to block the IP.

settings.policies.brute_force.
duration
integer
min60
max
7776000

Number of seconds before attempts are reset

settings.policies.brute_force.
enabled
boolean
settings.policies.brute_force.
notification
boolean

Send an email to user's email address about the activity.

settings.policies.brute_force.
white_list
array<string>

Whitelisted IP addresses.

settings.policies.
password
object

Password policy settings to be enforced to your new users.

settings.policies.password.
custom_chars
string

Require at least on of the given characters

settings.policies.password.
history
integer
min1
max
10

The system will maintain a password history for each user and prevent the reuse of passwords included in the history. The password history can be up to 10 in size. When provided, the system will maintain existing and new users' password history going forward.

settings.policies.password.
lower_case
integer
min0
max
32

Require at least given value of lowercase letters

settings.policies.password.
max
integer
max
128

Maximum number of characters

settings.policies.password.
min
integer
min0

Minimum number of characters

settings.policies.password.
number
integer
min0
max
32

Require at least given value of numbers

settings.policies.password.
upper_case
integer
min0
max
32

Require at least given value of uppercase letters

settings.
ttl
object

Lifetime settings of generated tokens defined in seconds.

settings.ttl.
access_token
integer
min30
settings.ttl.
authorization_code
integer
min30
settings.ttl.
backchannel_authentication_request
integer
min30
settings.ttl.
client_credentials
integer
min30
settings.ttl.
device_code
integer
min30
settings.ttl.
id_token
integer
min30
settings.ttl.
refresh_token
integer
min30
settings.ttl.
session
integer
min30
POST
/tenants
1
2
3
4
5
Loading...
Response:
201
Loading...

Response Body Schema

keystore
array<object>
keystore.
created_at
number
REQUIRED

Key creation date in milliseconds since the epoch

keystore.
revoked_at
number

Revocation time in milliseconds since the epoch

keystore.
rotated_at
number

Rotation time in milliseconds since the epoch

keystore.
key
object
REQUIRED

Public JWK. You can look at JWK specification from here

keystore.key.
alg
string
REQUIRED
keystore.key.
e
string
REQUIRED
keystore.key.
key_ops
array<string>
keystore.key.
kid
string
REQUIRED
keystore.key.
kty
string
REQUIRED
keystore.key.
n
string
REQUIRED
keystore.key.
use
string
REQUIRED
keystore.key.
x5c
array<string>
keystore.key.
x5t
string
keystore.key.
x5t#S256
string
keystore.key.
x5u
string
region
string
REQUIRED
tenant_id
string
REQUIRED

Your tenant's identifier.

settings
object
REQUIRED
settings.
api_version
string
REQUIRED

Available Values:2021-07-04

settings.
auto_sign_in
boolean
REQUIRED
settings.
default_strategy
string
REQUIRED
settings.
expose_unsafe_errors
boolean
REQUIRED
settings.
extra_params
array<string>
REQUIRED
settings.
extra_scopes
array<string>
REQUIRED
settings.
force_email_verification
boolean
REQUIRED
settings.
forgot_password_enabled
boolean
REQUIRED
settings.
hash_function
string
REQUIRED

Available Values:bcryptargon2pbkdf2

Default value:"bcrypt"

settings.
register_enabled
boolean
REQUIRED
settings.
tenant_login_url
string
REQUIRED
settings.
welcome_emails_enabled
boolean
REQUIRED
settings.
authenticator
object

PlusAuth Authenticator Application related settings

settings.authenticator.
bind_sim
boolean

Should authenticator application logout if a SIM card change detected on device

settings.
ciba
object
REQUIRED
settings.ciba.
delivery_mode
string
REQUIRED

Available Values:pingpoll

settings.ciba.
notifier_endpoint
string
REQUIRED
settings.
environment_variables
object
REQUIRED
settings.
policies
object
REQUIRED
settings.policies.
account_blocking
object
REQUIRED
settings.policies.account_blocking.
allow_user_unblock
boolean
REQUIRED

If true, users will be able to unblock their accounts by the link received in notification email.

settings.policies.account_blocking.
allowed_attempts
integer
REQUIRED
min5
max
250

Maximum failed login attempts to block user for specified duration.

settings.policies.account_blocking.
block_duration
integer
REQUIRED
min60
max
630720000

Number of seconds to block the account.

settings.policies.account_blocking.
duration
integer
REQUIRED
min60
max
7776000

Number of seconds before attempts are reset

settings.policies.account_blocking.
enabled
boolean
REQUIRED
settings.policies.account_blocking.
notification
boolean
REQUIRED

Send an email to user's email address about the activity.

settings.policies.account_blocking.
reset_after_success
boolean
REQUIRED

Reset failed attempts count after successful login.

settings.policies.
brute_force
object
REQUIRED
settings.policies.brute_force.
allowed_attempts
integer
REQUIRED
min5
max
50

Allowed consecutive login attempts

settings.policies.brute_force.
block_duration
integer
REQUIRED
min60
max
630720000

Number of seconds to block the IP.

settings.policies.brute_force.
duration
integer
REQUIRED
min60
max
7776000

Number of seconds before attempts are reset

settings.policies.brute_force.
enabled
boolean
REQUIRED
settings.policies.brute_force.
notification
boolean
REQUIRED

Send an email to user's email address about the activity.

settings.policies.brute_force.
white_list
array<string>
REQUIRED

Whitelisted IP addresses.

settings.policies.
password
object
REQUIRED

Password policy settings to be enforced to your new users.

settings.policies.password.
custom_chars
string

Require at least on of the given characters

settings.policies.password.
history
integer
min1
max
10

The system will maintain a password history for each user and prevent the reuse of passwords included in the history. The password history can be up to 10 in size. When provided, the system will maintain existing and new users' password history going forward.

settings.policies.password.
lower_case
integer
min0
max
32

Require at least given value of lowercase letters

settings.policies.password.
max
integer
max
128

Maximum number of characters

settings.policies.password.
min
integer
min0

Minimum number of characters

settings.policies.password.
number
integer
min0
max
32

Require at least given value of numbers

settings.policies.password.
upper_case
integer
min0
max
32

Require at least given value of uppercase letters

settings.
ttl
object
REQUIRED

Lifetime settings of generated tokens defined in seconds.

settings.ttl.
access_token
integer
REQUIRED
min30
settings.ttl.
authorization_code
integer
REQUIRED
min30
settings.ttl.
backchannel_authentication_request
integer
REQUIRED
min30
settings.ttl.
client_credentials
integer
REQUIRED
min30
settings.ttl.
device_code
integer
REQUIRED
min30
settings.ttl.
id_token
integer
REQUIRED
min30
settings.ttl.
refresh_token
integer
REQUIRED
min30
settings.ttl.
session
integer
min30
subscription
object
REQUIRED
subscription.
customer_id
string
REQUIRED
subscription.
id
string
REQUIRED
subscription.
next_invoice
string
subscription.
payment_source_id
string
subscription.
plan
string
REQUIRED
subscription.
details
object
REQUIRED