Envoyer un e-mail

Vue d'ensemble

Générez des clés dans Compte → Domaines → votre domaine → API après la vérification DNS. Le secret complet est affiché une fois — conservez-le en sécurité. Les identifiants SMTP optionnels dans le même panneau Domaines suivent les mêmes règles transactionnelles uniquement.

E-mail transactionnel uniquement

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.

Utilisations autorisées

• Vérification de compte, réinitialisation de mot de passe et alertes de sécurité
• Confirmations de commande, reçus, mises à jour d'expédition et avis de paiement
• Notifications déclenchées par un événement utilisateur ou système spécifique
• Messages d'équipe et d'espace de travail (invitations, affectations, alertes internes)

Utilisations interdites

• Newsletters, campagnes promotionnelles ou marketing diffusé
• Prospection à froid ou envoi à des listes achetées, scrapées ou non consentantes
• Spam d'affiliation, hameçonnage ou contenu trompeur
• Toute tentative de contourner les plafonds de destinataires, les limites de débit ou les quotas de forfait

Limites de débit et de destinataires

Pour protéger les destinataires et la délivrabilité, le trafic sortant de l'API et SMTP est soumis aux limites ci-dessous (en plus du quota mensuel sortant de votre forfait). L'application est en vigueur sur le compositeur web, l'API HTTP et la soumission SMTP. Le compositeur web avertit après 25 destinataires par message et bloque les envois au-delà de 50.

Ces règles font partie de notre politique d'utilisation acceptable. L'application automatisée est en vigueur sur le compositeur web, l'API HTTP et la soumission SMTP. Les comptes qui envoient des courriers marketing ou en masse, ou qui abusent de l'infrastructure d'envoi, peuvent être limités, suspendus ou résiliés.

Nous surveillons les signaux de délivrabilité. Des taux de rebond soutenus supérieurs à 3 % ou des taux de plainte supérieurs à 0,1 % peuvent déclencher une pause temporaire des envois ou une révision manuelle.

Consultez nos Conditions d'utilisation, notre Politique de confidentialité et notre Déclaration RGPD pour tous les détails de la politique.

Authentification

Envoyez votre clé API de domaine sur chaque requête :

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Alternativement, utilisez X-Api-Key: ubk_live_…. Les clés sont stockées hachées ; révoquez ou renouvelez depuis le tableau de bord des domaines.

Corps de la requête

JSON avec des noms de champs en PascalCase (From, To, …). Les alias camelCase sont également acceptés.

Exemple

{
  "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"
}

Réponse de succès

HTTP 200 avec JSON :

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

Réponses d'erreur

Les erreurs renvoient 4xx (ou 500 pour les échecs inattendus) avec JSON :

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

Exemples

Remplacez you@yourdomain.com par votre boîte aux lettres personnelle sur le domaine et utilisez votre propre clé 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"
}'