API transactionnelle

Un appel. Un événement applicatif. Un destinataire.

Clé d’idempotence obligatoire, cas d’usage approuvé et template approuvé par défaut.

Envoyer avec un template

Une clé ym_test_ valide toute la requête sans livrer. Une clé ym_live_ n’est créée qu’après revue du workspace et du domaine.

POST /v1/emails

Authorization: Bearer ym_live_…

Idempotency-Key: order-1234

Télécharger la spécification OpenAPI

curl https://api.mail.yodev.fr/v1/emails \
  -H "Authorization: Bearer ym_live_..." \
  -H "Idempotency-Key: order-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "notifications@client.fr" },
    "to": { "email": "alice@example.com" },
    "category": "payment_receipt",
    "content": {
      "templateId": "00000000-0000-0000-0000-000000000000",
      "variables": { "invoiceNumber": "INV-123" }
    },
    "metadata": { "referenceId": "order_123" }
  }'