---
title: "Enviar Email Documentos"
method: POST
path: "/api/email/documentos"
tags: ["external_services", "email"]
---

# Enviar Email Documentos

`POST /api/email/documentos`

Envía un correo con documentos adjuntos

**🔒 Endpoint Protegido:** Requiere autenticación JWT y rol 'admin'

## Request body

- EmailDocumentosRequest
  - `email_destino` string, email, required
  - `documentos` DocumentoEmail[], required
    - `nombre` string, required
    - `url` string, required
    - `tipo` string, nullable
    - `uuid` string, nullable
    - `tamano` string, nullable
  - `email_alternativo` string, nullable
  - `asunto` string, nullable
  - `cuerpo` string, nullable
  - `remitente` string, nullable

## Response `200`

Successful Response

- EmailResponse
  - `success` boolean, required
  - `message` string, required
  - `destinatario` string, nullable
  - `documentos_enviados` string[], nullable
  - `documentos_fallidos` string[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) · [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hogarsolar/hogarsolar-backend-api/revisions/d9861e46bef8/schema)