---
title: "Add New User"
url: https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/authentication/add-new-user/
description: "This page describes the method to add new end-users to your Java application using Catalyst Authentication with sample code snippets."
last_updated: 2025-11-19T15:07:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Add new user - API"
    url: /en/api/code-reference/cloud-scale/authentication/add-new-user/#AddNewUser
  - name: "Catalyst Authentication"
    url: /en/cloud-scale/help/authentication/introduction
---

# Authentication

Catalyst Authentication features enable you to add end-users to your Catalyst serverless applications, configure their user accounts and roles, and manage user sign-in and authentication of your application. You can learn about working with Catalyst Authentication from the remote console from the
[Authentication help document](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/introduction).

### Add New User

When a user has signed up to a Catalyst application, unique identification values like `ZUID` and
`userID` are created for them. The user is also assigned to an organization by Catalyst. You can
learn more about this from the [Users help
page](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/introduction/).

You can add a new end-user to your Catalyst application using the code below. The user details such as their email
address, last name, the application platform and the role they must be added to, are passed through an instance of the
`ZCSignUpData` class. The user registration process is handled by the
`registerUser()` method, after obtaining an instance of the `ZCUser` class.

> **Note:**

* You will be able to add only 25 users in your application in the
[development environment](https://docs.catalyst.zoho.com/en/deployment-and-billing/environments/development-environment). After you
deploy your application to production, you can include any number of end-users in it.
* You must provide the values for `EmailId` and `FirstName` to register a user
mandatorily.
* You can obtain the `RoleId` from the _Roles_ section in _Authentication_ in the Catalyst console.
* When inviting a new user, you can configure the sender's email address, subject and the email message. You must add the email address in the [Catalyst Mail Component](https://docs.catalyst.zoho.com/en/cloud-scale/help/mail/email-configuration/)
and get it verified before using it in the SDK code.

#### Sample Code Snippet

**Package Imports**

```java
import com.zc.component.users.PlatformType; 
import com.zc.component.users.ZCSignUpData; 
import com.zc.component.users.ZCUser;
import com.zc.component.ZCMailTemplateDetails;

```

```java
//Get an instance of ZCSignUpData
ZCSignUpData signUpdetails = ZCSignUpData.getInstance();
//Pass the necessary data for the sign-up using the instance
ZCMailTemplateDetails mailData= signUpdetails.mailTemplateInstance();
mailData.setSendersMail("docofoh552@lukaat.com");
mailData.setSubject("Welcome to %APP_NAME%");
mailData.setMessage("<p>Hello ,</p> <p>Follow this link to join in %APP_NAME% .</p> <p><a href='\%LINK%\'>%LINK%</a></p> <p>If you didn’t ask to join the application, you can ignore this email.</p> <p>Thanks,</p> <p>Your %APP_NAME% team</p>");
signUpdetails.setTemplateDetails(mailData);
signUpdetails.setPlatformType(PlatformType.WEB);
signUpdetails.userDetail.setEmailId("p.boyle@zylker.com");
signUpdetails.userDetail.setLastName("Boyle");
signUpdetails.userDetail.setRoleId(1256000000228024L);
//Register the user using an instance of ZCUser class
signUpdetails = ZCUser.getInstance().registerUser(signUpdetails);

```