---
title: "Add New User"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/add-new-user/
description: "This page describes the method to perform operations in the Authentication component."
last_updated: 2026-09-09T10:45:38Z
service: CloudScale
type: general
related_links:
  - name: "Catalyst CloudScale"
    url: /en/cloud-scale/
  - name: "Authentication Help"
    url: /en/cloud-scale/help/authentication/introduction/
  - name: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/authentication/add-new-user/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/authentication/add-new-user/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/authentication/user-signup/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/authentication/user-signup/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/authentication/user-signup/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/authentication/add-new-user/#AddNewUser.
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Add New User

> **Note:** Ensure you have installed the [required package](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/overview/#prerequisites) to use this SDK method.

You can [add end users](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/introduction/) to your Catalyst serverless applications, fetch their details, or manage their accounts easily. When a user has signed up to a Catalyst application, unique identification values like `ZUID` and *User ID* are created for them. The user is also assigned to an organization automatically in this method.

#### Create a JSON Configuration

Before you add a new end-user to your Catalyst application, you must create a JSON object that contains the registration details of a particular user, such as their email address, last name, the application platform and the role they must be added to, as shown below. You can then pass the configuration to the user registration method.

> **Notes:**

* You must provide the values for `email_id` and `first_name`, the mandatory parameters to [register a user](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/implementation/#adding-a-new-user-from-the-console).

* You can obtain the [`role_id`](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/roles/implementation/) from the *Roles* section in Authentication in the Catalyst console.

```javascript
//Create a JSON object for adding a new user
const signupConfig = {
  platform_type: 'web',
  template_details: {
    senders_mail: 'dogogetu@tutuapp.bid',
    subject: 'Welcome to %APP_NAME% ',
    message: '<p>Hello ,</p> <p>Follow this link to join in %APP_NAME% .</p> <p> <a href=\\\'%LINK%\\\'>%LINK%</a> </p> <p>If you did not ask to join the application, you can ignore this email.</p> <p>Thanks,</p> <p>Your %APP_NAME% team</p>'
  },
  redirect_url: 'home.html' // The user will be directed to this page once they are authenticated. You can also provide mapped custom domains you configured as your invite URL.
};
var userConfig = {
  first_name: 'Dannie',
  last_name: 'Boyle',
  email_id: 'p.boyle@zylker.com',
  role_id: '3376000000159024'
};
```

### SDK Method to Add a New User

You can now add a new end-user to your Catalyst application by passing the JSON objects you created in the previous section as arguments to the `registerUser()` SDK method.

The `registerUser()` method handles the user sign-up process and returns a promise. This promise will be resolved to a JSON object.

The `userManagement` reference used in the code snippet below is the [component instance](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/get-component-instance/).

```javascript
// Pass the JSON configuration to the method
const userDetails = await userManagement.registerUser(signupConfig, userConfig);
console.log(userDetails);
```

#### Example of Expected Response

```javascript
{
  "zaid": "1005634498",
  "user_details": {
    "zuid": "1005641290",
    "zaaid": "1005641456",
    "org_id": "1005641456",
    "status": "ACTIVE",
    "is_confirmed": false,
    "email_id": "p.boylie@zylker.com",
    "first_name": "Dannie",
    "last_name": "Boyle",
    "created_time": "Aug 12, 2025 12:33 PM",
    "modified_time": "Aug 12, 2025 12:33 PM",
    "invited_time": "Aug 12, 2025 12:33 PM",
    "role_details": {
      "role_name": "App User",
      "role_id": "2305000000006024"
    },
    "user_type": "App User",
    "user_id": "2305000000007752",
    "project_profiles": []
  },
  "redirect_url": "https://aliencity-66446133.development.catalystserverless.com/app/",
  "platform_type": "web",
  "org_id": null
}
```