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

# Referencia de SDK de Correo Electrónico

> Envía correos electrónicos transaccionales personalizados con el SDK de InsForge

<CodeGroup>
  ```bash npm theme={null}
  npm install @insforge/sdk@latest
  ```

  ```bash yarn theme={null}
  yarn add @insforge/sdk@latest
  ```

  ```bash pnpm theme={null}
  pnpm add @insforge/sdk@latest
  ```
</CodeGroup>

```javascript theme={null}
import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-app.insforge.app',
  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
});
```

Find the anon key with `npx @insforge/cli secrets get ANON_KEY`, or in the dashboard: click **Install** and open **API Keys**.

## emails.send()

Envía correos electrónicos HTML personalizados a uno o más destinatarios.

### Parámetros

* `to` (string | string\[], required) - Correos electrónicos de destinatarios, máximo 50 destinatarios
* `subject` (string, required) - Línea de asunto del correo electrónico, máximo 500 caracteres
* `html` (string, required) - Contenido HTML del correo electrónico
* `cc` (string | string\[], optional) - Destinatarios CC, máximo 50 destinatarios
* `bcc` (string | string\[], optional) - Destinatarios BCC, máximo 50 destinatarios
* `from` (string, optional) - Nombre personalizado del remitente, máximo 100 caracteres
* `replyTo` (string, optional) - Dirección de correo electrónico de respuesta, debe ser una dirección de correo válida

<Note>
  Cuando [SMTP Personalizado](/core-concepts/messaging/custom-smtp) está habilitado para tu proyecto, el campo `from` se ignora. El nombre del remitente y el correo electrónico siempre se toman de tu configuración SMTP para evitar spoofing a través de tu servidor.
</Note>

### Devoluciones

```typescript theme={null}
{
  data: {} | null,  // Empty object on success
  error: Error | null
}
```

### Ejemplo

```javascript theme={null}
const { data, error } = await insforge.emails.send({
  to: ['user1@example.com', 'user2@example.com'],
  cc: 'manager@example.com',
  from: 'Acme Support Team',
  subject: 'Team Update',
  html: '<h1>Weekly Update</h1><p>Here are this week\'s highlights...</p>',
  replyTo: 'support@example.com'
});

if (error) {
  console.error('Failed to send email:', error.message);
  return;
}

console.log('Email sent successfully');
```