---
title: "Create User Instance"
url: https://docs.catalyst.zoho.com/en/sdk/flutter/v2/cloud-scale/authentication/create-user-instance/
description: "You can create a new user instance to perform user operations in your Flutter app."
last_updated: 2025-11-19T15:07:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Authentication"
    url: /en/cloud-scale/help/authentication/introduction
  - name: "Users"
    url: /en/cloud-scale/help/authentication/user-management/users/introduction/
  - name: "Add New User - API"
    url: /en/api/code-reference/cloud-scale/authentication/add-new-user/#AddNewUser
---

# Authentication

[Catalyst Authentication](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/introduction) features enable you to manage the user authentication of your Catalyst app, add users, and configure their user accounts.

## Create a New User Instance

You can create a new user instance, and enable the methods defined in this class to access the instance object. This will prevent unnecessary server calls.

You must pass the user's details to the `newUser()` method, as shown in the code syntax below. You must pass the user's email address and first name mandatorily to create the instance successfully.

```bash
ZCatalystUserDelegate newUser({
  required String firstName,
  required String emailId,
  String? lastName,
  ZCatalystRole? role,
})
```

**Parameters**:
* `lastName` (Mandatory): The last name of the new user.
* `email` (Mandatory): Email address of the user to which the [invitation mail](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/implementation/) will be sent. 
* `lastName`: The last name of the new user.
* `role`: The [role](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/roles/introduction/) the user must be assigned to.

A sample code snippet is shown below:

```bash
ZCatalystUserDelegate newUser = ZCatalystApp.getInstance().newUser(
        firstName: 'Patricia',
        emailId: 'p.boyle@zylker.com',
        lastname: 'Boyle',
        role: Admin,
 );
```