Optional fields

In this section, we will provide a detailed explanation of the optional fields available when using the Create User action. These fields allow for more customization and flexibility, helping you tailor user profiles to fit your organization’s specific needs.

The optional fields are grouped into the following categories:

Contact Information:

  1. Addresses:

    Users can have one or more physical addresses added to their profile. These can be home, office, or any other relevant locations. Each address contains the following details:

    Address: The full structured address of the user.

    Type: Defines the category of the address (e.g., work, home, other, custom).

    Custom Type: If "custom" is selected as the type, specify a custom category name.

    Country: The country associated with the address.

    Country Code: The ISO 3166-1 standard country code.

    Extended Address: Additional address details such as apartment, suite, or sub-region.

    Locality: The city or town of the address.

    Post Office Box Number: The P.O. Box number if applicable.

    Postal Code: The ZIP or postal code of the address.

    Primary: Indicates whether this is the user's primary address (Yes/No).

    Source is Structured: Specifies if the address is formatted in a structured way (Yes/No).

    Region: The province or state of the address.

    Street Address: The full street address, such as "123 Main St."

  2. Emails (Secondary Emails):

    Additional email addresses can be assigned to a user for communication outside their primary email. Each email entry includes:

    Secondary Email: An alternate email address linked to the user’s account.

    Email Type: Specifies the type of email (e.g., Work, Home, Custom, Other).

    Custom Type: If "custom" is selected as the type, specify a custom category name.

  3. Phones:

    Users can have multiple phone numbers stored in their profile, including personal and work-related numbers. Each phone entry includes:

    Phone Value: The actual phone number in a human-readable format.

    Type: Specifies the type of phone number (e.g., Assistant, Callback, Car, Company Main, Custom, Grand Central, Home, Mobile, Work, Other).

    Primary: Indicates if this is the user's primary phone number. A user may have only one primary number.

    Custom Type: If "custom" is selected as the type, specify a custom category name.

Personal Account:

  1. Archived: Specify whether the user account should be archived.
  2. Change Password at Next Login: Indicate if the user must reset their password upon their next login.
  3. Suspended: Set the account as suspended if the user is temporarily not active.
  4. Employee Information: Building Id: Input the ID of the building where the employee works.
  5. Cost Center: Assign a cost center for departmental or financial tracking.
  6. Department: Specify the user's department within the organization.
  7. Manager’s Email: Include the email address of the user’s manager for organizational hierarchy.
  8. Employee Id: Enter the user's unique employee identification number.
  9. Floor Name: Provide the name of the floor the user works on.
  10. Floor Section: Further specify the section or area of the floor.
  11. Job Title: Enter the user's job position or title.
  12. Type of Employee: Indicate the type of employment (e.g., full-time, part-time, contractor).

Other:

  1. Custom Schema:

    Allows for the addition of custom fields specific to your organization's needs.

    Erase Current Custom Schema (Checkbox): If enabled, removes the existing custom schema data.

    Schema Name: Defines the name of the schema that holds custom attributes.

    Custom Fields: Each schema consists of key-value pairs, where the key is the schemaName and its values are fieldName: field_value. The maximum allowed data size is 32 KB.

  2. Relations:

    Specifies relationships the user has with other people.

    Related Person’s Email: The email address of the related person.

    Type: Specifies the type of relation (e.g., manager, spouse, child, parent).

    Custom Type: If a custom type is selected, specify a custom category name.

  3. Include in Global Address List: Choose whether to include the user in the organization’s global address list.

  4. IP Whitelisted: Indicate if the user’s IP address is whitelisted for security purposes.

  5. Keywords:

    Defines keywords associated with the user for searchability.

    Keyword Value: The keyword assigned to the user.

    Type: Defines the type of keyword. Acceptable values include:

    Mission, Occupation, Outlook, Custom (if selected, a Custom Type must be specified)

    Custom Type: If "custom" is selected as the type, specify a custom category name.

  6. Languages:

    Specifies the user’s preferred languages for communication.

    Language Code: The ISO 639 string representation of the language. If set, Custom Language cannot be used. Invalid values may cause schema errors.

    Custom Language: If a specific language code is not available, enter a custom language name.

  7. Notes: Add any additional notes or details regarding the user.

  8. Parent Org Path: Provide the organizational unit path the user belongs to.

  9. Websites:

    Lists any websites associated with the user (e.g., personal, work-related).

    Website URL: The full URL of the website.

    Type: Defines the type or purpose of the website. Acceptable values include:

    App Install Page, Blog, Custom (if selected, a Custom Type must be specified), FTP, Home, Home Page, Other, Profile, Reservations, Resume, Work

    Primary: Marks this website as the user’s primary site.

    Custom Type: If "custom" is selected as the type, specify a custom category name.

Recovery Information:

  1. Recvery Email: Set an email address to recover the account if the user forgets their password.
  2. Recovery Phone: Specify a phone number for account recovery purposes.

Each of these optional fields allows for more detailed and personalized user profiles, enhancing how users are managed within your organization.