Users

How user accounts are structured and managed within the c.technology platform.

Users represent individual accounts within the c.technology platform who can authenticate, access vehicles, and interact with the system. The platform offers an email-based authentication system without optional OAuth and SAML login capabilities, designed to provide seamless access across web applications, mobile apps, and API integrations.

Users can belong to multiple organizations, giving them control over organizational aspects and vehicles under management.

User and organization access to vehicles may be controlled fine-grained through roles and permissions. See the permissions section for more details.

User structure

Users are structured as follows:

{
    "id": "usr_01jnk61cv5ev1a1ty1136gfwh6",  // Unique user ID in TypeID format.
    "email": "[e-mail]",  // The user's email address, used for login and communication. 
    // An email address is always unique and commonly used for user identification throughout the platform.
    "first_name": "Demo",
    "last_name": "User",
    "address_street": "",
    "address_city": "",
    "address_zip": "",
    "address_country_code": "",
    "profile_picture_id": null,
    "profile_picture_url": "...",
    // Various user settings.
    "primary_locale": "en-US",
    "measurement_units": "METRIC",
    "time_format": "24H",
    // Settings for different applications, stored as JSON blobs for frontend customization.
    "settings_webapp": {
        "main_role": "PRIVATE",
        "selected_theme_id": "com.demoCompany.theme.mcycle",
        "current_organization": "com.demoCompany",
        "professional_sidebar_filter_vehicles": {
            "show_own_vehicles": true,
            "show_client_vehicles": true
        }
    },
    "settings_nativeapp": {
        "theme": "io.ctechnology.theme.light"
    },
    // Notification and outreach preferences.
    "may_use_email_for_marketing": false,
    "notification_new_message": true,
    "notification_new_news_article": true,
    "ecosystem_timestamp_last_news_read": "2025-08-28T09:00:22.117Z"
}

A user can belong to a “primary organization” that influences their default experience throughout the platform. Commonly, this is a vehicle manufacturer, but it may also be a dealership, fleet operator, or other organization.

Data privacy and compliance

In accordance with various data protection regulations, users have control over their personal data and privacy settings. This includes options to manage email preferences, data sharing consents, and the ability to request data deletion or export.