Enviar un correo con un documento adjunto

Función sendEmail: destinatarios, asunto, cuerpo y adjuntos (documento, archivo subido o base64) con el correo del programa.

  • API versión 3
  • Plan Profesional, con la API activada
En esta página5 secciones
  1. Antes de empezar
  2. Enviar el correo
  3. Respuesta
  4. Errores
  5. Comprueba el resultado

Antes de empezar

Enviar el correo

POST/api/3/sendEmail

A diferencia del resto de la API, el cuerpo va en JSON. El correo sale con la cuenta configurada en el programa y queda registrado en su historial de envíos.

Parámetros

to string | string[] Obligatorio
Uno o varios destinatarios.
subject string Obligatorio
Asunto.
body string Obligatorio
Texto del mensaje.
cc · bcc string | string[] Opcional
Copia y copia oculta.
replyTo string Opcional
Dirección de respuesta.
attachments array Opcional
Cada adjunto es un objeto con type: document (modelClassName y modelCode; solo facturas, albaranes, pedidos y presupuestos de cliente o proveedor), attachedFile (idfile de un archivo subido) o base64 (filename y content).
curl -s -X POST "$BEPLY_URL/api/3/sendEmail" \
  -H "X-Auth-Token: $BEPLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "admin@talleresbrisa.example",
    "subject": "Tu factura de enero",
    "body": "Hola, te enviamos la factura del mes. Gracias.",
    "attachments": [
      { "type": "document", "modelClassName": "FacturaCliente", "modelCode": "123" }
    ]
  }'

Respuesta

HTTP 200 con status: success, los destinatarios, los nombres de los adjuntos y la hora de envío.

200 OK
{
  "status": "success",
  "message": "email-sent-successfully",
  "data": {
    "recipients": { … },
    "attachments": ["…pdf"],
    "sent_at": "2026-01-20 10:15:00"
  }
}

Errores

Llegan con status, message y code.

invalid-json-body HTTP 400
El cuerpo no es JSON válido.
to-is-required · subject-is-required · body-is-required HTTP 400
Falta un campo obligatorio.
invalid-email-address: … HTTP 400
Una dirección no es válida (también invalid-cc-… e invalid-bcc-…).
attachment[0]: … HTTP 400
Adjunto mal formado: tipo, modelo o datos que faltan.
method-not-allowed HTTP 405
Usa POST.
EMAIL_NOT_CONFIGURED HTTP 500
El programa no tiene correo saliente configurado: un administrador lo configura en Ajustes › Email. No se ha enviado nada.
SEND_ERROR · email-send-failed HTTP 500
El servidor de correo rechazó el envío: revisa la configuración de Ajustes › Email y las direcciones.

Comprueba el resultado

El destinatario recibe el correo con el PDF de la factura. Cada llamada envía un correo nuevo: no repitas una petición cortada sin comprobar antes con el destinatario.

Actualizado el 6 de noviembre de 2026

Captura ampliada

Abrir en otra pestaña

¿Te ha resultado útil esta página?

¿Aún tienes dudas?

Habla con nuestro equipo y te resolvemos cualquier duda al instante.