Quickstart

Invia la prima email con una API key, via cURL o fetch.

Prima di iniziare

Crea una API key

Dalla dashboard, sezione API Keys. Il token in chiaro si vede solo alla creazione.

Verifica un dominio

Aggiungi un dominio e imposta i record SPF, DKIM, DMARC.

Invia

In test mode o in produzione.

Installa l'SDK

Consigliato: usa l'SDK ufficiale (TypeScript o Python). Puoi comunque chiamare l'API via HTTP.

npm install sending-sdk

Invia un'email

import { Sending } from "sending-sdk";
 
const sending = new Sending({ apiKey: process.env.SENDING_API_KEY! });
 
await sending.emails.send({
  from: "Acme <ciao@tuodominio.dev>",
  to: "sara@acme.io",
  subject: "Benvenuta",
  html: "<h1>Pronti</h1>",
  idempotencyKey: "welcome-sara-001",
});

L'SDK punta di default a https://sending.dev/api/v1; l'apiKey va nell'header Authorization: Bearer.

Passa sempre idempotencyKey nel body (obbligatoria, min 8 caratteri) per evitare invii duplicati in caso di retry. Non esiste un header Idempotency-Key.

Il campo from accetta anche il display name: Nome <a@b.com>. Stesso formato per replyTo.

Introduzione

SDK ufficiali