---
title: "Add User to Existing Org"
url: https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/cloud-scale/authentication/add-new-user-to-existing-org/
description: "This page describes the method to add a new user to the existing organisation in your NodeJS application with sample code snippets."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Add new user to existing org - API"
    url: /en/api/code-reference/cloud-scale/authentication/add-user-to-existing-org/#AddaNewUsertoanExistingOrganization
  - name: "Authentication"
    url: /en/cloud-scale/help/authentication/introduction
---

# Add New User to an Existing Organization

> **Note:** This SDK is currently in deprecation. Migrate to [JavaScript SDK](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/add-user-to-org/) now.

You can add an end-user to an existing organization without creating a new organization for them. This can be done by
providing the [**OrgID**](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/introduction/) of the organization that the user must be added to. The organization of a user cannot be changed later, once it is associated with their account.

When the user has signed up, unique identification values such as [ZUID and User ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/users/introduction/) are created for them.

> ****

* You must provide the values for `OrgID`, `email_id`,
`first_name` mandatorily to add a user to an existing organization.
* You can also add them to a role by providing the `role_id`, which you can obtain 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.

### 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 as shown below. You can then pass the configuration to the user registration method.

```javascript
//Create a JSON object for adding a new user to an existing org 
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 didn’t ask to join the application, you can ignore this email.</p> <p>Thanks,</p> <p>Your %APP_NAME% team</p>'
}}; 
var userConfig = { first_name: 'Amelia', last_name: 'Burrows', email_id: 'emma@zylker.com', org_id: 10014774358 };
```

### Add a New User to Existing Org

You can now add a new end-user to an existing organization using the code below. You must pass the JSON objects you
created in the previous section as arguments to the `addUserToOrg()` method. This 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 is the [component instance](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/cloud-scale/authentication/get-component-instance/) created earlier.

> **** 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.

```javascript
let userManagement = app.userManagement();
let addUserPromise = userManagement.addUserToOrg(signupConfig, userConfig);
//Pass the JSON configurations to the method 
addUserPromise.then(addedUser => 
{ 
//Returns a promise
console.log(addedUser); 
});
```

A sample response that you will receive for each version is shown below:

**Node JS**

```

    {
    zaid: "1005634498",
    user_details: {
    zuid: "1005643749",
    org_id: "10014774358",
    status: "ACTIVE",
    is_confirmed: false,
    email_id: "emma@zylker.com",
    first_name: "Amelia",
    last_name: "Burrows",
    created_time: "Aug 12, 2021 03:56 PM",
    modified_time: "Aug 12, 2021 03:56 PM",
    invited_time: "Aug 12, 2021 03:56 PM",
    role_details: { role_name: "App User", role_id: "2305000000006024" },
    user_type: "App User",
    user_id: "2305000000009002",
    project_profiles: []
    },
    redirect_url: "https://aliencity-66446133.development.catalystserverless.com/app/",
    platform_type: "web",
    org_id: null
    }

    {
    zaid: 1005634498,
    user_details: {
    zuid: 1005643930,
    org_id: "10014774358",
    status: "ACTIVE",
    is_confirmed: false,
    email_id: "emma@zylker.com",
    first_name: "Amelia",
    last_name: "Burrows",
    created_time: "Aug 12, 2021 04:05 PM",
    modified_time: "Aug 12, 2021 04:05 PM",
    invited_time: "Aug 12, 2021 04:05 PM",
    role_details: { role_name: "App User", role_id: 2305000000006024 },
    user_type: "App User",
    user_id: 2305000000009004,
    project_profiles: []
    },
    redirect_url: "https://aliencity-66446133.development.catalystserverless.com/app/",
    platform_type: "web",
    org_id: null
    }

```