Invia email

Panoramica

Genera le chiavi in Account → Domini → il tuo dominio → API dopo aver completato la verifica DNS. Il segreto completo viene mostrato una sola volta: conservalo in modo sicuro. Le credenziali SMTP opzionali nello stesso pannello Domini seguono le stesse regole solo transazionali.

Solo email transazionali

Unbox HTTP API (POST /v1/email) and optional SMTP submission are for transactional mail only — messages tied to an account action, purchase, or operational event. They are not a newsletter or marketing broadcast service.

Usi consentiti

• Verifica account, reimpostazione password e avvisi di sicurezza
• Conferme d'ordine, ricevute, aggiornamenti spedizione e notifiche di pagamento
• Notifiche attivate da un evento utente o di sistema specifico
• Messaggi di team e workspace (inviti, assegnazioni, avvisi interni)

Usi vietati

• Newsletter, campagne promozionali o marketing broadcast
• Contatti a freddo o invio a liste acquistate, estratte o senza consenso
• Spam affiliato, phishing o contenuti ingannevoli
• Qualsiasi tentativo di eludere i limiti di destinatari, frequenza o quote del piano

Limiti di frequenza e destinatari

Per proteggere i destinatari e la consegna, il traffico API e SMTP in uscita è soggetto ai limiti seguenti (in aggiunta alla quota mensile del tuo piano). L'applicazione è attiva sul compositore web, sull'API HTTP e sull'invio SMTP. Il compositore web avvisa dopo 25 destinatari per messaggio e blocca gli invii oltre 50.

Queste regole fanno parte della nostra Politica di utilizzo accettabile. L'applicazione automatica è attiva sul compositore web, sull'API HTTP e sull'invio SMTP. Gli account che inviano email di marketing o di massa, o che abusano dell'infrastruttura di invio, potrebbero essere limitati, sospesi o terminati.

Monitoriamo i segnali di consegna. Tassi di rimbalzo superiori al 3% o tassi di reclamo superiori allo 0,1% possono attivare una pausa temporanea degli invii o una revisione manuale.

Consulta i nostri Termini di servizio, l<privacy>Informativa sulla privacy</privacy> e la <gdpr>Dichiarazione GDPR</gdpr> per i dettagli completi della politica.

Autenticazione

Invia la chiave API del tuo dominio in ogni richiesta:

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

In alternativa, usa X-Api-Key: ubk_live_…. Le chiavi sono memorizzate con hash; revoca o ruota dal pannello Domini.

Corpo della richiesta

JSON con nomi di campo in PascalCase (From, To, …). Sono accettati anche alias in camelCase.

Esempio

{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}

Risposta di successo

HTTP 200 con JSON:

{
  "ErrorCode": 0,
  "Message": "OK",
  "MessageID": "0100018…-000000-…",
  "SubmittedAt": "2026-06-23T12:00:00.000Z",
  "To": "user@example.com"
}

Risposte di errore

Gli errori restituiscono 4xx (o 500 per guasti imprevisti) con JSON:

{
  "ErrorCode": 300,
  "Message": "TextBody or HtmlBody is required."
}

Esempi

Sostituisci you@yourdomain.com con la tua casella personale sul dominio e usa la tua chiave API.

curl "https://api.unbox.im/v1/email" \
  -H "Authorization: Bearer ubk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}'