Okta.Sdk.Model.UserProfile

October 22, 2025 · View on GitHub

Specifies the default and custom profile properties for a user. The default user profile is based on the System for Cross-domain Identity Management: Core Schema. The only permitted customizations of the default profile are to update permissions, change whether the firstName and lastName properties are nullable, and specify a pattern for login. You can use the Profile Editor in the Admin Console or the Schemas API to make schema modifications. You can extend user profiles with custom properties. You must first add the custom property to the user profile schema before you reference it. You can use the Profile Editor in the Admin Console or the Schemas API to manage schema extensions. Custom attributes can contain HTML tags. It's the client's responsibility to escape or encode this data before displaying it. Use best-practices to prevent cross-site scripting.

Properties

NameTypeDescriptionNotes
CitystringThe city or locality of the user's address (`locality`)[optional]
CostCenterstringName of the cost center assigned to a user[optional]
CountryCodestringThe country name component of the user's address (`country`). For validation, see ISO 3166-1 alpha 2 "short" code format.[optional]
DepartmentstringName of the user's department[optional]
DisplayNamestringName of the user suitable for display to end users[optional]
DivisionstringName of the user's division[optional]
EmailstringThe primary email address of the user. For validation, see RFC 5322 Section 3.2.3.[optional]
EmployeeNumberstringThe organization or company assigned unique identifier for the user[optional]
FirstNamestringGiven name of the user (`givenName`)[optional]
HonorificPrefixstringHonorific prefix(es) of the user, or title in most Western languages[optional]
HonorificSuffixstringHonorific suffix(es) of the user[optional]
LastNamestringThe family name of the user (`familyName`)[optional]
LocalestringThe user's default location for purposes of localizing items such as currency, date time format, numerical representations, and so on. A locale value is a concatenation of the ISO 639-1 two-letter language code, an underscore, and the ISO 3166-1 two-letter country code. For example, en_US specifies the language English and country US. This value is `en_US` by default.[optional]
LoginstringThe unique identifier for the user (`username`). For validation, see Login pattern validation. Every user within your Okta org must have a unique identifier for a login. This constraint applies to all users you import from other systems or applications such as Active Directory. Your organization is the top-level namespace to mix and match logins from all your connected applications or directories. Careful consideration of naming conventions for your login identifier will make it easier to onboard new applications in the future. Logins are not considered unique if they differ only in case and/or diacritical marks. If one of your users has a login of Isaac.Brock@example.com, there cannot be another user whose login is isaac.brock@example.com, nor isáàc.bröck@example.com. Okta has a default ambiguous name resolution policy for usernames that include @-signs. (By default, usernames must be formatted as email addresses and thus always include @-signs. You can remove that restriction using either the Admin Console or the Schemas API. Users can sign in with their non-qualified short name (for example: isaac.brock with username isaac.brock@example.com) as long as the short name is still unique within the organization. maxLength: 100[optional]
ManagerstringThe `displayName` of the user's manager[optional]
ManagerIdstringThe `id` of the user's manager[optional]
MiddleNamestringThe middle name of the user[optional]
MobilePhonestringThe mobile phone number of the user[optional]
NickNamestringThe casual way to address the user in real life[optional]
OrganizationstringName of the the user's organization[optional]
PostalAddressstringMailing address component of the user's address[optional]
PreferredLanguagestringThe user's preferred written or spoken language. For validation, see RFC 7231 Section 5.3.5.[optional]
PrimaryPhonestringThe primary phone number of the user such as a home number[optional]
ProfileUrlstringThe URL of the user's online profile. For example, a web page. See URL.[optional]
SecondEmailstringThe secondary email address of the user typically used for account recovery. For validation, see RFC 5322 Section 3.2.3.[optional]
StatestringThe state or region component of the user's address (`region`)[optional]
StreetAddressstringThe full street address component of the user's address[optional]
TimezonestringThe user's time zone[optional]
TitlestringThe user's title, such as Vice President[optional]
UserTypestringThe property used to describe the organization-to-user relationship, such as employee or contractor[optional]
ZipCodestringThe ZIP code or postal code component of the user's address (`postalCode`)[optional]

[Back to Model list] [Back to API list] [Back to README]