# Nuovi endpoint API: contatti, eventi e webhook

> Gestisci i contatti, interroga gli eventi e configura i webhook tramite codice con le ultime novità dell’API di Emailit.

2026-02-17 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Abbiamo appena rilasciato tre nuovi gruppi di risorse nell’API v2 di Emailit: **Contatti**, **Eventi** e **Webhook**. Insieme ti danno il pieno controllo, tramite codice, sulla tua rubrica dei contatti, sul monitoraggio degli eventi e sulle integrazioni webhook.

## Contatti

L’API dei contatti ti permette di creare, leggere, aggiornare ed eliminare i contatti del tuo workspace. Ogni contatto contiene un indirizzo email, un nome e campi personalizzati facoltativi, e può essere iscritto a una o più liste con una sola chiamata.

| Endpoint | Descrizione |
| --- | --- |
| [Elenca i contatti](https://emailit.com/docs/api-reference/contacts/list) | Lista paginata di tutti i contatti |
| [Recupera un contatto](https://emailit.com/docs/api-reference/contacts/get) | Recupera un contatto tramite ID o email |
| [Crea un contatto](https://emailit.com/docs/api-reference/contacts/create) | Crea un nuovo contatto e iscrivilo alle liste |
| [Aggiorna un contatto](https://emailit.com/docs/api-reference/contacts/update) | Aggiorna nome, email, campi personalizzati o stato di disiscrizione |
| [Elimina un contatto](https://emailit.com/docs/api-reference/contacts/delete) | Elimina un contatto e tutti gli iscritti associati |

Puoi cercare i contatti tramite il loro ID (`con_xxx`) o l’indirizzo email, così usi l’identificatore che ti è più comodo.

```json
{
  "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: un’email viene consegnata, un contatto viene creato, un dominio viene aggiornato e così via. L’API degli eventi ti dà accesso in sola lettura a questo flusso di attività.

| Endpoint | Descrizione |
| --- | --- |
| [Elenca gli eventi](https://emailit.com/docs/api-reference/events/list) | Elenco paginato con filtro per tipo e payload dei dati facoltativo |
| [Recupera un evento](https://emailit.com/docs/api-reference/events/get) | Recupera un singolo evento con tutti i dati |

Puoi filtrare per uno o più tipi di evento con valori separati da virgola e usare `include_data` per decidere se restituire il payload completo anche negli elenchi.

```
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 verifica un evento. La nuova API dei webhook ti dà il controllo completo: puoi creare, aggiornare, attivare o disattivare ed eliminare gli endpoint webhook, tutto tramite l’API.

| Endpoint | Descrizione |
| --- | --- |
| [Elenca i webhook](https://emailit.com/docs/api-reference/webhooks/list) | Elenco paginato di tutti i webhook |
| [Recupera un webhook](https://emailit.com/docs/api-reference/webhooks/get) | Recupera un webhook tramite ID |
| [Crea un webhook](https://emailit.com/docs/api-reference/webhooks/create) | Crea un nuovo endpoint webhook |
| [Aggiorna un webhook](https://emailit.com/docs/api-reference/webhooks/update) | Aggiorna URL, eventi o stato di attivazione |
| [Elimina un webhook](https://emailit.com/docs/api-reference/webhooks/delete) | Elimina un webhook tramite ID o nome |

Puoi iscriverti a tipi di evento specifici oppure usare `all_events` per ricevere tutto.

```json
{
  "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, liste, iscritti, contatti, template, soppressioni e verifiche email. Trovi l’elenco completo nella documentazione di [Create Webhook](https://emailit.com/docs/api-reference/webhooks/create).

## Inizia subito

Tutte e tre le API richiedono una chiave API con accesso completo. Vai al [riferimento API](https://emailit.com/docs/api-reference/endpoints) per esplorare tutti i nuovi endpoint, oppure passa direttamente alla documentazione collegata qui sopra.

---

Source: https://emailit.com/it/blog/nuovi-endpoint-api-contatti-eventi-webhook/
