3 API
Email, CRM e SMS — un solo account
500 / min
Richieste per account
Hosting in Svizzera
Dal 2001, dati in Svizzera
OAuth 2.0
Bearer, chiave API o OAuth 2.0 (PKCE)

Tre API. Una piattaforma.

Scegliete quella che vi serve — o combinatele tutte e tre. REST e JSON, documentate endpoint per endpoint sul portale sviluppatori.

v2

Email API

Gestite rubriche e modelli, inviate campagne ed email transazionali, seguite le statistiche. JSON o XML.

  • Campagne & email transazionali
  • Stato di consegna di ogni invio singolo
  • Rubriche, modelli, mittenti
  • Statistiche: aperture, clic, paesi, bounce
Vedi la doc Email API →
v3

CRM API

Gestite contatti, campi personalizzati, tag e segmenti — e inviate email & SMS a quei contatti. Webhook e OAuth 2.0 per gli strumenti di terzi.

  • Contatti, liste, tag & segmenti
  • Invio di email e SMS ai contatti
  • Webhook: eventi in tempo reale
  • OAuth 2.0 (PKCE) per Zapier, Make, n8n
Vedi la doc CRM API →
v2

SMS API

Inviate SMS massivi o singoli, in tutto il mondo, direttamente dalla vostra applicazione. Liste di numeri e cronologia incluse.

  • SMS massivi & singoli
  • Copertura internazionale (prefisso 00)
  • Conferme di consegna via webhook (sms.delivered)
  • Programmazione e annullamento
Vedi la doc SMS API →
Per gli sviluppatori

Strumenti moderni, nessuna sorpresa.

Tutto ciò che serve per consegnare le integrazioni rapidamente e gestirle in tutta sicurezza.

REST + JSON

Risorse prevedibili, formati di errore coerenti con identificativo di richiesta, verbi e codici HTTP standard. XML disponibile sulle API Email e SMS.

Tre modalità di autenticazione

Token Bearer (30 giorni, rinnovabile), chiave API, oppure OAuth 2.0 con PKCE e permessi per ambito per le applicazioni di terzi. HTTPS ovunque.

Documentazione OpenAPI in 6 lingue

Ogni endpoint descritto con parametri, risposte ed esempi; provate le chiamate dalla documentazione. Specifica OpenAPI scaricabile per generare il vostro client.

Webhook firmati

Email consegnata, bounce, apertura, clic, contatto creato, SMS consegnato… inviati al vostro URL in JSON, firmati HMAC-SHA256, con nuovi tentativi automatici.

Tracciamento della consegna

Ogni email transazionale restituisce un identificativo; interrogatene lo stato (consegnata, differita, bounce) oppure ricevete l'evento email.delivered.

Limiti di frequenza prevedibili

500 richieste/min per account. Oltre, risposta 429 con header X-RateLimit-* e Retry-After — nessun throttling silenzioso.

Casi d'uso

Dalle email di iscrizione agli SMS internazionali — una sola integrazione.

Che sviluppiate un SaaS, una piattaforma e-commerce o uno strumento interno, le nostre API coprono tutte le esigenze di messaggistica del vostro prodotto.

Email transazionali & marketing

Email di benvenuto, reset della password, ricevute, newsletter e campagne complete — e per ogni invio singolo, la conferma di consegna al server del destinatario.

Sincronizzazione CRM & contatti

Mantenete profili, tag e segmenti sincronizzati con la vostra base prodotto; collegate Zapier, Make o n8n in OAuth 2.0, oppure lasciate che un webhook avvisi il vostro strumento a ogni modifica.

Notifiche SMS in tutto il mondo

Codici a due fattori, avvisi di consegna, promemoria di appuntamenti — inviati in tutto il mondo, con conferma di consegna via webhook.

POST https://vostro-server/webhook · email.delivered
200 OK
X-Mailpro-Signature: t=1758000000,v1=5a72…c8b1
X-Mailpro-Event-Type: email.delivered

{
  "id": "evt_5f2c…",
  "type": "email.delivered",
  "created": 1758000000,
  "apiVersion": "v3",
  "account": { "id": 12345, "name": "La mia azienda" },
  "data": {
    "email": "[email protected]",
    "idSending": 987654,
    "sendingType": 3,
    "diagCode": "250 2.0.0 OK",
    "deliveredAt": "2026-09-16T08:03:41Z"
  }
}

Risorse per sviluppatori

Il riferimento tecnico sul portale, le risposte pratiche nella FAQ, gli esempi su GitHub.

{ }

Portale sviluppatori

La documentazione completa delle API Email, CRM e SMS: endpoint, parametri, risposte, codici di errore, webhook e autenticazione. In italiano e in altre cinque lingue.

?

FAQ API & Webhook

I tre tipi di webhook, il tracciamento della consegna, la verifica della firma, i limiti, Zapier / Make / n8n, SMTP o API… spiegati passo dopo passo.

Esempi su GitHub

Uno «starter» open source (licenza MIT) con esempi di chiamata in Node.js, Python, PHP, C# e Java, da adattare al vostro progetto.

API — domande frequenti

Risposte rapide per gli sviluppatori che integrano Mailpro. I dettagli sono nella FAQ API & Webhook.

Come ottengo una chiave API?+

Accedete al vostro account Mailpro e aprite Impostazioni → Impostazioni API. Vi troverete il vostro identificativo cliente e la vostra chiave API. Potete chiamare le API direttamente con questi dati, scambiarli con un token Bearer tramite POST /v3/token, oppure creare un'applicazione OAuth 2.0 in Impostazioni → Applicazioni OAuth.

Quali metodi di autenticazione sono supportati?+

Tre: il token Bearer (valido 30 giorni, rinnovabile), l'identificativo cliente + chiave API, e OAuth 2.0 con PKCE (consigliato per le applicazioni di terzi e le piattaforme come Zapier, Make e n8n, con permessi per ambito). Uno stesso token funziona sulle API Email, CRM e SMS.

Le API sono REST o SOAP?+

Sono API REST su HTTPS. Le risposte sono in JSON (le API Email e SMS supportano anche XML, tramite l'estensione .json / .xml dell'URL), con risorse prevedibili, verbi HTTP standard e codici di stato.

Esiste una documentazione interattiva o una modalità di test?+

Sì. Il portale sviluppatori descrive ogni endpoint (OpenAPI) e permette di provare le chiamate dalla documentazione. Potete inviare email e SMS di prova al vostro indirizzo prima di passare in produzione.

Quali linguaggi posso usare? Esiste un SDK?+

Qualsiasi linguaggio in grado di parlare HTTP e JSON. Pubblichiamo su GitHub uno starter open source con esempi in Node.js, Python, PHP, C# e Java, e la specifica OpenAPI del portale permette di generare un client nel linguaggio che preferite.

Le API supportano i webhook?+

Sì, in tutti e tre i versi: Mailpro vi avvisa degli eventi (email consegnata, aperta, cliccata, bounce, contatto creato, SMS consegnato…) con chiamate HTTP firmate HMAC-SHA256 e nuovi tentativi; le vostre automazioni possono chiamare uno strumento esterno (azione «Invia un webhook»); e uno strumento esterno può avviare un'automazione (webhook in entrata). I tre tipi di webhook spiegati.

Posso inviare email transazionali e seguirne la consegna?+

Sì. Inviate una singola email a un destinatario con campi personalizzati, allegati e pianificazione opzionale, tramite la Email API o la CRM API. L'invio restituisce un identificativo; GET /v3/Send/{id}/Status vi indica poi se è in coda, inviata, consegnata, differita o in bounce (stato disponibile circa 5 minuti dopo la consegna, conservato 365 giorni). Nel dettaglio.

Posso inviare file allegati? Quali sono i limiti e il costo?+

Sì — allegate file quando inviate un'email tramite laEmail API (v2) o la CRM API (v3): fino a 5 file, 10 MB per file e 15 MB in totale. Inviateli come allegati codificati in Base64 su entrambe le API (la Email API accetta anche il caricamento di file multipart/form-data). Il costo è di 1 credito ogni 500 KB di allegati, con i primi 500 KB inclusi nel credito base dell'email (gli allegati fino a ~500 KB non aggiungono nulla). Sono accettati i formati di documento e immagine più comuni; i file eseguibili e gli script (.exe, .bat, .js, .vbs, .msi, .jar, .dll, ecc.) sono bloccati per motivi di sicurezza.

Come funziona la tariffazione degli SMS?+

Gli SMS si basano sui crediti. Un SMS costa il prezzo in crediti del paese di destinazione moltiplicato per il numero di parti (un messaggio lungo viene suddiviso in più parti). L'invio di email utilizza i crediti email.

Quali formati di indirizzo email sono accettati?+

Qualsiasi indirizzo conforme allo standard RFC, incluso il sub-addressing con «+» (ad esempio [email protected]), supportato da Gmail, Fastmail, Proton e altri.

Quali sono i limiti di frequenza?+

500 richieste al minuto per account. Oltre, ricevete una risposta HTTP 429 con gli header X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After, così da attendere e riprovare correttamente. Le chiamate API dispongono inoltre di una quota di crediti API legata ai vostri crediti email.

Inviate la vostra prima richiesta in pochi minuti.

Create un account Mailpro gratuito, recuperate la chiave API in Impostazioni → Impostazioni API e iniziate a inviare — senza carta di credito.