Annunci • 17 FEBBRAIO 2026

Nuovi Endpoint API: Contatti, Eventi e Webhook

Gestisci i contatti, interroga gli eventi e configura i webhook in modo programmatico con le ultime novità dell'API di Emailit.

Abbiamo appena rilasciato tre nuovi gruppi di risorse nell’API v2 di Emailit: Contatti, Eventi e Webhook. Insieme ti offrono il controllo programmatico completo sulla tua rubrica, il monitoraggio degli eventi e le integrazioni webhook.

Contatti

L’API Contatti ti permette di creare, leggere, aggiornare ed eliminare contatti nel tuo workspace. Ogni contatto contiene un indirizzo email, nome opzionale e campi personalizzati, e può essere iscritto a una o più audience con una singola chiamata.

Endpoint	Descrizione
Elenca Contatti	Lista paginata di tutti i contatti
Ottieni Contatto	Recupera un contatto tramite ID o email
Crea Contatto	Crea un nuovo contatto e iscrivilo alle audience
Aggiorna Contatto	Aggiorna nome, email, campi personalizzati o stato di disiscrizione
Elimina Contatto	Elimina un contatto e tutti gli iscritti associati

I contatti possono essere cercati tramite il loro ID (con_xxx) o indirizzo email, così puoi utilizzare l’identificatore più comodo per te.

{
  "email": "mario@esempio.com",
  "first_name": "Mario",
  "last_name": "Rossi",
  "custom_fields": { "company": "Acme" },
  "audiences": ["aud_2BxFg7KNqr5M..."]
}

Eventi

Gli eventi vengono creati automaticamente ogni volta che succede qualcosa nel tuo workspace. Ad esempio, quando un’email viene consegnata, un contatto viene creato, un dominio viene aggiornato, e così via. L’API Eventi ti dà accesso in sola lettura a questo flusso di attività.

Endpoint	Descrizione
Elenca Eventi	Lista paginata con filtro per tipo e payload dati opzionale
Ottieni Evento	Recupera un singolo evento con tutti i dati

Puoi filtrare per uno o più tipi di evento utilizzando valori separati da virgola, e attivare include_data per controllare se il payload completo viene restituito nelle risposte delle liste.

GET /v2/events?type=email.accepted,email.delivered&include_data=true

Webhook

I webhook ti permettono di ricevere callback HTTP in tempo reale ogni volta che si verificano eventi. La nuova API Webhook ti dà il controllo completo. Puoi creare, aggiornare, abilitare/disabilitare ed eliminare endpoint webhook, tutto tramite l’API.

Endpoint	Descrizione
Elenca Webhook	Lista paginata di tutti i webhook
Ottieni Webhook	Recupera un webhook tramite ID
Crea Webhook	Crea un nuovo endpoint webhook
Aggiorna Webhook	Aggiorna URL, eventi o stato di abilitazione
Elimina Webhook	Elimina un webhook tramite ID o nome

Puoi iscriverti a tipi di evento specifici o utilizzare all_events per ricevere tutto.

{
  "name": "Webhook di Produzione",
  "url": "https://esempio.com/webhook",
  "events": ["email.accepted", "email.delivered", "email.bounced"]
}

Sono disponibili oltre 30 tipi di evento per email, domini, audience, iscritti, contatti, template, soppressioni e verifiche email. Consulta l’elenco completo nella documentazione Crea Webhook.

Inizia subito

Tutte e tre le API richiedono una chiave API con permessi completi. Vai alla Documentazione API per esplorare tutti i nuovi endpoint, oppure passa direttamente alla documentazione linkata sopra.