Skip to main content

UserParms

Attributes for the new user.

Properties

NameTypeDescriptionNotes
apply_grace_periodboolIndicates if the user is granted a new frozen grace period. This value is not used when creating a user. If provided, it will be ignored.[optional]
emailstrThe email address of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. It must be set to use EMAIL OTP authentication and other features that require an email address. To remove the existing value, set the value to an empty string.[optional]
email_verificationboolIndicates if a verification email message should be sent to the user if the user now requires verification. The user's policy requiring user verification must also be enabled for the user. If not set, this value defaults to true.[optional]
external_idstrAn optional external ID for this user. This value can be used to track the external identity of an Identity as a Service user. To unset the external ID, specify an empty string.[optional]
external_sourcestrAn optional value that describes the source when the user is synchronized from an external source. To unset the external source, specify an empty string.[optional]
first_namestrThe first name of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. To remove the existing value, set the value to an empty string.[optional]
groupsList[str]A list of group UUIDs to be assigned to this user. If specified, these groups replace existing groups.[optional]
last_namestrThe last name of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. To remove the existing value, set the value to an empty string.[optional]
localestrThe locale of this user. If not set, the default account locale will be used. To remove the existing value, set the value to an empty string.[optional]
lockboolIndicates if all the user's authenticators are locked or not.[optional]
mobilestrThe mobile number of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. It must be set to use SMS OTP authentication. To remove the existing value, set the value to an empty string.[optional]
oauth_rolesList[str]A list of oauth role UUIDs to be assigned to this user. If specified, these oauth roles replace existing oauth roles.[optional]
organizationsList[str]A list of organization UUIDs to be assigned to this user. If specified, these organizations replace existing organizations.[optional]
phonestrThe phone number of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. It must be set to use VOICE OTP authentication. To remove the existing value, set the value to an empty string.[optional]
preferred_otp_deliverystrPreferred OTP delivery type (SMS, EMAIL or VOICE) or SYSTEM to use the system defined default.[optional]
preferred_otp_delivery_contact_attributesDict[str, str]Preferred OTP delivery contact attribute for the given type (i.e., OTP_EMAIL, OTP_SMS, OTP_VOICE. An empty string means no override for that type).[optional]
registration_requiredboolIndicates whether self-registration is required. If not set when the user is created, this value defaults to true.[optional]
security_idstrThe security ID of this user. The security ID is a unique value used to identity the user when performing smart card login to Microsoft Windows.[optional]
statestrThe state of this user. Only users in the ACTIVE state can perform authentication. If not set when the user is created, this value defaults to ACTIVE.[optional]
user_aliasesList[UserAlias]A list of user aliases for this user. Alias values must be unique with respect to the userId and other aliases of this user and other users.[optional]
user_attribute_valuesList[UserAttributeValue]A list of user attribute values for this user.[optional]
user_extra_attributesList[UserExtraAttribute]A list of extra optional attributes for this user.[optional]
user_idstrThe user ID for this user. This value is required when creating the user, optional during update. The userId must be unique with respect to aliases of this user and the userId and aliases of all other users.[optional]
user_principal_namestrThe user principal name of this user. This value may or may not be required depending on configuration. If it is required, it must be specified when creating the user. If it is required, it must be specified when updating the user and a value is not currently set. To remove the existing value, set the value to an empty string.[optional]
verification_requiredboolIndicates whether verification is required. If not set when the user is created, this value defaults to true.[optional]

Example