Vai al contenuto
Docs

Avvio rapido

Invia la prima email con l’API

Verifica un dominio, crea una chiave API e invia la prima email con cURL o con un SDK ufficiale per Node.js, Python, PHP, Ruby, Go, Java, .NET o Rust.

Aggiornato il 1 ott 2026

Con questo avvio rapido passi da un account nuovo a un’email consegnata in circa cinque minuti, più il tempo che serve al tuo provider DNS per pubblicare i record. Verificherai un dominio, creerai una chiave API, invierai un’email e la ritroverai nel pannello.

Prima di iniziare

  • Un account Emailit. Registrati su dash.emailit.com.
  • Un dominio a cui puoi aggiungere record DNS, come acme.com. Puoi usare anche un sottodominio, come mail.acme.com.

Aggiungi e verifica il dominio

Emailit invia solo dai domini che hai verificato, così i server di posta dei destinatari possono controllare che l’email provenga davvero da te.

  1. Aggiungi il dominio. Vai a Email APIDomains, seleziona Add domain, inserisci acme.com e seleziona Create.

  2. Pubblica i record DNS. La pagina del dominio elenca i record da aggiungere presso il tuo provider DNS. Copia i valori esatti da quella pagina. I tre record obbligatori hanno questo aspetto:

    Tipo Nome Valore
    TXT emailit._domainkey.acme.com v=DKIM1; t=s; h=sha256; p=… (la tua chiave)
    TXT emailit.acme.com v=spf1 include:_spf.emailit.com ~all
    MX emailit.acme.com, priorità 10 feedback-smtp.ffdc-1.emailit.com

    Se i tuoi DNS sono su Cloudflare, puoi invece pubblicare i record con un clic. Vedi Cloudflare.

  3. Controlla i DNS. Seleziona Check DNS. Quando SPF, DKIM e Return Path mostrano OK, il dominio risulta Verified. La maggior parte dei provider pubblica i record in pochi minuti, ma possono servire fino a 48 ore.

Con Pay as you go, un dominio registrato da meno di 30 giorni mostra Pending verification finché il team di Emailit non lo esamina. Per i dettagli e i record facoltativi per DMARC, tracciamento ed email in entrata, vedi Aggiungi un dominio.

Crea una chiave API

  1. Apri le chiavi API. Vai a Email APIAPI Keys e seleziona Add API key.

  2. Dai un nome alla chiave e scegli un permesso. Inserisci un nome come Quickstart. Sending Only può solo inviare email. Full Access può chiamare anche il resto dell’API. Per questo avvio rapido va bene l’uno o l’altro.

  3. Copia la chiave. Seleziona Create e copia la chiave. Inizia con secret_ e viene mostrata una sola volta.

  4. Salvala in una variabile d’ambiente, così resta fuori dal codice:

    Terminal
    export EMAILIT_API_KEY="secret_••••"

Invia un’email

Installa l’SDK per il tuo linguaggio, oppure usa cURL:

Terminal
# cURL is preinstalled on macOS, Linux and Windows 10 or later
curl --version

Poi invia un’email. Usa un indirizzo From del dominio che hai verificato e inviala all’indirizzo email con cui ti sei registrato:

Terminal
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Hello from Emailit",
    "html": "<p>This is my first email sent with Emailit.</p>"
  }'

Leggi la risposta

Una richiesta riuscita restituisce 200 con la nuova email:

JSON
{
  "object": "email",
  "id": "em_2pX7cN4kQ9vLm3RtB8yWd1Zs",
  "token": "2pX7cN4m8FqT1vKz6RbL3HwYd",
  "message_id": "<2pX7cN4m8FqT1vKz6RbL3HwYd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Hello from Emailit",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418Z",
  "tracking": { "loads": false, "clicks": false }
}
Campo Significato
id L’ID dell’email. Usalo per cercare l’email, annullarla o ritentarla, e per associare gli eventi webhook.
status accepted significa che Emailit ha messo in coda l’email per la consegna. È scheduled se hai impostato scheduled_at.
message_id L’header Message-ID dell’email.
ids Presente solo con più destinatari. Associa ogni indirizzo destinatario al proprio ID email.
tracking Indica se per questa email vengono tracciati aperture (loads) e clic. Il tracciamento richiede un sottodominio di tracciamento verificato.

accepted non significa ancora consegnata. La consegna avviene in background, e lo stato cambia man mano che procede.

Controllala nel pannello

Vai a Email APIEmails. L’email è in cima alla scheda Outgoing. Di solito, in pochi secondi il suo stato passa da accepted a delivered. Aprila per vedere gli header, il contenuto, ogni tentativo di consegna con la risposta del server ricevente e i risultati dei controlli antispam.

La richiesta stessa compare in Email APILogs, con il codice di stato e i corpi della richiesta e della risposta.

Risoluzione dei problemi

Risposta Causa Soluzione
401 API key required o Invalid API key L’header Authorization manca o la chiave è errata Invia Authorization: Bearer secret_… con una chiave valida
403 unverified_workspace_recipient Il workspace è in modalità sandbox Invia all’indirizzo email dell’account di un membro del workspace, oppure richiedi l’accesso alla produzione
422 From/Sender domain is not valid or not verified Il dominio From non è verificato in questo workspace Verifica il dominio, oppure usa un indirizzo di un dominio verificato
403 Domain not authorized La chiave di solo invio è limitata a un dominio diverso Usa una chiave per questo dominio, oppure una chiave senza limitazioni
402 Insufficient credits Il workspace non ha abbastanza crediti Aggiungi crediti
429 Rate limit exceeded Troppe email in questo secondo o in questo giorno Attendi il tempo indicato in retry-after. Vedi Limiti di frequenza.

Passaggi successivi

Ricevi in tempo reale gli eventi di consegna, bounce e apertura.
Progetta una volta nel pannello e invia per alias con variabili.
Ritenta le richieste in sicurezza senza inviare due volte.
Cosa controllare prima di inviare a destinatari reali.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.