---
title: "Add New User to an Existing Organization"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/add-user-to-org/
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-to-existing-org/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/authentication/add-new-user-to-existing-org/
  - 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-user-to-existing-org/#AddaNewUsertoanExistingOrganization
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Add New User to an Existing Organization

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

> **Notes:**

* You must provide the values for the mandatory parameters, `OrgID`, `email_id` and `first_name`, 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 also add end-users to your application by providing 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.

* 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
};
```

### SDK Method to Add to Existing Org

You can now add a new end-user to an existing organization by passing the JSON objects you created in the previous section as arguments to the `addUserToOrg()` SDK 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 snippet below is the [component instance](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/authentication/get-component-instance/).

```javascript
//Pass the JSON configurations to the method
const addedUser = await userManagement.addUserToOrg(signupConfig, userConfig);
console.log(addedUser);
```

#### Example of Expected Response

```javascript
{
  "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
}
```