# Endpoint /emails dell’API v2 ora disponibili

> Invia, recupera, aggiorna e annulla le email tramite codice con i nuovi endpoint email dell’API v2.

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

Siamo felici di annunciare che **gli endpoint email sono ora disponibili nell’API v2**! Adesso puoi inviare email, recuperarle, aggiornare quelle programmate e annullare quelle in attesa, tutto tramite la nostra potente API REST.

## Nuovi endpoint

### Invio email

```
POST /v2/emails
```

Invia una singola email a uno o più destinatari. L’endpoint di invio supporta:

- **Più destinatari**: invia a un massimo di 50 destinatari (TO, CC e BCC insieme)
- **Template**: usa alias o ID dei template con la sostituzione delle variabili tramite la sintassi `{{variable}}`
- **Allegati**: includi file come contenuto base64 o tramite URL
- **Programmazione**: programma l’invio per il futuro in formato ISO 8601, come timestamp Unix o in linguaggio naturale inglese, ad esempio «tomorrow at 9am»
- **Tracciamento**: sovrascrivi le impostazioni predefinite del dominio per aperture e clic
- **Metadati**: allega coppie chiave-valore personalizzate, che vengono memorizzate e restituite insieme all’email
- **Idempotenza**: evita invii duplicati con l’header `Idempotency-Key`

Quando invii a più indirizzi, ogni destinatario riceve un proprio ID email univoco, così puoi tracciarlo singolarmente.

### Recupero di un’email

```
GET /v2/emails/{id}
```

Recupera informazioni dettagliate su una specifica email, tra cui:

- Stato attuale (in attesa, programmata, inviata, consegnata, rimbalzata, annullata)
- Header e contenuto grezzi dell’email
- Impostazioni di tracciamento
- Metadati personalizzati
- Timestamp di creazione e di aggiornamento

### Aggiornamento di un’email programmata

```
POST /v2/emails/{id}
```

Riprogramma un’email impostata per un invio futuro. Puoi cambiare l’orario programmato purché manchino almeno 3 minuti all’invio.

### Annullamento di un’email

```
POST /v2/emails/{id}/cancel
```

Annulla un’email programmata o in attesa prima che venga inviata. Per le email programmate, l’annullamento va richiesto almeno 3 minuti prima dell’orario di invio previsto.

## Limiti di frequenza

Ogni risposta include gli header dei limiti di frequenza, così puoi monitorare il tuo utilizzo:

- `ratelimit-limit`: numero massimo di richieste al secondo
- `ratelimit-remaining`: richieste rimanenti nel secondo corrente
- `ratelimit-daily-limit`: numero massimo di richieste giornaliere
- `ratelimit-daily-remaining`: richieste giornaliere rimanenti

## Documentazione

È disponibile la documentazione completa, con esempi di codice in Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET e cURL:

- [Invia un’email](https://emailit.com/docs/api-reference/emails/send)
- [Recupera un’email](https://emailit.com/docs/api-reference/emails/get)
- [Aggiorna un’email programmata](https://emailit.com/docs/api-reference/emails/update)
- [Annulla un’email](https://emailit.com/docs/api-reference/emails/cancel)

## In arrivo: API dei template

Stiamo lavorando all’**API dei template**, che ti permetterà di creare, aggiornare e gestire i template email tramite codice. Resta sintonizzato!

## Avviso di deprecazione dell’API v1

**Importante:** l’API v1 è deprecata e smetterà di funzionare alla fine di febbraio 2026. Se usi ancora l’API v1, migra all’API v2 il prima possibile.

Ti serve aiuto con la migrazione? Consulta la [documentazione dell’API v2](https://emailit.com/docs/api-reference) o contatta il nostro team di supporto.

---

Source: https://emailit.com/it/blog/api-v2-emails-endpoints/
