Saltar al contenido
Docs

Referencia

Las bibliotecas oficiales de Emailit para Node.js, PHP, Laravel, Python, Ruby, Go, Java, .NET y Rust, el paquete MCP y cómo llamar a la API directamente por HTTP.

Actualizado el 1 oct 2026

Emailit mantiene bibliotecas cliente de código abierto para nueve lenguajes y frameworks. Cada una envuelve la API REST con errores tipados y los mismos nombres de recursos que ves en la referencia de la API. Si tu lenguaje no aparece en la lista, sirve cualquier cliente HTTP.

Bibliotecas oficiales

Todas las bibliotecas tienen licencia MIT y se publican desde github.com/emailit.

Lenguaje Paquete Instalación Requisitos Código fuente
Node.js @emailit/node npm install @emailit/node Node.js 18+ emailit-node
PHP emailit/emailit-php composer require emailit/emailit-php PHP 8.1+ emailit-php
Laravel emailit/emailit-laravel composer require emailit/emailit-laravel Laravel 10, 11 o 12 emailit-laravel
Python emailit pip install emailit Python 3.7+ emailit-python
Ruby emailit bundle add emailit Ruby 3.0+ emailit-ruby
Go github.com/emailit/emailit-go/v2 go get github.com/emailit/emailit-go/v2 Go 1.21+ emailit-go
Java com.emailit:emailit-java Maven o Gradle, consulta más abajo Java 11+ emailit-java
.NET Emailit dotnet add package Emailit .NET 8+ emailit-dotnet
Rust emailit cargo add emailit Rust 1.85+ y Tokio emailit-rust

Para Java, añade la dependencia con la última versión que aparece en el repositorio:

pom.xml
<dependency>
  <groupId>com.emailit</groupId>
  <artifactId>emailit-java</artifactId>
  <version>VERSION</version>
</dependency>
build.gradle
implementation 'com.emailit:emailit-java:VERSION'

Enviar un email

Todas las bibliotecas reciben tu clave de API al crear el cliente. Cárgala desde una variable de entorno en lugar de escribirla en el código.

JavaScript
import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
});

console.log(email.id);

El from debe pertenecer a un dominio de envío verificado. Hasta que tu espacio de trabajo tenga acceso de producción, solo puedes enviar a las direcciones de email de las cuentas de los miembros del espacio de trabajo.

Qué cubren las bibliotecas

Todas las bibliotecas exponen los mismos servicios: emails, dominios, claves de API, listas de contactos, suscriptores, plantillas, direcciones bloqueadas, verificaciones de emails, listas de verificación de emails, webhooks, contactos y eventos. Los errores se lanzan como excepciones tipadas o valores de error, por ejemplo un error de autenticación para 401, un error de límite de velocidad para 429 y un error de validación para 422, para que puedas gestionar cada caso por separado.

Algunos endpoints más recientes todavía no están incluidos, como el reenvío de un email, las campañas, las automatizaciones, los formularios y los informes DMARC. Las bibliotecas tampoco envían la cabecera Idempotency-Key. Para esos casos, llama al endpoint por HTTP con la misma clave de API, como se muestra más abajo.

Para la configuración específica de cada framework, incluidos los transportes de correo, las rutas de webhooks y la configuración SMTP, consulta las guías de frameworks: Node.js, Next.js, Nuxt, Laravel, PHP, Python, Ruby on Rails, Go, Java, .NET y WordPress.

Paquete del servidor MCP

El paquete de código abierto @emailit/emailit-mcp ejecuta un servidor MCP en tu equipo para que los asistentes de IA puedan llamar a Emailit con tu clave de API:

Terminal
npx -y @emailit/emailit-mcp

La mayoría no lo necesita: el servidor alojado en https://api.emailit.com/mcp no requiere instalación. Compara los dos en Ejecutar el servidor MCP en local.

@emailit/js es un paquete distinto: es el script del navegador que muestra los formularios de Emailit en tu web, no un cliente de la API.

Usar la API por HTTP

No necesitas una biblioteca. Sirve cualquier cliente HTTP que pueda enviar JSON:

  • URL base: https://api.emailit.com/v2
  • Cabeceras: Authorization: Bearer <your API key> y Content-Type: application/json
  • Cuerpos y respuestas: JSON

Por ejemplo, para reenviar un email con una clave de idempotencia desde Node.js sin el SDK:

JavaScript
const response = await fetch('https://api.emailit.com/v2/emails/em_4K6oASS7KP9ztzWmSN9ndEu13HW/forward', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'forward-order-1042',
  },
  body: JSON.stringify({ to: 'support@acme.com' }),
});

if (!response.ok) {
  throw new Error(`Emailit returned ${response.status}: ${await response.text()}`);
}

Lee Errores y Límites de velocidad antes de crear tu propio cliente, para gestionar correctamente las respuestas 4xx y retry-after. Si tu aplicación ya usa SMTP, también puedes prescindir de la API y usar el SMTP relay.

Bibliotecas de la comunidad

Emailit no mantiene bibliotecas aparte de las de la lista anterior. Si encuentras o creas una para otro lenguaje o framework, revisa su código antes de darle una clave de API, y usa preferiblemente una clave Sending Only limitada a un dominio. Avísanos en support@emailit.com o en Discord si quieres que la mencionemos aquí.

URL base, ID, errores, paginación y límites de velocidad.
Crea la clave que necesita tu biblioteca.
Plantillas, adjuntos, programación y seguimiento.
Verifica que las peticiones de webhook proceden de Emailit.

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.