Changelog: API REST

Il server MCP su https://api.emailit.com/mcp ora copre tutto ciò che offre l’API v2:

• Nuovi toolset: campagne, automazioni, moduli, report DMARC, verifica email, eventi, azioni di massa ed esportazione dei contatti, iscritti, e test, nuovi tentativi e rotazione del secret dei webhook. Vedi il riferimento degli strumenti.
• Annotazioni: ogni strumento è contrassegnato come di sola lettura, distruttivo, idempotente o open-world, così i client possono chiedere conferma prima di eseguire azioni di scrittura.
• Risultati strutturati: gli strumenti restituiscono JSON sia come testo sia come contenuto strutturato per i client che lo analizzano.
• Istruzioni integrate: il server chiede agli assistenti di confermare i destinatari prima di inviare e di chiedere prima di eliminare qualsiasi cosa.
• Toolset e modalità di sola lettura: carica meno strumenti con ?toolsets= o nascondi gli strumenti di scrittura con ?read_only=true. Vedi Toolset e modalità di sola lettura.
• Trasporto stateless: nessuna sessione MCP che scade; i client inviano ogni richiesta con POST.

Corretto: le connessioni OAuth approvate con entrambi i permessi sending e full ora funzionano con tutti gli strumenti, e il workspace a cui passi resta selezionato dopo che il client aggiorna il token.

• Le chiavi API create prima che le chiavi avessero il prefisso secret_ vengono di nuovo accettate su /v2.
• Recupera un’email restituisce l’oggetto email completo, compresi object, from e to.
• Le risposte dei domini restituiscono track_loads e track_clicks come 0 o 1, come documentato.

Apri Email API → Logs per vedere le richieste riuscite e non riuscite, dall’ultima ora fino agli ultimi 30 giorni. Filtra per origine (API o SMTP), esito, metodo, percorso, codice di stato, durata o chiave API, e apri una richiesta per vederne i corpi di richiesta e di risposta. I valori sensibili vengono oscurati e i corpi lunghi vengono accorciati.

Vedi Log delle richieste.

Nel pannello, usa Filters per combinare le condizioni con Match all o Match any, fai clic sulle intestazioni delle colonne per ordinare e scegli le colonne in Display options.

Nell’API, filtra con parametri di query field.condition=value, combinali con match=all o match=or e ordina con order e direction:

curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Ogni endpoint di elenco documenta i propri campi filtrabili. Vedi Filtri e ordinamento.

• Contatti: crea, elenca, recupera, aggiorna ed elimina i contatti. Cerca un contatto tramite il suo ID con_ o l’indirizzo email e aggiungilo alle liste nella stessa chiamata.
• Eventi: elenca gli eventi, filtrati per uno o più tipi e facoltativamente con i relativi dati, e recupera un singolo evento.
• Webhook: crea, elenca, recupera, aggiorna ed elimina gli endpoint webhook.

Questi endpoint richiedono una chiave con accesso completo. Vedi il riferimento API.

Gli ID sono univoci tra i servizi e si ordinano per data di creazione. I prefissi più comuni sono em_ per le email, dom_ per i domini, key_ per le chiavi API, aud_ per le liste, sub_ per gli iscritti, con_ per i contatti, sup_ per le soppressioni, wh_ per i webhook, evt_ per gli eventi e cmp_ per le campagne.

Memorizza gli ID come stringhe opache invece di analizzarli.

Le nuove funzioni vengono rilasciate solo nell’API v2, all’indirizzo https://api.emailit.com/v2. Se chiami ancora /v1, passa agli endpoint v2 e invia la chiave API nell’header Authorization: Bearer.

Vedi Versionamento.

Le chiavi API sostituiscono le credenziali. Una chiave ha il permesso full o sending, una chiave di solo invio può essere limitata a un solo dominio di invio e puoi gestire le chiavi tramite l’API. L’API v1 è rimasta disponibile durante la migrazione.

Vedi il riferimento API.