Inviare con l'SDK

L'SDK mailingcore-js invia email transazionali da JavaScript o TypeScript. E browser-safe, senza dipendenze e pesa meno di 1 KB gzip.

Installazione

npm install mailingcore-js

Configurazione

import { MailingCore } from 'mailingcore-js'

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

Inviare un'email

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

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: 'Benvenuto',
    htmlBody: `<h1>Ciao, ${name}</h1>`,
  })
}

Errori

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

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

Log

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

Richiede scope email:read sulla API key sottostante.

Richiede lo scope email:read sulla API key sottostante.

La API key identifica il tenant automaticamente; non serve X-Tenant-Id quando usi solo Bearer mc_live_ / mc_test_.

Riferimento REST equivalente: Inviare email.