> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Módulo Users

> Invita usuarios a la app mediante base44.users.

<Warning>
  Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la [documentación para desarrolladores](/developers).
</Warning>

# Módulo Users

Invita usuarios a la app mediante `base44.users`.

## Contenido

* [Métodos](#methods)
* [Ejemplos](#examples) (Invitar usuario)
* [Roles](#roles)
* [Notas](#notes)

## Métodos

| Método                         | Firma          | Descripción                  |
| ------------------------------ | -------------- | ---------------------------- |
| `inviteUser(user_email, role)` | `Promise<any>` | Invita a un usuario a la app |

## Ejemplos

### Invitar usuario

```javascript theme={null}
// Invitar a un usuario con rol "user"
await base44.users.inviteUser("newuser@example.com", "user");

// Invitar a un administrador
await base44.users.inviteUser("admin@example.com", "admin");
```

### Invitar varios usuarios

```javascript theme={null}
const usersToInvite = [
  { email: "user1@example.com", role: "user" },
  { email: "user2@example.com", role: "user" },
  { email: "manager@example.com", role: "admin" }
];

for (const user of usersToInvite) {
  await base44.users.inviteUser(user.email, user.role);
  console.log(`Invited ${user.email} as ${user.role}`);
}
```

## Roles

El parámetro `role` debe ser uno de:

| Rol       | Descripción                                   |
| --------- | --------------------------------------------- |
| `"user"`  | Usuario estándar con permisos predeterminados |
| `"admin"` | Administrador con permisos elevados           |

**Nota:** Solo `"user"` y `"admin"` son valores de rol válidos. Se lanzará un error si pasas cualquier otro valor.

## Notas

* **Invitación por correo**: El usuario invitado recibe un correo con un enlace para unirse a la app
* **Manejo de duplicados**: Invitar a un usuario existente reenviará la invitación
* **También disponible en auth**: `base44.auth.inviteUser()` proporciona la misma funcionalidad
* **Validación de rol**: Solo se aceptan `"user"` o `"admin"`

```javascript theme={null}
// Estos son equivalentes:
await base44.users.inviteUser("newuser@example.com", "user");
await base44.auth.inviteUser("newuser@example.com", "user");
```

## Definiciones de tipos

```typescript theme={null}
/** Módulo Users para invitar usuarios a la app. */
interface UsersModule {
  /**
   * Invita a un usuario a la aplicación.
   * @param user_email - Dirección de correo del usuario.
   * @param role - Rol del usuario ('user' o 'admin').
   * @returns Promesa que resuelve cuando se envía la invitación.
   * @throws Error si el rol no es 'user' o 'admin'.
   */
  inviteUser(user_email: string, role: "user" | "admin"): Promise<any>;
}
```

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>
