API Mailpro – Integra email e SMS nelle vostre app

Q: Come ottengo una chiave API?

Accedi al tuo account Mailpro e apri Impostazioni > Accesso API. Troverai il tuo ID client numerico e la tua chiave API (GUID). Puoi chiamare le API direttamente con questi dati oppure scambiarli per un token OAuth 2.0 / Bearer JWT dall'endpoint del token.

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

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

Tre API. Una piattaforma.

Scegliete quella che vi serve — o combinale tutte e tre. REST basato su JSON, completamente documentato, pronto da integrare.

Email API

Gestite le vostre rubriche, inviate campagne email ed email transazionali e monitorate le vostre statistiche in tempo reale.

→Invio di campagne ed email transazionali
→Gestione delle rubriche
→Statistiche di apertura, clic e per paese
→Monitoraggio dei bounce e delle cancellazioni

Vedete la doc Email API →

CRM API

Gestisci contatti, tag e segmenti — e invia email & SMS a quei contatti. Automatizza i vostri flussi di lavoro CRM.

→Sincronizzazione di contatti e profili
→Gestione di tag e segmenti
→Automazione dei flussi di lavoro
→Integrazione Zapier nativa

Vedete la doc CRM API →

v1.2

SMS API

Inviate SMS massivi e notifiche individuali a livello internazionale, direttamente dalla vostra applicazione.

→SMS massivi e individuali
→Copertura internazionale
→Statistiche di consegna dettagliate
→Personalizzazione dei messaggi

Vedete la doc SMS API →

Per gli sviluppatori

Strumenti moderni, nessuna sorpresa.

Tutto ciò di cui avete bisogno per consegnare integrazioni rapidamente e gestirle in totale sicurezza.

REST + JSON

Risorse prevedibili, formati di errore coerenti, verbi e codici HTTP standard.

OAuth2 e token con scope

Autenticazione sicura, SSL ovunque, rotazione delle chiavi senza interruzioni.

Swagger interattivo

Provate ogni endpoint in diretta dalla documentazione. Auto-generata, sempre aggiornata.

SDK open source

SDK ufficiale su GitHub. Issue, esempi e contributi benvenuti.

Webhook

Eventi in tempo reale per aperture, clic, bounce e consegne — in push, senza polling.

Limiti di rate prevedibili

100 req/min per account. Header chiari, retry graduali, nessun throttling silenzioso.

Casi d'uso

Dalle email di registrazione agli SMS internazionali — un'unica integrazione.

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

Email transazionali e di marketing

Email di benvenuto, reset password, ricevute, newsletter e campagne complete — tutto dalla stessa API.

Sincronizzazione CRM e contatti

Mantenete profili, tag e segmenti sincronizzati con il vostro database di prodotto o qualsiasi strumento via Zapier.

Notifiche SMS in tutto il mondo

Codici 2FA, avvisi di consegna, promemoria appuntamenti — inviati a livello globale con report dettagliati.

POST /webhooks · email.opened

200 OK

{
  "event": "email.opened",
  "message_id": "msg_8Hf2k...",
  "recipient": "[email protected]",
  "campaign_id": "cmp_42",
  "country": "CH",
  "user_agent": "Mozilla/5.0",
  "timestamp": "2026-05-20T09:14:22Z"
}

Portale sviluppatori Mailpro

Tutto ciò che vi serve per integrare, in un unico posto.

{ }

Documentazione

Esplorate la documentazione completa e interattiva delle nostre API Email, CRM e SMS. Testa direttamente tramite Swagger.

Esplorate le API

</>

Esempi di integrazione

Esempi di codice pronti all'uso per accelerare l'integrazione delle nostre API nei vostri progetti.

Vedete gli esempi

SDK GitHub

Trova il nostro SDK su GitHub per integrare rapidamente le API Mailpro nelle vostre applicazioni.

GitHub

API — domande frequenti

Risposte rapide per gli sviluppatori che integrano Mailpro.

Come ottengo una chiave API?+

Accedi al tuo account Mailpro e apri Impostazioni → Accesso API. Troverai il tuo ID client numerico e la tua chiave API (GUID). Puoi chiamare le API direttamente con questi dati oppure scambiarli per un token OAuth 2.0 / Bearer JWT dall'endpoint del token.

Quali metodi di autenticazione sono supportati?+

Tre: OAuth 2.0 con PKCE (consigliato per app di terze parti e piattaforme come Zapier, Make e n8n), Bearer JWT (legacy) e id_client + chiave API. Un unico token OAuth funziona sulle API Email, CRM e SMS.

Le API sono REST o SOAP?+

Sono moderne API REST su HTTPS. Le risposte sono in JSON per impostazione predefinita (le API Email e SMS supportano anche XML), con risorse prevedibili, verbi HTTP standard e codici di stato.

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

Sì. Ogni endpoint può essere provato in tempo reale dalla documentazione interattiva Swagger e puoi inviare email e SMS di prova al tuo indirizzo prima di passare in produzione.

Quali linguaggi e SDK posso usare?+

Qualsiasi linguaggio in grado di parlare HTTP e JSON. Pubblichiamo un SDK ufficiale su GitHub e forniamo esempi pronti all'uso in curl, Node.js, Python, PHP e C#.

Le API supportano i webhook?+

Sì. Iscriviti a eventi in tempo reale — email consegnata, aperta, cliccata, respinta e report di consegna SMS — recapitati come callback HTTP firmati HMAC-SHA256.

Posso inviare email transazionali, non solo campagne?+

Sì. Invia una singola email a un destinatario con campi personalizzati, allegati e pianificazione opzionale, utilizzando la Email API o la CRM API.

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

Sì — allega file quando invii un'email tramite la Email API (v2) o la CRM API (v3): fino a 5 file, 10 MB per file e 15 MB in totale. Inviali come allegati codificati in Base64 su entrambe le API (la Email API accetta anche il caricamento di file in multipart/form-data). Il costo è di 1 credito ogni 500 KB di allegati, con i primi 500 KB inclusi nel credito base dell'email (quindi gli allegati fino a ~500 KB non aggiungono nulla). Sono accettati i formati di documento e immagine più comuni; i file eseguibili e di 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 (rate limit)?+

Le richieste sono soggette a un limite di frequenza per account. Quando superi il limite ricevi una risposta HTTP 429 con header chiari, così puoi rallentare e riprovare in modo corretto.

Inviate la vostra prima richiesta in pochi minuti.

Create un account Mailpro gratuito, ottenete la vostra API key e iniziate a inviare — nessuna carta di credito richiesta.

Ottenete la vostra API key — gratis Leggete la documentazione

Vedete anche: l'autenticazione email (SPF, DKIM, DMARC) · le soluzioni tecniche API · i prezzi di Mailpro

API Email, CRM e SMS — progettate per gli sviluppatori, scelte dai team.