---
title: "Agregar un nuevo usuario a una organización existente"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/authentication/add-user-to-existing-org/
description: "Esta API te permite agregar un nuevo usuario final a una organización existente sin crear una nueva organización para él a través de Catalyst Authentication."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

<!-- Leftcontent -->

# Agregar un nuevo usuario a una organización existente

### Descripción

Esta API te permite agregar un nuevo usuario final a una organización existente sin crear una nueva organización para él. Esto se puede hacer proporcionando el `[**ZAAID**](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/user-management/users/introduction/)` de la organización a la que se debe agregar al usuario. La organización de un usuario no se puede cambiar posteriormente, una vez que se asocia con su cuenta.

Cuando el usuario se ha registrado, se crean valores de identificación únicos como [`ZUID` y `User ID`](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/user-management/users/introduction/) para él.

### Detalles de la solicitud

#### URL de la solicitud
<!-- shortcode 1 -->

`POST` {api-domain}/baas/v1/project/{project_id}/project-user

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### Encabezados de la solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.projects.users.CREATE

#### Propiedades JSON de la solicitud

- **platform_type** (string, mandatory):  Valores aceptados: `web`, `android`, `ios`  

- **redirect_url** (string, optional):  La URL a la que se redirigirá después de que el usuario se registre en la aplicación 
 Tamaño máximo: 200   

- **user_details** (json, mandatory): 
 El JSON que contiene los detalles del usuario 

- 
- **first_name** (string, optional): Nombre del usuario 
 Tamaño máximo: 100 

- 
- **last_name** (string, mandatory): Apellido del usuario 
 Tamaño máximo: 100 

- 
- **email_id** (string, mandatory): Dirección de correo electrónico del usuario 

- 
- **ZAAID** (string, mandatory): Identificación única de la organización a la que pertenece el usuario 

### Detalles de la respuesta

La respuesta contendrá los detalles del usuario agregado en la clave `data`, incluyendo los metadatos y valores de identificación como `zaid`, `user_id` y `org_id` que fueron generados.

<!-- shortcode 1 ends -->

<!-- Rightcontent -->

**Sample Request**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/3000000002001/project-user \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
  -H "Content-Type: application/json" \
  -d '{
	"user_details":{
                "first_name":"John",
		"last_name":"Winchester",
		"email_id":"john.w@zylker.com",
		"zaaid":4567899
	},
    "redirect_url": "https://logistics.zylker.com/app/index.html",
	"platform_type":"web"
}'

```

**Sample Response**

```json

    {
        "status": "success",
        "data": {
            "zaid": 1011481670,
            "user_details": {
                "user_id": 671930400,
                "user_type": "App User",
                "zuid": 3000000006001,
                "zaaid": 1011520995,
                "status": "ACTIVE",
                "is_confirmed": true,
                "email_id": "john.w@zylker.com",
                "first_name": "John",
                "last_name": "Winchester",
                "created_time": "May 13, 2019 09:16 PM",
                "modified_time": "May 13, 2019 09:16 PM",
                "invited_time": "May 13, 2019 09:16 PM",
                "role_id": 3000000005015
            },
            "redirect_url": "https://logistics.zylker.com/app/index.html",
            "platform_type": "web",
            "org_id": 1011520995
            "locale": "us|en_us|America/Los_Angeles"
            "time_zone": "America/Los_Angeles"
        }
    }
```

### SDK Documentation

[Add New User to Existing Org- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/authentication/add-new-user-to-existing-org/)

[Add New User to Existing Org- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/authentication/add-new-user-to-existing-org/)

[Add New User to Existing Org- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/authentication/add-new-user-to-existing-org/)