Envoyer un email

Intégrez l'envoi d'emails transactionnels dans votre application en un seul appel API.

POST /api/v1/emails

L'endpoint d'envoi d'emails permet d'envoyer un message à un ou plusieurs destinataires.

Le Payload JSON

Le corps de votre requête doit contenir les propriétés suivantes :

Propriété	Type	Requis	Description
to	String	Oui	L'adresse email du destinataire.
from	String	Oui	L'adresse d'expédition (doit appartenir à un domaine vérifié).
subject	String	Oui	Le sujet de l'email.
body	String	Non*	Le contenu texte brut de l'email (*requis si html est vide).
html	String	Non*	Le contenu HTML de l'email (*requis si body est vide).

Exemples d'utilisation

cURL

curl -X POST https://api.mailflot.com/v1/emails \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "client@example.com",
    "from": "contact@votre-domaine.com",
    "subject": "Bienvenue !",
    "body": "Merci pour votre inscription.",
    "html": "<p>Merci pour votre inscription.</p>"
  }'

Ruby (Net::HTTP)

require 'uri'
require 'net/http'
require 'json'

url = URI("https://api.mailflot.com/v1/emails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer VOTRE_CLE_API"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "to": "client@example.com",
  "from": "contact@votre-domaine.com",
  "subject": "Bienvenue !",
  "html": "<p>Merci pour votre inscription.</p>"
})

response = http.request(request)
puts response.read_body

JavaScript (Node.js / Fetch)

fetch('https://api.mailflot.com/v1/emails', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VOTRE_CLE_API',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: 'client@example.com',
    from: 'contact@votre-domaine.com',
    subject: 'Bienvenue !',
    html: '<p>Merci pour votre inscription.</p>'
  })
})
.then(response => response.json())
.then(data => console.log(data));

Réponses

Succès (200 OK)

{
  "message": "Email en cours d'envoi",
  "id": 123
}

Erreur de validation (422 Unprocessable Entity)

{
  "error": ["L'adresse d'expédition n'appartient pas à un domaine vérifié"]
}

Authentification Webhooks