--- title: "Agregar nuevo usuario" url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/authentication/add-new-user/ description: "Esta página describe el método para agregar nuevos usuarios finales a tu aplicación Python con fragmentos de código de ejemplo." last_updated: 2026-03-30T08:10:30Z service: Cloud Scale type: general related_links: - name: "Add New User - API" url: /es/api/code-reference/cloud-scale/authentication/add-new-user/#AddNewUser - name: "Authentication Help" url: /es/cloud-scale/help/authentication/introduction - name: "SDK Scopes" url: /es/sdk/python/v1/sdk-scopes --- # Agregar nuevo usuario Puedes agregar usuarios finales a tu aplicación Catalyst y se les asignará automáticamente a una organización predeterminada, si la organización no se especifica explícitamente. Cuando se agrega el usuario, Catalyst genera un [user_ID](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/user-management/users/introduction/#authentication-and-user-basics) y un [ZUID](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/user-management/users/introduction/#authentication-and-user-basics) únicos para ellos. #### Crear un diccionario Antes de agregar un nuevo usuario a la aplicación Catalyst, debes crear un diccionario que contenga los detalles del usuario como el apellido del usuario, el rol que se le debe asignar, su dirección de correo electrónico, la plataforma de la aplicación y los datos ZAID basados en el entorno de trabajo actual. El diccionario que contiene estos detalles se pasará como parámetro al método `register_user()`. > **Note :** * Debes proporcionar los valores para `email_id` y `first_name` para registrar un usuario de manera obligatoria. * Puedes obtener el `role_id` de la sección _Roles_ en _Authentication_ en la consola de Catalyst. * Puedes obtener el ZAID desde la configuración de [Environments](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction) en tu consola de Catalyst. * Al invitar a un nuevo usuario, puedes configurar la dirección de correo electrónico del remitente, el asunto y el mensaje del correo electrónico. Debes agregar la dirección de correo electrónico en el [componente Catalyst Mail](https://docs.catalyst.zoho.com/es/cloud-scale/help/mail/email-configuration/) y verificarla antes de usarla en el código del SDK. ```python #Crear un diccionario signup_config = { "platform_type": "web", "zaid": "81008807534807534", "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>", }, } user_details = { "first_name": "Amelia", "last_name": "Burrows", "role_id": "1008807534", "email_id": "amelia.burrows@zylker.com", } ``` ### Agregar nuevo usuario Después de haber configurado la información necesaria del usuario en el diccionario, puedes proceder a agregar un nuevo usuario a una organización. En este caso, se asignará automáticamente una organización al usuario. El método `register_user()` maneja el proceso de creación del usuario y devuelve una respuesta. Para saber más sobre la instancia de componente `authentication_service` utilizada a continuación, consulta [esta sección](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/authentication/get-component-instance/). > **Note :** Solo podrás agregar 25 usuarios en tu aplicación en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment). Después de desplegar tu aplicación a producción, puedes incluir cualquier número de usuarios finales en ella. **Parámetros utilizados**
Nombre del parámetro Tipo de dato Definición
`signup_config` `Object` Un parámetro **obligatorio**. Almacenará los detalles de registro del usuario, incluyendo la plataforma de la aplicación, ZAID y la información del correo electrónico que se enviará después del registro.
`user_details` `Object` Un parámetro **obligatorio**. Contendrá los detalles de registro del usuario como nombre, apellido, ID de correo electrónico y el ID de la organización a la que se debe agregar el usuario.
```python #Agregar un nuevo usuario authentication_service = app.authentication() response_data = authentication_service.register_user(signup_config, user_details) ``` A continuación se muestra una respuesta de ejemplo: ```json { "zaid":"81008807534807534", "user_details":{ "zuid":"1005641290", "org_id":"1005641456", "status":"ACTIVE", "is_confirmed":false, "email_id":"amelia.burrows@zylker.com", "first_name":"Amelia", "last_name":"Burrows", "created_time":"Aug 12, 2021 12:33 PM", "modified_time":"Aug 12, 2021 12:33 PM", "invited_time":"Aug 12, 2021 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":"1005641456" } ``` > **Info :** Consulta la [tabla de alcances del SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/sdk-scopes) para determinar el nivel de permiso requerido para realizar la operación anterior.