Enviar con el SDK

El SDK mailingcore-js envia emails transaccionales desde JavaScript o TypeScript. Es browser-safe, sin dependencias y pesa menos de 1 KB gzip.

Instalacion

npm install mailingcore-js

Configuracion

import { MailingCore } from 'mailingcore-js'

MailingCore.init({
  apiKey: process.env.MAILINGCORE_API_KEY!,
  baseUrl: 'https://api.mailingcore.com', // opcional
  timeout: 30000, // opcional, ms
})

Enviar un email

const result = await MailingCore.send({
  to: '[email protected]',
  subject: 'Bienvenido',
  htmlBody: '<h1>Hola</h1>',
  textBody: 'Hola',
  fromEmail: '[email protected]',
  idempotencyKey: crypto.randomUUID(),
  templateVersionId: 'clxversion...', // opcional
})

console.log(result.id)      // id del log
console.log(result.status)  // "QUEUED"

Next.js (Server Action)

'use server'
import { MailingCore } from 'mailingcore-js'

MailingCore.init({ apiKey: process.env.MAILINGCORE_API_KEY! })

export async function sendWelcome(email: string, name: string) {
  return MailingCore.send({
    to: email,
    subject: 'Bienvenido',
    htmlBody: `<h1>Hola, ${name}</h1>`,
  })
}

Errores

import { MailingCore, MailingCoreError } from 'mailingcore-js'

try {
  await MailingCore.send({ ... })
} catch (err) {
  if (err instanceof MailingCoreError) {
    console.error(err.status, err.detail)
  }
}

Logs

const { data, meta } = await MailingCore.getLogs({ page: 1, limit: 20 })

Requiere scope email:read en la API key subyacente.

La API key identifica el tenant automaticamente; no necesitas enviar X-Tenant-Id cuando usas solo Bearer mc_live_ / mc_test_.

Referencia REST equivalente: Enviar email.