Endpoint /emails dell’API v2 ora disponibili

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
• Recupera un’email
• Aggiorna un’email programmata
• Annulla un’email

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 o contatta il nostro team di supporto.