{"openapi":"3.1.0","info":{"title":"API Sendeo","description":"L'API Sendeo vous permet d'envoyer des emails transactionnels depuis votre site ou votre application,\net de gérer vos contacts, listes, templates, campagnes et webhooks.\n\nC'est une API REST : des URL prévisibles, des corps de requête et de réponse en JSON (UTF-8) et les\ncodes HTTP standard.\n\n| | |\n|---|---|\n| **URL de base** | `https://api.sendeo.io/v1` |\n| **Authentification** | Clé API dans l'en-tête `Authorization: Bearer sk_…` |\n| **Format** | JSON, dates ISO 8601 en UTC |\n\n# Démarrage rapide\n\nTrois étapes suffisent pour envoyer votre premier email.\n\n1. **Vérifiez votre domaine d'envoi** dans *Paramètres › Domaines*, puis déclarez l'adresse\n   d'expédition (par exemple `commandes@boutique.fr`).\n2. **Créez une clé API** dans *Développeurs › Clés API* et gardez-la dans une variable\n   d'environnement :\n\n   ```bash\n   export SENDEO_API_KEY=\"sk_…\"\n   ```\n\n3. **Envoyez un email** :\n\n   ```bash\n   curl https://api.sendeo.io/v1/send \\\n     -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n     -H \"Content-Type: application/json\" \\\n     -d '{\n       \"from\": \"Boutique <commandes@boutique.fr>\",\n       \"to\": [\"client@example.com\"],\n       \"subject\": \"Bienvenue !\",\n       \"html\": \"<p>Merci pour votre inscription.</p>\"\n     }'\n   ```\n\nLa réponse `202 Accepted` arrive immédiatement avec l'identifiant de chaque message ; l'envoi se fait\ndans les secondes qui suivent. Suivez-le avec [`GET /v1/messages/{message_id}`](#tag/emails-transactionnels)\nou recevez ses événements grâce aux [webhooks](#description/webhooks).\n\n# Authentification\n\nChaque requête porte une clé API de votre organisation :\n\n```http\nAuthorization: Bearer sk_7Hk2Lp9vQ3xR7tY1uZ8wA5bC0dE4fG6h\n```\n\n- Les clés se créent et se révoquent dans *Développeurs › Clés API*. Une clé n'est affichée qu'une\n  fois, à sa création.\n- Une clé donne accès à toutes les données de son organisation : gardez-la côté serveur, jamais\n  dans le code d'une page web ou d'une application mobile, ni dans un dépôt de code.\n- Une clé absente, invalide ou révoquée renvoie `401 Unauthorized`.\n- Une clé est créée en lecture seule ou en lecture et écriture. Une clé en lecture seule n'accepte\n  que les requêtes `GET` (sinon `403 Forbidden`) et ne fonctionne pas sur le relais SMTP.\n\n# Serveur MCP\n\nLes offres Premium et Business peuvent connecter un assistant IA à Sendeo avec le protocole MCP, à\nl'adresse `https://api.sendeo.io/mcp` et avec une clé API dans l'en-tête `Authorization`. L'assistant\nconsulte vos données, prépare des brouillons de campagne et envoie des emails unitaires, selon la\npermission de la clé. Une campagne se lance toujours depuis l'application.\n\nAvec Claude Code :\n\n```bash\nclaude mcp add --transport http sendeo https://api.sendeo.io/mcp \\\n  --header \"Authorization: Bearer $SENDEO_API_KEY\"\n```\n\nAvec Cursor, dans `.cursor/mcp.json` :\n\n```json\n{\n  \"mcpServers\": {\n    \"sendeo\": {\n      \"url\": \"https://api.sendeo.io/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer sk_…\" }\n    }\n  }\n}\n```\n\nUne clé en lecture seule ne voit que les outils de lecture. Chaque appel d'outil compte dans la limite\nde débit de la clé. Les descriptions des outils sont rédigées en anglais, la langue que les assistants\nsuivent le plus sûrement ; ils répondent à l'utilisateur dans sa langue.\n\n| Domaine | Lecture | Écriture |\n|---|---|---|\n| Contacts | `list_contacts`, `get_contact` | `create_contact`, `update_contact`, `delete_contact` |\n| Listes | `list_contact_lists` | `create_contact_list`, `update_contact_list`, `delete_contact_list` |\n| Templates | `list_templates`, `get_template` | `create_template`, `update_template` |\n| Campagnes | `list_campaigns`, `get_campaign` | `create_campaign_draft`, `update_campaign_draft` |\n| Statistiques | `get_statistics` | |\n| Emails | | `send_email` |\n\nLes suppressions sont définitives et `send_email` envoie immédiatement : ces outils sont signalés\ncomme destructifs à l'assistant, pour qu'il demande confirmation selon les réglages de son client.\nUn template créé par un assistant s'ouvre dans l'éditeur de code de Sendeo ; le HTML d'un template\nde l'éditeur visuel ne se modifie que dans Sendeo. Un brouillon modifié n'est pas envoyé : le lancement\nreste à faire depuis l'application.\n\n# Skill pour agents IA\n\nLe skill Sendeo indique à un agent IA comment utiliser Sendeo correctement : quel accès choisir, quelles\nactions faire confirmer, comment lire le résultat d'un envoi. C'est un fichier\n[`SKILL.md`](https://api.sendeo.io/v1/skill.md) au format Agent Skills. Il complète le serveur MCP et\nfonctionne aussi sans lui, avec l'API REST. Il ne contient aucune clé : l'agent utilise celle du serveur\nMCP ou la variable `SENDEO_API_KEY`.\n\nAvec Claude Code :\n\n```bash\nmkdir -p ~/.claude/skills/sendeo\ncurl -fsS https://api.sendeo.io/v1/skill.md -o ~/.claude/skills/sendeo/SKILL.md\n```\n\nPour un autre agent compatible, placez ce fichier dans un dossier `sendeo` de son répertoire de skills.\n\n# Erreurs\n\nLes erreurs utilisent les codes HTTP standard et un corps unique, dont le message lisible peut\nêtre affiché tel quel :\n\n```json\n{ \"detail\": \"L'adresse news@inconnu.fr n'est pas une adresse d'expédition validée.\" }\n```\n\n| Code | Signification |\n|---|---|\n| `400` | Requête mal formée (curseur de pagination invalide…) |\n| `401` | Clé API absente, invalide ou révoquée |\n| `403` | Action refusée : expéditeur non validé, organisation suspendue |\n| `404` | Ressource introuvable (ou appartenant à une autre organisation) |\n| `409` | Conflit : contact déjà existant, clé d'idempotence réutilisée avec un autre corps |\n| `422` | Données invalides ; pour une erreur de format, `detail` est la liste des champs en cause |\n| `429` | Trop de requêtes : voir [Limites de débit](#description/limites-de-débit) |\n| `5xx` | Erreur de notre côté : réessayez plus tard, avec la même clé d'idempotence |\n\n# Limites de débit\n\nChaque clé peut faire un nombre de requêtes par minute qui dépend de votre offre :\n\n| Offre | Requêtes par minute et par clé |\n|---|---|\n| Gratuit | 60 |\n| Starter | 300 |\n| Essentiel | 600 |\n| Premium | 1 200 |\n| Business | 3 000 |\n\nChaque réponse indique où vous en êtes :\n\n| En-tête | Description |\n|---|---|\n| `RateLimit-Limit` | Requêtes autorisées par minute |\n| `RateLimit-Remaining` | Requêtes restantes dans la minute en cours |\n| `RateLimit-Reset` | Secondes avant la remise à zéro du compteur |\n\nAu-delà, l'API répond `429 Too Many Requests` avec l'en-tête `Retry-After` (en secondes). Pour envoyer\nle même email à beaucoup de destinataires, regroupez-les : `POST /v1/send` en accepte 50 par requête.\n\n# Idempotence\n\nUn réseau peut couper après l'envoi d'une requête mais avant la réception de la réponse. Pour pouvoir\nréessayer sans risque d'envoyer deux fois le même email ou de créer deux fois la même ressource,\najoutez l'en-tête `Idempotency-Key` à `POST /v1/send` ou à toute création (`POST /v1/contacts`,\n`/v1/lists`, `/v1/templates`, `/v1/campaigns`, `/v1/webhooks`, `/v1/events`, `/v1/validate`), avec\nune valeur propre à l'opération (par exemple le numéro de la commande) :\n\n```http\nIdempotency-Key: commande-4521\n```\n\n- Rejouée avec la même clé pendant **24 heures**, la requête renvoie la réponse de la première, avec\n  l'en-tête `Idempotent-Replayed: true`, sans rien envoyer de plus.\n- Réutilisée avec un corps différent, ou sur une autre route, elle est refusée (`409 Conflict`).\n- Si la première requête a échoué (`4xx`), la clé redevient libre : corrigez et renvoyez.\n\n# Pagination\n\nLes listes sont paginées par curseur. La réponse contient les éléments de la page, le nombre total\nde résultats et le curseur de la page suivante (`null` sur la dernière page) :\n\n```json\n{ \"items\": [ … ], \"total\": 1284, \"next_cursor\": \"MjU=\" }\n```\n\nPassez ce curseur en paramètre `cursor` pour obtenir la page suivante ; `limit` fixe la taille de\npage (100 au plus).\n\n# Personnalisation\n\nLe sujet et le contenu d'un email (ou d'un template) acceptent des variables :\n\n| Variable | Valeur |\n|---|---|\n| `{{ var.numero }}` | Valeur `numero` de `variables`, dans la requête ou propre au destinataire |\n| `{{ contact.first_name }}`, `{{ contact.last_name }}`, `{{ contact.email }}` | Champs du contact, si le destinataire en est un ; sinon `first_name` reprend le `name` donné |\n| `{{ contact.attributes.ville }}` | Champ personnalisé du contact |\n| `{{ org.name }}` | Nom de votre organisation |\n\nUne valeur par défaut évite un trou quand la donnée manque :\n`Bonjour {{ contact.first_name | default('à vous') }}`.\n\n# Webhooks\n\nLes webhooks préviennent votre application en temps réel de ce qui arrive à vos emails. Créez-les\ndans *Développeurs › Webhooks* ou avec [`POST /v1/webhooks`](#tag/webhooks).\n\n## Événements\n\n| Événement | Envoyé quand |\n|---|---|\n| `message.sent` | L'email a quitté nos serveurs |\n| `message.delivered` | La messagerie du destinataire l'a accepté |\n| `message.opened` | Le destinataire l'a ouvert (estimation : certaines messageries ouvrent automatiquement) |\n| `message.clicked` | Un lien suivi a été cliqué |\n| `message.bounced` | L'adresse a refusé l'email (`bounceType` : `Permanent` ou `Transient`) |\n| `message.complained` | Le destinataire l'a signalé comme spam |\n| `message.failed` | L'email n'est pas parti (adresse bloquée, refus définitif) |\n| `contact.unsubscribed` | Le destinataire s'est désinscrit |\n\nLes ouvertures et clics des passerelles de sécurité (scanners de liens) ne sont pas transmis.\n\n## Requête envoyée\n\nSendeo envoie un `POST` en JSON à votre URL :\n\n```json\n{\n  \"id\": \"2f9d8c7b-6a5e-4d3c-9b2a-1f0e9d8c7b6a\",\n  \"type\": \"message.delivered\",\n  \"created_at\": \"2026-10-08T14:32:08Z\",\n  \"data\": {\n    \"message_id\": \"6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70\",\n    \"campaign_id\": null,\n    \"email\": \"client@example.com\",\n    \"subject\": \"Votre commande n° 4521\",\n    \"tags\": [\"commande\"]\n  }\n}\n```\n\nRépondez par un code `2xx` en moins de 10 secondes, puis traitez l'événement de façon asynchrone.\nSans réponse `2xx`, l'événement est renvoyé 7 fois en environ 3 jours (après 1 min, 10 min, 1 h, 4 h,\n12 h, 24 h et 30 h) ; après 3 jours d'échecs consécutifs, le webhook est désactivé. Un même\névénement peut arriver deux fois : utilisez `id` pour ignorer les doublons.\n\n## Vérifier la signature\n\nChaque requête porte l'en-tête `Sendeo-Signature` :\n\n```http\nSendeo-Signature: t=1791470000,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd\n```\n\n`v1` est le HMAC-SHA256, en hexadécimal, de la chaîne `{t}.{corps brut de la requête}` avec le secret\ndu webhook (`whsec_…`, affiché à sa création). Vérifiez-la sur le corps **brut**, avant de le décoder,\net refusez les requêtes de plus de 5 minutes.\n\n**Python**\n\n```python\nimport hashlib\nimport hmac\nimport time\n\n\ndef verify(secret: str, header: str, body: bytes) -> bool:\n    parts = dict(item.split(\"=\", 1) for item in header.split(\",\"))\n    signed = parts[\"t\"].encode() + b\".\" + body\n    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()\n    recent = abs(time.time() - int(parts[\"t\"])) < 300\n    return recent and hmac.compare_digest(expected, parts[\"v1\"])\n```\n\n**Node.js**\n\n```javascript\nimport crypto from 'node:crypto'\n\nexport function verify(secret, header, rawBody) {\n  const parts = Object.fromEntries(header.split(',').map((item) => item.split('=')))\n  const expected = crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex')\n  const recent = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300\n  const valid = parts.v1?.length === expected.length\n  return recent && valid && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))\n}\n```\n\n**PHP**\n\n```php\nfunction verify(string $secret, string $header, string $body): bool {\n    parse_str(str_replace(',', '&', $header), $parts);\n    $expected = hash_hmac('sha256', $parts['t'] . '.' . $body, $secret);\n    $recent = abs(time() - (int) $parts['t']) < 300;\n    return $recent && hash_equals($expected, $parts['v1']);\n}\n```\n","version":"1.0"},"servers":[{"url":"https://api.sendeo.io","description":"Production"}],"paths":{"/v1/send":{"post":{"tags":["Emails transactionnels"],"summary":"Envoyer un email transactionnel","description":"Un message par destinataire (1 à 50), envoyé en arrière-plan : la réponse arrive avant\nl'envoi. Contenu : `template_id`, ou `html` / `text` avec `subject`. Les variables\ns'écrivent `{{ var.nom }}` ; si le destinataire est un contact, `{{ contact.first_name }}`\net ses champs sont aussi disponibles. Une adresse en bounce définitif ou en plainte n'est\npas écrite : son message est renvoyé en `failed`.","operationId":"send","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendRequest"},"example":{"from":"Boutique <commandes@boutique.fr>","to":[{"email":"client@example.com","name":"Jeanne"}],"subject":"Votre commande n° {{ var.numero }}","html":"<p>Bonjour {{ contact.first_name }}, commande de {{ var.total }} validée.</p>","variables":{"numero":"4521","total":"59,90 €"},"tags":["commande"]}}}},"responses":{"202":{"description":"Demande acceptée, traitée en arrière-plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendResponse"},"example":{"messages":[{"id":"6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70","email":"client@example.com","status":"queued","error":null}]}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/send\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Idempotency-Key: commande-4521\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"from\": \"Boutique <commandes@boutique.fr>\",\n    \"to\": [\n      {\n        \"email\": \"client@example.com\",\n        \"name\": \"Jeanne\"\n      }\n    ],\n    \"subject\": \"Votre commande n° {{ var.numero }}\",\n    \"html\": \"<p>Bonjour {{ contact.first_name }}, commande de {{ var.total }} validée.</p>\",\n    \"variables\": {\n      \"numero\": \"4521\",\n      \"total\": \"59,90 €\"\n    },\n    \"tags\": [\n      \"commande\"\n    ]\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/send\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n        \"Idempotency-Key\": \"commande-4521\",\n    },\n    json={\n        \"from\": \"Boutique <commandes@boutique.fr>\",\n        \"to\": [\n            {\n                \"email\": \"client@example.com\",\n                \"name\": \"Jeanne\",\n            },\n        ],\n        \"subject\": \"Votre commande n° {{ var.numero }}\",\n        \"html\": \"<p>Bonjour {{ contact.first_name }}, commande de {{ var.total }} validée.</p>\",\n        \"variables\": {\n            \"numero\": \"4521\",\n            \"total\": \"59,90 €\",\n        },\n        \"tags\": [\n            \"commande\",\n        ],\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/send');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n        'Idempotency-Key: commande-4521',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"from\": \"Boutique <commandes@boutique.fr>\",\n    \"to\": [\n        {\n            \"email\": \"client@example.com\",\n            \"name\": \"Jeanne\"\n        }\n    ],\n    \"subject\": \"Votre commande n° {{ var.numero }}\",\n    \"html\": \"<p>Bonjour {{ contact.first_name }}, commande de {{ var.total }} validée.</p>\",\n    \"variables\": {\n        \"numero\": \"4521\",\n        \"total\": \"59,90 €\"\n    },\n    \"tags\": [\n        \"commande\"\n    ]\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/send', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Idempotency-Key': 'commande-4521',\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"from\": \"Boutique <commandes@boutique.fr>\",\n    \"to\": [\n      {\n        \"email\": \"client@example.com\",\n        \"name\": \"Jeanne\"\n      }\n    ],\n    \"subject\": \"Votre commande n° {{ var.numero }}\",\n    \"html\": \"<p>Bonjour {{ contact.first_name }}, commande de {{ var.total }} validée.</p>\",\n    \"variables\": {\n      \"numero\": \"4521\",\n      \"total\": \"59,90 €\"\n    },\n    \"tags\": [\n      \"commande\"\n    ]\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/messages":{"get":{"tags":["Emails transactionnels"],"summary":"Journal des emails transactionnels (30 jours)","operationId":"list_messages","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Search"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/RecipientStatus"},{"type":"null"}],"title":"Status"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePage"},"example":{"items":[{"id":"6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70","to":"client@example.com","from_email":"commandes@boutique.fr","from_name":"Boutique","subject":"Votre commande n° 4521","status":"delivered","tags":["commande"],"campaign_id":null,"error":null,"created_at":"2026-10-08T14:32:05Z","sent_at":"2026-10-08T14:32:06Z"}],"next_cursor":"MjU=","total":42}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/messages?status=bounced\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/messages?status=bounced\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/messages?status=bounced');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/messages?status=bounced', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/messages/{message_id}":{"get":{"tags":["Emails transactionnels"],"summary":"Statut et événements d'un message","description":"Tout message de l'organisation, transactionnel ou de campagne (identifiant reçu dans\nla réponse de `/v1/send` ou dans un webhook).","operationId":"get_message","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageDetailOut"},"example":{"id":"6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70","to":"client@example.com","from_email":"commandes@boutique.fr","from_name":"Boutique","subject":"Votre commande n° 4521","status":"delivered","tags":["commande"],"campaign_id":null,"error":null,"created_at":"2026-10-08T14:32:05Z","sent_at":"2026-10-08T14:32:06Z","events":[{"type":"queued","occurred_at":"2026-10-08T14:32:05Z","detail":null},{"type":"sent","occurred_at":"2026-10-08T14:32:06Z","detail":null},{"type":"delivered","occurred_at":"2026-10-08T14:32:08Z","detail":null}]}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/messages/6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/messages/6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/messages/6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/messages/6f1c2e4a-3b7d-4c8e-9a10-2b3c4d5e6f70', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/contacts":{"get":{"tags":["Contacts"],"summary":"Lister les contacts","operationId":"list_contacts","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Search"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContactStatus"},{"type":"null"}],"title":"Status"}},{"name":"list_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"List Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactPage"},"example":{"items":[{"id":"0d9b6c1e-52a4-4f0b-8e3a-7c1d2e3f4a5b","email":"jeanne.martin@example.com","first_name":"Jeanne","last_name":"Martin","status":"subscribed","lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"attributes":{"ville":"Lyon"},"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","last_activity_at":null}],"next_cursor":"MjU=","total":1284}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/contacts?limit=100\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/contacts?limit=100\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts?limit=100');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts?limit=100', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"post":{"tags":["Contacts"],"summary":"Créer un contact","operationId":"create_contact","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactCreate"},"example":{"email":"jeanne.martin@example.com","first_name":"Jeanne","last_name":"Martin","list_ids":["5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13"],"attributes":{"ville":"Lyon"}}}}},"responses":{"201":{"description":"Ressource créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactOut"},"example":{"id":"0d9b6c1e-52a4-4f0b-8e3a-7c1d2e3f4a5b","email":"jeanne.martin@example.com","first_name":"Jeanne","last_name":"Martin","status":"subscribed","lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"attributes":{"ville":"Lyon"},"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","last_activity_at":null}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/contacts\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"email\": \"jeanne.martin@example.com\",\n    \"first_name\": \"Jeanne\",\n    \"last_name\": \"Martin\",\n    \"list_ids\": [\n      \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ],\n    \"attributes\": {\n      \"ville\": \"Lyon\"\n    }\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/contacts\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"email\": \"jeanne.martin@example.com\",\n        \"first_name\": \"Jeanne\",\n        \"last_name\": \"Martin\",\n        \"list_ids\": [\n            \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\",\n        ],\n        \"attributes\": {\n            \"ville\": \"Lyon\",\n        },\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"email\": \"jeanne.martin@example.com\",\n    \"first_name\": \"Jeanne\",\n    \"last_name\": \"Martin\",\n    \"list_ids\": [\n        \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ],\n    \"attributes\": {\n        \"ville\": \"Lyon\"\n    }\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"email\": \"jeanne.martin@example.com\",\n    \"first_name\": \"Jeanne\",\n    \"last_name\": \"Martin\",\n    \"list_ids\": [\n      \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ],\n    \"attributes\": {\n      \"ville\": \"Lyon\"\n    }\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/contacts/import":{"post":{"tags":["Contacts"],"summary":"Importer un fichier CSV (asynchrone)","description":"Fichier CSV (50 Mo au plus) dont les colonnes sont reconnues par leur en-tête : `email`\n(obligatoire), `prenom`, `nom`, ou la clé d'un champ personnalisé. Suivez l'avancement avec\n`GET /v1/contacts/imports/{import_id}`.","operationId":"import_contacts","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_contacts"}}},"required":true},"responses":{"202":{"description":"Demande acceptée, traitée en arrière-plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportJobOut"},"example":{"id":"7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918","file_name":"clients.csv","status":"processing","columns":["email","prenom","nom"],"sample_rows":[["jeanne.martin@example.com","Jeanne","Martin"]],"suggested_mapping":{"email":"email","prenom":"first_name","nom":"last_name"},"list_id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","update_existing":true,"total_rows":1284,"processed_rows":0,"created":0,"updated":0,"skipped":0,"risky":0,"errors":[],"created_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"security":[{"HTTPBearer":[]}],"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/contacts/import\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/contacts/import\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts/import');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts/import', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/contacts/imports/{import_id}":{"get":{"tags":["Contacts"],"summary":"Suivre un import","operationId":"get_import","security":[{"HTTPBearer":[]}],"parameters":[{"name":"import_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Import Id"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportJobOut"},"example":{"id":"7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918","file_name":"clients.csv","status":"completed","columns":["email","prenom","nom"],"sample_rows":[["jeanne.martin@example.com","Jeanne","Martin"]],"suggested_mapping":{"email":"email","prenom":"first_name","nom":"last_name"},"list_id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","update_existing":true,"total_rows":1284,"processed_rows":1284,"created":1270,"updated":0,"skipped":0,"risky":0,"errors":[],"created_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/contacts/imports/7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/contacts/imports/7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts/imports/7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts/imports/7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/contacts/{email}":{"get":{"tags":["Contacts"],"summary":"Lire un contact","operationId":"get_contact","security":[{"HTTPBearer":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactOut"},"example":{"id":"0d9b6c1e-52a4-4f0b-8e3a-7c1d2e3f4a5b","email":"jeanne.martin@example.com","first_name":"Jeanne","last_name":"Martin","status":"subscribed","lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"attributes":{"ville":"Lyon"},"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","last_activity_at":null}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"patch":{"tags":["Contacts"],"summary":"Modifier un contact","operationId":"update_contact","security":[{"HTTPBearer":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactUpdate"},"example":{"attributes":{"ville":"Paris"}}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactOut"},"example":{"id":"0d9b6c1e-52a4-4f0b-8e3a-7c1d2e3f4a5b","email":"jeanne.martin@example.com","first_name":"Jeanne","last_name":"Martin","status":"subscribed","lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"attributes":{"ville":"Paris"},"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","last_activity_at":null}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X PATCH \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"attributes\": {\n      \"ville\": \"Paris\"\n    }\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.patch(\n    \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"attributes\": {\n            \"ville\": \"Paris\",\n        },\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'PATCH',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"attributes\": {\n        \"ville\": \"Paris\"\n    }\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com', {\n  method: 'PATCH',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"attributes\": {\n      \"ville\": \"Paris\"\n    }\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"delete":{"tags":["Contacts"],"summary":"Supprimer un contact","operationId":"delete_contact","security":[{"HTTPBearer":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"204":{"description":"Ressource supprimée (pas de contenu).","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X DELETE \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.delete(\n    \"https://api.sendeo.io/v1/contacts/jeanne.martin@example.com\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'DELETE',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/contacts/jeanne.martin@example.com', {\n  method: 'DELETE',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)"}]}},"/v1/lists":{"get":{"tags":["Listes"],"summary":"Lister les listes de contacts","operationId":"list_lists","security":[{"HTTPBearer":[]}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ContactListOut"},"title":"Response List Lists"},"example":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients","description":"Clients ayant passé au moins une commande","contact_count":1284,"created_at":"2026-10-08T14:32:05Z"}]}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/lists\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/lists\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/lists');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/lists', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"post":{"tags":["Listes"],"summary":"Créer une liste","operationId":"create_list","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactListCreate"},"example":{"name":"Clients","description":"Clients ayant passé au moins une commande"}}}},"responses":{"201":{"description":"Ressource créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactListOut"},"example":{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients","description":"Clients ayant passé au moins une commande","contact_count":1284,"created_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/lists\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Clients\",\n    \"description\": \"Clients ayant passé au moins une commande\"\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/lists\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"name\": \"Clients\",\n        \"description\": \"Clients ayant passé au moins une commande\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/lists');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"name\": \"Clients\",\n    \"description\": \"Clients ayant passé au moins une commande\"\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/lists', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"name\": \"Clients\",\n    \"description\": \"Clients ayant passé au moins une commande\"\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/lists/{list_id}":{"patch":{"tags":["Listes"],"summary":"Renommer une liste","operationId":"update_list","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactListUpdate"},"example":{"name":"Clients fidèles"}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactListOut"},"example":{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients fidèles","description":"Clients ayant passé au moins une commande","contact_count":1284,"created_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X PATCH \"https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Clients fidèles\"\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.patch(\n    \"https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"name\": \"Clients fidèles\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'PATCH',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"name\": \"Clients fidèles\"\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13', {\n  method: 'PATCH',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"name\": \"Clients fidèles\"\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"delete":{"tags":["Listes"],"summary":"Supprimer une liste","operationId":"delete_list","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"List Id"}}],"responses":{"204":{"description":"Ressource supprimée (pas de contenu).","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X DELETE \"https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.delete(\n    \"https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'DELETE',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/lists/5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13', {\n  method: 'DELETE',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)"}]}},"/v1/validate":{"post":{"tags":["Validation d'adresses"],"summary":"Valider des adresses","description":"De 1 à 100 adresses, chacune avec un verdict : `valid`, `risky` (jetable, boîte de rôle\ncomme `contact@`, domaine qui accepte tout) ou `invalid` (syntaxe, domaine sans serveur de\nmessagerie, boîte inexistante). Une adresse consomme un crédit de validation du mois.","operationId":"validate","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateRequest"},"example":{"emails":["jeanne.martin@example.com","contact@boutique.fr","paul@boutque.fr"]}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"},"example":{"results":[{"email":"jeanne.martin@example.com","verdict":"valid","reason":"ok"},{"email":"contact@boutique.fr","verdict":"risky","reason":"role"},{"email":"paul@boutque.fr","verdict":"invalid","reason":"no_mx"}],"credits_remaining":1997}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/validate\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"emails\": [\n      \"jeanne.martin@example.com\",\n      \"contact@boutique.fr\",\n      \"paul@boutque.fr\"\n    ]\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/validate\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"emails\": [\n            \"jeanne.martin@example.com\",\n            \"contact@boutique.fr\",\n            \"paul@boutque.fr\",\n        ],\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/validate');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"emails\": [\n        \"jeanne.martin@example.com\",\n        \"contact@boutique.fr\",\n        \"paul@boutque.fr\"\n    ]\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/validate', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"emails\": [\n      \"jeanne.martin@example.com\",\n      \"contact@boutique.fr\",\n      \"paul@boutque.fr\"\n    ]\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/templates":{"get":{"tags":["Templates"],"summary":"Lister les templates","operationId":"list_templates","security":[{"HTTPBearer":[]}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TemplateOut"},"title":"Response List Templates"},"example":[{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Confirmation de commande","category_id":null,"editor":"code","subject":"Commande n° {{ var.numero }} confirmée","preheader":"","html":"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>","created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z"}]}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/templates\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/templates\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/templates');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/templates', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"post":{"tags":["Templates"],"summary":"Créer un template","operationId":"create_template","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTemplateCreate"},"example":{"name":"Confirmation de commande","subject":"Commande n° {{ var.numero }} confirmée","html":"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>"}}}},"responses":{"201":{"description":"Ressource créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateSaved"},"example":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Confirmation de commande","category_id":null,"editor":"code","subject":"Commande n° {{ var.numero }} confirmée","preheader":"","html":"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>","created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","unknown_variables":[]}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/templates\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Confirmation de commande\",\n    \"subject\": \"Commande n° {{ var.numero }} confirmée\",\n    \"html\": \"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>\"\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/templates\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"name\": \"Confirmation de commande\",\n        \"subject\": \"Commande n° {{ var.numero }} confirmée\",\n        \"html\": \"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/templates');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"name\": \"Confirmation de commande\",\n    \"subject\": \"Commande n° {{ var.numero }} confirmée\",\n    \"html\": \"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>\"\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/templates', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"name\": \"Confirmation de commande\",\n    \"subject\": \"Commande n° {{ var.numero }} confirmée\",\n    \"html\": \"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>\"\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/templates/{template_id}":{"get":{"tags":["Templates"],"summary":"Lire un template","operationId":"get_template","security":[{"HTTPBearer":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateOut"},"example":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Confirmation de commande","category_id":null,"editor":"code","subject":"Commande n° {{ var.numero }} confirmée","preheader":"","html":"<html><body><p>Bonjour {{ contact.first_name | default('') }},</p></body></html>","created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"patch":{"tags":["Templates"],"summary":"Modifier un template","operationId":"update_template","security":[{"HTTPBearer":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTemplateUpdate"}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateSaved"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X PATCH \"https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.patch(\n    \"https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'PATCH',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/templates/0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11', {\n  method: 'PATCH',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/campaigns":{"get":{"tags":["Campagnes"],"summary":"Lister les campagnes","operationId":"list_campaigns","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Search"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CampaignStatus"},{"type":"null"}],"title":"Status"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPage"},"example":{"items":[{"id":"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d","name":"Soldes d'hiver","subject":"Jusqu'à -50 % ce week-end","preheader":"","from_name":"Boutique","from_email":"news@boutique.fr","reply_to":null,"template":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Soldes"},"lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"segments":[],"recipient_count":1284,"status":"scheduled","tracking_enabled":true,"ab_test":null,"scheduled_at":"2026-12-01T08:00:00Z","sent_at":null,"finished_at":null,"error":null,"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","stats":{"recipients":1284,"sent":1280,"delivered":1262,"opened":611,"clicked":148,"bounced":18,"complained":1,"unsubscribed":6,"failed":4,"queued":0}}],"next_cursor":"MjU=","total":37}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/campaigns?status=sent\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/campaigns?status=sent\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/campaigns?status=sent');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/campaigns?status=sent', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"post":{"tags":["Campagnes"],"summary":"Créer une campagne (brouillon)","operationId":"create_campaign","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignCreate"},"example":{"name":"Soldes d'hiver","subject":"Jusqu'à -50 % ce week-end","from_name":"Boutique","from_email":"news@boutique.fr","template_id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","list_ids":["5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13"]}}}},"responses":{"201":{"description":"Ressource créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOut"},"example":{"id":"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d","name":"Soldes d'hiver","subject":"Jusqu'à -50 % ce week-end","preheader":"","from_name":"Boutique","from_email":"news@boutique.fr","reply_to":null,"template":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Soldes"},"lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"segments":[],"recipient_count":1284,"status":"draft","tracking_enabled":true,"ab_test":null,"scheduled_at":null,"sent_at":null,"finished_at":null,"error":null,"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","stats":{"recipients":1284,"sent":1280,"delivered":1262,"opened":611,"clicked":148,"bounced":18,"complained":1,"unsubscribed":6,"failed":4,"queued":0}}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/campaigns\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Soldes d'hiver\",\n    \"subject\": \"Jusqu'à -50 % ce week-end\",\n    \"from_name\": \"Boutique\",\n    \"from_email\": \"news@boutique.fr\",\n    \"template_id\": \"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n    \"list_ids\": [\n      \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ]\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/campaigns\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"name\": \"Soldes d'hiver\",\n        \"subject\": \"Jusqu'à -50 % ce week-end\",\n        \"from_name\": \"Boutique\",\n        \"from_email\": \"news@boutique.fr\",\n        \"template_id\": \"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n        \"list_ids\": [\n            \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\",\n        ],\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/campaigns');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"name\": \"Soldes d'hiver\",\n    \"subject\": \"Jusqu'à -50 % ce week-end\",\n    \"from_name\": \"Boutique\",\n    \"from_email\": \"news@boutique.fr\",\n    \"template_id\": \"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n    \"list_ids\": [\n        \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ]\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/campaigns', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"name\": \"Soldes d'hiver\",\n    \"subject\": \"Jusqu'à -50 % ce week-end\",\n    \"from_name\": \"Boutique\",\n    \"from_email\": \"news@boutique.fr\",\n    \"template_id\": \"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11\",\n    \"list_ids\": [\n      \"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13\"\n    ]\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/campaigns/{campaign_id}":{"get":{"tags":["Campagnes"],"summary":"Lire une campagne","operationId":"get_campaign","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOut"},"example":{"id":"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d","name":"Soldes d'hiver","subject":"Jusqu'à -50 % ce week-end","preheader":"","from_name":"Boutique","from_email":"news@boutique.fr","reply_to":null,"template":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Soldes"},"lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"segments":[],"recipient_count":1284,"status":"scheduled","tracking_enabled":true,"ab_test":null,"scheduled_at":"2026-12-01T08:00:00Z","sent_at":null,"finished_at":null,"error":null,"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","stats":{"recipients":1284,"sent":1280,"delivered":1262,"opened":611,"clicked":148,"bounced":18,"complained":1,"unsubscribed":6,"failed":4,"queued":0}}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"patch":{"tags":["Campagnes"],"summary":"Modifier une campagne (brouillon ou planifiée)","operationId":"update_campaign","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignUpdate"}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOut"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X PATCH \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.patch(\n    \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'PATCH',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d', {\n  method: 'PATCH',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/campaigns/{campaign_id}/send":{"post":{"tags":["Campagnes"],"summary":"Lancer ou planifier une campagne","description":"Sans `scheduled_at` (ou avec une date passée) : envoi immédiat. Avec\n`send_time_optimization`, chaque destinataire reçoit l'email dans les 24 h, à l'heure où il\nclique le plus d'après son historique (sinon celle de vos contacts, sinon au lancement).\nLes contrôles avant envoi (expéditeur vérifié, objet, contenu, destinataires) s'appliquent\ncomme dans l'application.","operationId":"send_campaign","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CampaignSchedule"},{"type":"null"}],"title":"Body"},"example":{"scheduled_at":"2026-12-01T09:00:00+01:00"}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOut"},"example":{"id":"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d","name":"Soldes d'hiver","subject":"Jusqu'à -50 % ce week-end","preheader":"","from_name":"Boutique","from_email":"news@boutique.fr","reply_to":null,"template":{"id":"0b0e7d3c-6c43-4bd4-9a35-2f8a5f3e1c11","name":"Soldes"},"lists":[{"id":"5f0c2b1e-8f7a-4d3e-9c1b-2a6d4e8f0a13","name":"Clients"}],"segments":[],"recipient_count":1284,"status":"scheduled","tracking_enabled":true,"ab_test":null,"scheduled_at":"2026-12-01T08:00:00Z","sent_at":null,"finished_at":null,"error":null,"created_at":"2026-10-08T14:32:05Z","updated_at":"2026-10-08T14:32:05Z","stats":{"recipients":1284,"sent":1280,"delivered":1262,"opened":611,"clicked":148,"bounced":18,"complained":1,"unsubscribed":6,"failed":4,"queued":0}}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/send\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"scheduled_at\": \"2026-12-01T09:00:00+01:00\"\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/send\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"scheduled_at\": \"2026-12-01T09:00:00+01:00\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/send');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"scheduled_at\": \"2026-12-01T09:00:00+01:00\"\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/campaigns/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/send', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"scheduled_at\": \"2026-12-01T09:00:00+01:00\"\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/stats":{"get":{"tags":["Statistiques"],"summary":"Lire les statistiques d'envoi","description":"Totaux, courbe quotidienne et meilleures campagnes sur 7, 30 ou 90 jours. `kind` limite\nle calcul aux emails marketing ou transactionnels.","operationId":"get_stats","security":[{"HTTPBearer":[]}],"parameters":[{"name":"period","in":"query","required":false,"schema":{"enum":["7d","30d","90d"],"type":"string","default":"30d","title":"Period"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MessageKind"},{"type":"null"}],"title":"Kind"}}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsOut"},"example":{"period":"30d","totals":{"recipients":1284,"sent":1280,"delivered":1262,"opened":611,"clicked":148,"bounced":18,"complained":1,"unsubscribed":6,"failed":4,"queued":0},"series":[{"date":"2026-10-08","sent":4210,"delivered":4180,"opened":1605,"clicked":312,"bounced":30}],"top_campaigns":[],"breakdown":null}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/stats?period=30d\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/stats?period=30d\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/stats?period=30d');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/stats?period=30d', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/events":{"post":{"tags":["Événements"],"summary":"Signaler un événement (déclencheur de scénario)","operationId":"track_event","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventIn"},"example":{"email":"jeanne.martin@example.com","event":"panier_abandonne","data":{"panier_url":"https://boutique.fr/panier/4521","total":"59,90 €"}}}}},"responses":{"202":{"description":"Demande acceptée, traitée en arrière-plan.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventOut"},"example":{"accepted":true,"automations_entered":1}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/events\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"email\": \"jeanne.martin@example.com\",\n    \"event\": \"panier_abandonne\",\n    \"data\": {\n      \"panier_url\": \"https://boutique.fr/panier/4521\",\n      \"total\": \"59,90 €\"\n    }\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/events\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"email\": \"jeanne.martin@example.com\",\n        \"event\": \"panier_abandonne\",\n        \"data\": {\n            \"panier_url\": \"https://boutique.fr/panier/4521\",\n            \"total\": \"59,90 €\",\n        },\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/events');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"email\": \"jeanne.martin@example.com\",\n    \"event\": \"panier_abandonne\",\n    \"data\": {\n        \"panier_url\": \"https://boutique.fr/panier/4521\",\n        \"total\": \"59,90 €\"\n    }\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/events', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"email\": \"jeanne.martin@example.com\",\n    \"event\": \"panier_abandonne\",\n    \"data\": {\n      \"panier_url\": \"https://boutique.fr/panier/4521\",\n      \"total\": \"59,90 €\"\n    }\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/webhooks":{"get":{"tags":["Webhooks"],"summary":"Lister les webhooks","operationId":"list_webhooks","security":[{"HTTPBearer":[]}],"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookOut"},"title":"Response List Webhooks"},"example":[{"id":"3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f","url":"https://boutique.fr/webhooks/sendeo","events":["message.delivered","message.bounced","message.complained"],"enabled":true,"disabled_reason":null,"secret_prefix":"whsec_Hk2Lp","last_delivery_status":"success","created_at":"2026-10-08T14:32:05Z"}]}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl \"https://api.sendeo.io/v1/webhooks\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.sendeo.io/v1/webhooks\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/webhooks');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'GET',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/webhooks', {\n  method: 'GET',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"post":{"tags":["Webhooks"],"summary":"S'abonner à des événements","description":"Le `secret` n'est renvoyé qu'ici : il sert à vérifier l'en-tête `Sendeo-Signature`.","operationId":"create_webhook","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409).","title":"Idempotency-Key"},"description":"Identifiant unique de l'opération (ex. numéro de commande). Rejouée avec la même clé pendant 24 h, la requête renvoie la première réponse sans rien renvoyer ; avec un corps différent, elle est refusée (409)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"},"example":{"url":"https://boutique.fr/webhooks/sendeo","events":["message.delivered","message.bounced","message.complained"]}}}},"responses":{"201":{"description":"Ressource créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreated"},"example":{"id":"3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f","url":"https://boutique.fr/webhooks/sendeo","events":["message.delivered","message.bounced","message.complained"],"enabled":true,"disabled_reason":null,"secret_prefix":"whsec_Hk2Lp","last_delivery_status":"success","created_at":"2026-10-08T14:32:05Z","secret":"whsec_Hk2Lp9vQ3xR7tY1uZ8wA5bC0dE4fG6h"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X POST \"https://api.sendeo.io/v1/webhooks\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://boutique.fr/webhooks/sendeo\",\n    \"events\": [\n      \"message.delivered\",\n      \"message.bounced\",\n      \"message.complained\"\n    ]\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n    \"https://api.sendeo.io/v1/webhooks\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"url\": \"https://boutique.fr/webhooks/sendeo\",\n        \"events\": [\n            \"message.delivered\",\n            \"message.bounced\",\n            \"message.complained\",\n        ],\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/webhooks');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"url\": \"https://boutique.fr/webhooks/sendeo\",\n    \"events\": [\n        \"message.delivered\",\n        \"message.bounced\",\n        \"message.complained\"\n    ]\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/webhooks', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"url\": \"https://boutique.fr/webhooks/sendeo\",\n    \"events\": [\n      \"message.delivered\",\n      \"message.bounced\",\n      \"message.complained\"\n    ]\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]}},"/v1/webhooks/{webhook_id}":{"patch":{"tags":["Webhooks"],"summary":"Modifier un webhook","operationId":"update_webhook","security":[{"HTTPBearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdate"},"example":{"enabled":false}}}},"responses":{"200":{"description":"Succès.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookOut"},"example":{"id":"3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f","url":"https://boutique.fr/webhooks/sendeo","events":["message.delivered","message.bounced","message.complained"],"enabled":false,"disabled_reason":null,"secret_prefix":"whsec_Hk2Lp","last_delivery_status":"success","created_at":"2026-10-08T14:32:05Z"}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X PATCH \"https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"enabled\": false\n  }'"},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.patch(\n    \"https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    json={\n        \"enabled\": False,\n    },\n    timeout=10,\n)\nresponse.raise_for_status()\nprint(response.json())"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'PATCH',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n    CURLOPT_POSTFIELDS => <<<'JSON'\n{\n    \"enabled\": false\n}\nJSON,\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f', {\n  method: 'PATCH',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    \"enabled\": false\n  }),\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)\nconsole.log(await response.json())"}]},"delete":{"tags":["Webhooks"],"summary":"Supprimer un webhook","operationId":"delete_webhook","security":[{"HTTPBearer":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}}],"responses":{"204":{"description":"Ressource supprimée (pas de contenu).","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}}}},"401":{"description":"Clé API absente, invalide ou révoquée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Clé API requise : en-tête « Authorization: Bearer sk_… »."}}}},"404":{"description":"Ressource introuvable dans votre organisation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Ressource introuvable"}}}},"422":{"description":"Données invalides : `detail` indique le champ en cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Limite de débit atteinte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erreur"},"example":{"detail":"Trop de requêtes (300 par minute) : réessayez dans 12 s."}}},"headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la minute en cours.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la remise à zéro du compteur.","schema":{"type":"integer"}},"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}}}}},"x-codeSamples":[{"label":"cURL","lang":"Shell","source":"curl -X DELETE \"https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f\" \\\n  -H \"Authorization: Bearer $SENDEO_API_KEY\""},{"label":"Python","lang":"Python","source":"import os\n\nimport requests\n\nresponse = requests.delete(\n    \"https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['SENDEO_API_KEY']}\",\n    },\n    timeout=10,\n)\nresponse.raise_for_status()"},{"label":"PHP","lang":"PHP","source":"<?php\n$ch = curl_init('https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f');\ncurl_setopt_array($ch, [\n    CURLOPT_CUSTOMREQUEST => 'DELETE',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'Authorization: Bearer ' . getenv('SENDEO_API_KEY'),\n        'Content-Type: application/json',\n    ],\n]);\n$result = json_decode(curl_exec($ch), true);"},{"label":"Node.js","lang":"JavaScript","source":"const response = await fetch('https://api.sendeo.io/v1/webhooks/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f', {\n  method: 'DELETE',\n  headers: {\n    Authorization: `Bearer ${process.env.SENDEO_API_KEY}`,\n  },\n})\nif (!response.ok) throw new Error(`Erreur ${response.status}`)"}]}}},"components":{"schemas":{"AbMetric":{"type":"string","enum":["opens","clicks"],"title":"AbMetric"},"AbTestIn":{"properties":{"sample_percent":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Sample Percent"},"metric":{"$ref":"#/components/schemas/AbMetric","default":"opens"},"wait_hours":{"type":"integer","maximum":72.0,"minimum":1.0,"title":"Wait Hours","default":4},"variants":{"items":{"$ref":"#/components/schemas/VariantIn"},"type":"array","maxItems":4,"minItems":2,"title":"Variants"}},"type":"object","required":["sample_percent","variants"],"title":"AbTestIn","description":"Test A/B (CMP-08) : l'échantillon reçoit les variantes, le reste reçoit la gagnante."},"AbTestOut":{"properties":{"sample_percent":{"type":"integer","title":"Sample Percent"},"metric":{"$ref":"#/components/schemas/AbMetric"},"wait_hours":{"type":"integer","title":"Wait Hours"},"decide_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Decide At"},"winner_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Winner Id"},"variants":{"items":{"$ref":"#/components/schemas/VariantOut"},"type":"array","title":"Variants"}},"type":"object","required":["sample_percent","metric","wait_hours","decide_at","winner_id","variants"],"title":"AbTestOut"},"AddressResultOut":{"properties":{"email":{"type":"string","title":"Email"},"verdict":{"$ref":"#/components/schemas/ValidationVerdict"},"reason":{"$ref":"#/components/schemas/ValidationReason"}},"type":"object","required":["email","verdict","reason"],"title":"AddressResultOut"},"ApiTemplateCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id"},"editor":{"$ref":"#/components/schemas/TemplateEditor","default":"code"},"subject":{"type":"string","maxLength":255,"title":"Subject","default":""},"preheader":{"type":"string","maxLength":255,"title":"Preheader","default":""},"html":{"type":"string","maxLength":1000000,"title":"Html","default":""}},"type":"object","required":["name"],"title":"ApiTemplateCreate","description":"Template créé par l'API publique : HTML écrit à la main, éditeur de code par défaut."},"ApiTemplateUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"subject":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Subject"},"preheader":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Preheader"},"html":{"anyOf":[{"type":"string","maxLength":1000000},{"type":"null"}],"title":"Html","description":"Templates de l'éditeur de code seulement (409 pour l'éditeur visuel)."},"base_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Base Revision","description":"`revision` lue avant de modifier : 409 si le template a changé depuis."}},"type":"object","title":"ApiTemplateUpdate","description":"Modification par l'API publique ; champ absent : inchangé."},"AttachmentIn":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename","description":"Nom du fichier vu par le destinataire."},"content_type":{"type":"string","maxLength":100,"title":"Content Type","description":"Type MIME, par exemple `application/pdf`.","default":"application/octet-stream"},"content":{"type":"string","minLength":1,"title":"Content","description":"Contenu du fichier encodé en base64."}},"type":"object","required":["filename","content"],"title":"AttachmentIn"},"Body_import_contacts":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"list_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"List Id"},"update_existing":{"type":"boolean","title":"Update Existing","default":true}},"type":"object","required":["file"],"title":"Body_import_contacts"},"BreakdownOut":{"properties":{"clients":{"items":{"$ref":"#/components/schemas/ShareOut"},"type":"array","title":"Clients"},"devices":{"items":{"$ref":"#/components/schemas/ShareOut"},"type":"array","title":"Devices"},"countries":{"items":{"$ref":"#/components/schemas/ShareOut"},"type":"array","title":"Countries"}},"type":"object","required":["clients","devices","countries"],"title":"BreakdownOut","description":"Répartition des ouvertures et clics (TRK-07), scanners exclus."},"CampaignCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"subject":{"type":"string","maxLength":255,"title":"Subject","default":""},"preheader":{"type":"string","maxLength":255,"title":"Preheader","default":""},"from_name":{"type":"string","maxLength":200,"title":"From Name","default":""},"from_email":{"type":"string","maxLength":320,"title":"From Email","default":""},"reply_to":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Reply To"},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"list_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"List Ids"},"segment_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Segment Ids"},"tracking_enabled":{"type":"boolean","title":"Tracking Enabled","default":true},"ab_test":{"anyOf":[{"$ref":"#/components/schemas/AbTestIn"},{"type":"null"}]}},"type":"object","required":["name"],"title":"CampaignCreate"},"CampaignOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"subject":{"type":"string","title":"Subject"},"preheader":{"type":"string","title":"Preheader"},"from_name":{"type":"string","title":"From Name"},"from_email":{"type":"string","title":"From Email"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"template":{"anyOf":[{"$ref":"#/components/schemas/RefOut"},{"type":"null"}]},"lists":{"items":{"$ref":"#/components/schemas/RefOut"},"type":"array","title":"Lists"},"segments":{"items":{"$ref":"#/components/schemas/RefOut"},"type":"array","title":"Segments"},"recipient_count":{"type":"integer","title":"Recipient Count"},"status":{"$ref":"#/components/schemas/CampaignStatus"},"tracking_enabled":{"type":"boolean","title":"Tracking Enabled"},"send_time_optimization":{"type":"boolean","title":"Send Time Optimization"},"ab_test":{"anyOf":[{"$ref":"#/components/schemas/AbTestOut"},{"type":"null"}]},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"stats":{"$ref":"#/components/schemas/DeliveryStatsOut"}},"type":"object","required":["id","name","subject","preheader","from_name","from_email","reply_to","template","lists","segments","recipient_count","status","tracking_enabled","send_time_optimization","ab_test","scheduled_at","sent_at","finished_at","error","created_at","updated_at","stats"],"title":"CampaignOut"},"CampaignPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CampaignOut"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","next_cursor","total"],"title":"CampaignPage"},"CampaignSchedule":{"properties":{"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At"},"send_time_optimization":{"type":"boolean","title":"Send Time Optimization","default":false}},"type":"object","title":"CampaignSchedule"},"CampaignStatus":{"type":"string","enum":["draft","scheduled","sending","paused","sent","cancelled","failed"],"title":"CampaignStatus"},"CampaignUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"subject":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Subject"},"preheader":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Preheader"},"from_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"From Name"},"from_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"From Email"},"reply_to":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Reply To"},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"list_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"List Ids"},"segment_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Segment Ids"},"tracking_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tracking Enabled"},"ab_test":{"anyOf":[{"$ref":"#/components/schemas/AbTestIn"},{"type":"null"}]}},"type":"object","title":"CampaignUpdate","description":"Champs absents : inchangés ; `null` explicite : effacé (template, réponse)."},"ContactCreate":{"properties":{"email":{"type":"string","maxLength":320,"minLength":3,"title":"Email"},"first_name":{"type":"string","maxLength":100,"title":"First Name","default":""},"last_name":{"type":"string","maxLength":100,"title":"Last Name","default":""},"list_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200,"title":"List Ids"},"attributes":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Attributes"},"open_tracking_consent":{"$ref":"#/components/schemas/OpenTrackingConsent","default":"unknown"}},"type":"object","required":["email"],"title":"ContactCreate"},"ContactListCreate":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":200,"title":"Description","default":""}},"type":"object","required":["name"],"title":"ContactListCreate"},"ContactListOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"contact_count":{"type":"integer","title":"Contact Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","description","contact_count","created_at"],"title":"ContactListOut"},"ContactListUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Description"}},"type":"object","title":"ContactListUpdate"},"ContactOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"email":{"type":"string","title":"Email"},"first_name":{"type":"string","title":"First Name"},"last_name":{"type":"string","title":"Last Name"},"status":{"$ref":"#/components/schemas/ContactStatus"},"lists":{"items":{"$ref":"#/components/schemas/ListRef"},"type":"array","title":"Lists"},"attributes":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Attributes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"last_activity_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Activity At"},"engagement_score":{"type":"integer","title":"Engagement Score"},"open_tracking_consent":{"$ref":"#/components/schemas/OpenTrackingConsent"},"open_tracking_consent_source":{"type":"string","title":"Open Tracking Consent Source"},"open_tracking_consent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Open Tracking Consent At"}},"type":"object","required":["id","email","first_name","last_name","status","lists","attributes","created_at","updated_at","last_activity_at","engagement_score","open_tracking_consent","open_tracking_consent_source","open_tracking_consent_at"],"title":"ContactOut"},"ContactPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ContactOut"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","next_cursor","total"],"title":"ContactPage"},"ContactStatus":{"type":"string","enum":["subscribed","unsubscribed","bounced","complained"],"title":"ContactStatus"},"ContactUpdate":{"properties":{"email":{"anyOf":[{"type":"string","maxLength":320,"minLength":3},{"type":"null"}],"title":"Email"},"first_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Last Name"},"list_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200},{"type":"null"}],"title":"List Ids"},"attributes":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Attributes"},"open_tracking_consent":{"anyOf":[{"$ref":"#/components/schemas/OpenTrackingConsent"},{"type":"null"}]}},"type":"object","title":"ContactUpdate"},"DailyPointOut":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"sent":{"type":"integer","title":"Sent"},"delivered":{"type":"integer","title":"Delivered"},"measured":{"type":"integer","title":"Measured"},"opened":{"type":"integer","title":"Opened"},"clicked":{"type":"integer","title":"Clicked"},"bounced":{"type":"integer","title":"Bounced"}},"type":"object","required":["date","sent","delivered","measured","opened","clicked","bounced"],"title":"DailyPointOut"},"DeliveryStatsOut":{"properties":{"recipients":{"type":"integer","title":"Recipients"},"sent":{"type":"integer","title":"Sent"},"delivered":{"type":"integer","title":"Delivered"},"measured":{"type":"integer","title":"Measured"},"opened":{"type":"integer","title":"Opened"},"anonymous_opened":{"type":"integer","title":"Anonymous Opened","default":0},"clicked":{"type":"integer","title":"Clicked"},"bounced":{"type":"integer","title":"Bounced"},"complained":{"type":"integer","title":"Complained"},"unsubscribed":{"type":"integer","title":"Unsubscribed"},"failed":{"type":"integer","title":"Failed"},"queued":{"type":"integer","title":"Queued"}},"type":"object","required":["recipients","sent","delivered","measured","opened","clicked","bounced","complained","unsubscribed","failed","queued"],"title":"DeliveryStatsOut"},"DeliveryStatus":{"type":"string","enum":["pending","success","failed"],"title":"DeliveryStatus"},"EventIn":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Adresse du contact ; inconnue, réponse 404 sauf avec `create_contact`."},"event":{"type":"string","pattern":"^[a-z0-9_.-]{1,64}$","title":"Event","description":"Nom de l'événement, en minuscules (ex. `panier_abandonne`, `achat`)."},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Données libres, lues dans les emails du scénario par `{{ var.nom }}`."},"create_contact":{"type":"boolean","title":"Create Contact","description":"Crée le contact s'il n'existe pas (abonné, dans aucune liste : il reçoit les emails du scénario, et une campagne seulement si un segment l'inclut). 409 si l'adresse est dans la liste de suppression.","default":false}},"type":"object","required":["email","event"],"title":"EventIn"},"EventOut":{"properties":{"accepted":{"type":"boolean","title":"Accepted","default":true},"automations_entered":{"type":"integer","title":"Automations Entered","description":"Scénarios dans lesquels le contact est entré."}},"type":"object","required":["automations_entered"],"title":"EventOut"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImportJobOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"file_name":{"type":"string","title":"File Name"},"status":{"$ref":"#/components/schemas/ImportStatus"},"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"sample_rows":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Sample Rows"},"suggested_mapping":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Suggested Mapping"},"list_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"List Id"},"update_existing":{"type":"boolean","title":"Update Existing"},"total_rows":{"type":"integer","title":"Total Rows"},"processed_rows":{"type":"integer","title":"Processed Rows"},"created":{"type":"integer","title":"Created"},"updated":{"type":"integer","title":"Updated"},"skipped":{"type":"integer","title":"Skipped"},"risky":{"type":"integer","title":"Risky"},"errors":{"items":{"$ref":"#/components/schemas/ImportRowError"},"type":"array","title":"Errors"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","file_name","status","columns","sample_rows","suggested_mapping","list_id","update_existing","total_rows","processed_rows","created","updated","skipped","risky","errors","created_at"],"title":"ImportJobOut"},"ImportRowError":{"properties":{"row":{"type":"integer","title":"Row"},"email":{"type":"string","title":"Email"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["row","email","reason"],"title":"ImportRowError"},"ImportStatus":{"type":"string","enum":["mapping","processing","completed","failed"],"title":"ImportStatus"},"JsonValue":{},"ListRef":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"ListRef"},"MessageDetailOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"to":{"type":"string","title":"To","description":"Adresse du destinataire."},"from_email":{"type":"string","title":"From Email"},"from_name":{"type":"string","title":"From Name"},"subject":{"type":"string","title":"Subject","description":"Objet, variables remplacées une fois l'email envoyé."},"status":{"$ref":"#/components/schemas/RecipientStatus","description":"Dernier état connu : `queued`, `sent`, `delivered`, `opened`, `clicked`, `bounced`, `complained` ou `failed`."},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Id","description":"Campagne d'origine ; nul : transactionnel."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Raison de l'échec, si le message n'est pas parti."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Réception de la demande d'envoi."},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At","description":"Remise au serveur d'envoi."},"events":{"items":{"$ref":"#/components/schemas/MessageEventOut"},"type":"array","title":"Events","description":"Chronologie, du plus ancien au plus récent."}},"type":"object","required":["id","to","from_email","from_name","subject","status","tags","campaign_id","error","created_at","sent_at","events"],"title":"MessageDetailOut"},"MessageEventOut":{"properties":{"type":{"$ref":"#/components/schemas/MessageEventType"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail","description":"Précision : lien cliqué, réponse du serveur destinataire, raison d'un échec."}},"type":"object","required":["type","occurred_at","detail"],"title":"MessageEventOut"},"MessageEventType":{"type":"string","enum":["queued","sent","delivered","opened","clicked","bounced","complained","unsubscribed","failed"],"title":"MessageEventType"},"MessageKind":{"type":"string","enum":["campaign","transactional","automation"],"title":"MessageKind"},"MessageOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"to":{"type":"string","title":"To","description":"Adresse du destinataire."},"from_email":{"type":"string","title":"From Email"},"from_name":{"type":"string","title":"From Name"},"subject":{"type":"string","title":"Subject","description":"Objet, variables remplacées une fois l'email envoyé."},"status":{"$ref":"#/components/schemas/RecipientStatus","description":"Dernier état connu : `queued`, `sent`, `delivered`, `opened`, `clicked`, `bounced`, `complained` ou `failed`."},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Id","description":"Campagne d'origine ; nul : transactionnel."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Raison de l'échec, si le message n'est pas parti."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Réception de la demande d'envoi."},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At","description":"Remise au serveur d'envoi."}},"type":"object","required":["id","to","from_email","from_name","subject","status","tags","campaign_id","error","created_at","sent_at"],"title":"MessageOut"},"MessagePage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MessageOut"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Curseur de la page suivante ; nul : dernière page."},"total":{"type":"integer","title":"Total","description":"Nombre total de résultats."}},"type":"object","required":["items","next_cursor","total"],"title":"MessagePage"},"MessageStatus":{"type":"string","enum":["queued","sent","delivered","bounced","complained","failed"],"title":"MessageStatus"},"OpenTrackingConsent":{"type":"string","enum":["unknown","granted","denied"],"title":"OpenTrackingConsent","description":"Accord du contact à la mesure de ses ouvertures (TRK-10) ; sans réponse : `unknown`."},"RecipientIn":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Adresse du destinataire."},"name":{"type":"string","maxLength":200,"title":"Name","description":"Nom affiché ; sert de `contact.first_name` si l'adresse n'est pas un contact.","default":""},"variables":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object","title":"Variables","description":"Variables propres à ce destinataire, prioritaires sur les variables communes."}},"type":"object","required":["email"],"title":"RecipientIn"},"RecipientStatus":{"type":"string","enum":["queued","sent","delivered","opened","clicked","bounced","complained","failed"],"title":"RecipientStatus","description":"Statut affiché d'un destinataire : celui du message, enrichi de l'ouverture et du clic."},"RefOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"RefOut"},"SendRequest":{"properties":{"from":{"type":"string","maxLength":520,"minLength":3,"title":"From","description":"Expéditeur : `commandes@boutique.fr` ou `Boutique <commandes@boutique.fr>`. L'adresse doit être une adresse d'expédition validée, sur un domaine vérifié."},"to":{"items":{"anyOf":[{"type":"string","format":"email"},{"$ref":"#/components/schemas/RecipientIn"}]},"type":"array","maxItems":50,"minItems":1,"title":"To","description":"De 1 à 50 destinataires : des adresses, ou des objets avec nom et variables. Chacun reçoit son propre message ; ils ne se voient pas entre eux."},"subject":{"anyOf":[{"type":"string","maxLength":998},{"type":"null"}],"title":"Subject","description":"Objet, obligatoire sans template ; avec un template, remplace le sien."},"html":{"anyOf":[{"type":"string","maxLength":1000000},{"type":"null"}],"title":"Html","description":"Contenu HTML (sans `template_id`)."},"text":{"anyOf":[{"type":"string","maxLength":1000000},{"type":"null"}],"title":"Text","description":"Version texte. Absente, elle est déduite du HTML."},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id","description":"Template à utiliser à la place de `html` / `text`."},"variables":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object","title":"Variables","description":"Variables communes à tous les destinataires, lues par `{{ var.nom }}`."},"reply_to":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Reply To","description":"Adresse de réponse."},"tags":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Tags","description":"Jusqu'à 10 étiquettes, renvoyées dans le journal et les webhooks."},"attachments":{"items":{"$ref":"#/components/schemas/AttachmentIn"},"type":"array","maxItems":10,"title":"Attachments","description":"Pièces jointes, 10 Mo au total."},"tracking":{"type":"boolean","title":"Tracking","description":"Suivre les ouvertures et les clics. Désactivé par défaut : les liens (réinitialisation de mot de passe…) restent intacts.","default":false}},"type":"object","required":["from","to"],"title":"SendRequest"},"SendResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/SentMessageOut"},"type":"array","title":"Messages"}},"type":"object","required":["messages"],"title":"SendResponse"},"SentMessageOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Identifiant du message, pour `GET /v1/messages/{id}`."},"email":{"type":"string","title":"Email","description":"Adresse du destinataire, normalisée."},"status":{"$ref":"#/components/schemas/MessageStatus","description":"`queued` : en file d'envoi ; `failed` : refusé tout de suite (voir `error`)."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Raison d'un refus immédiat (adresse bloquée)."}},"type":"object","required":["id","email","status","error"],"title":"SentMessageOut"},"ShareOut":{"properties":{"label":{"type":"string","title":"Label"},"messages":{"type":"integer","title":"Messages"}},"type":"object","required":["label","messages"],"title":"ShareOut"},"StatsOut":{"properties":{"period":{"type":"string","enum":["7d","30d","90d"],"title":"Period"},"totals":{"$ref":"#/components/schemas/DeliveryStatsOut"},"series":{"items":{"$ref":"#/components/schemas/DailyPointOut"},"type":"array","title":"Series"},"top_campaigns":{"items":{"$ref":"#/components/schemas/TopCampaignOut"},"type":"array","title":"Top Campaigns"},"breakdown":{"anyOf":[{"$ref":"#/components/schemas/BreakdownOut"},{"type":"null"}]}},"type":"object","required":["period","totals","series","top_campaigns","breakdown"],"title":"StatsOut"},"TemplateEditor":{"type":"string","enum":["builder","code"],"title":"TemplateEditor"},"TemplateOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id"},"editor":{"$ref":"#/components/schemas/TemplateEditor"},"subject":{"type":"string","title":"Subject"},"preheader":{"type":"string","title":"Preheader"},"html":{"type":"string","title":"Html"},"revision":{"type":"integer","title":"Revision"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","category_id","editor","subject","preheader","html","revision","created_at","updated_at"],"title":"TemplateOut"},"TemplateSaved":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id"},"editor":{"$ref":"#/components/schemas/TemplateEditor"},"subject":{"type":"string","title":"Subject"},"preheader":{"type":"string","title":"Preheader"},"html":{"type":"string","title":"Html"},"revision":{"type":"integer","title":"Revision"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"unknown_variables":{"items":{"type":"string"},"type":"array","title":"Unknown Variables"}},"type":"object","required":["id","name","category_id","editor","subject","preheader","html","revision","created_at","updated_at","unknown_variables"],"title":"TemplateSaved"},"TopCampaignOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"open_rate":{"type":"number","title":"Open Rate"},"click_rate":{"type":"number","title":"Click Rate"}},"type":"object","required":["id","name","open_rate","click_rate"],"title":"TopCampaignOut"},"ValidateRequest":{"properties":{"emails":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Emails"}},"type":"object","required":["emails"],"title":"ValidateRequest"},"ValidateResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/AddressResultOut"},"type":"array","title":"Results"},"credits_remaining":{"type":"integer","title":"Credits Remaining"}},"type":"object","required":["results","credits_remaining"],"title":"ValidateResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationReason":{"type":"string","enum":["ok","syntax","no_mx","disposable","role","catch_all","mailbox_not_found"],"title":"ValidationReason"},"ValidationVerdict":{"type":"string","enum":["valid","risky","invalid"],"title":"ValidationVerdict"},"VariantIn":{"properties":{"subject":{"type":"string","maxLength":255,"title":"Subject","default":""},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"}},"type":"object","title":"VariantIn"},"VariantOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"label":{"type":"string","title":"Label"},"subject":{"type":"string","title":"Subject"},"template":{"anyOf":[{"$ref":"#/components/schemas/RefOut"},{"type":"null"}]},"sent":{"type":"integer","title":"Sent"},"measured":{"type":"integer","title":"Measured"},"opened":{"type":"integer","title":"Opened"},"anonymous_opened":{"type":"integer","title":"Anonymous Opened","default":0},"clicked":{"type":"integer","title":"Clicked"}},"type":"object","required":["id","label","subject","template","sent","measured","opened","clicked"],"title":"VariantOut"},"WebhookCreate":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":8,"title":"Url","description":"Adresse https de votre application ; les adresses privées sont refusées."},"events":{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","minItems":1,"title":"Events","description":"Événements à recevoir."}},"type":"object","required":["url","events"],"title":"WebhookCreate"},"WebhookCreated":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","title":"Events"},"enabled":{"type":"boolean","title":"Enabled"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason","description":"Pourquoi le webhook a été désactivé automatiquement, le cas échéant."},"secret_prefix":{"type":"string","title":"Secret Prefix","description":"Début du secret, pour le reconnaître sans l'afficher."},"last_delivery_status":{"anyOf":[{"$ref":"#/components/schemas/DeliveryStatus"},{"type":"null"}],"description":"Résultat de la dernière livraison (`success` ou `failed`)."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"secret":{"type":"string","title":"Secret","description":"Secret de signature (`Sendeo-Signature`), renvoyé uniquement à la création."}},"type":"object","required":["id","url","events","enabled","disabled_reason","secret_prefix","last_delivery_status","created_at","secret"],"title":"WebhookCreated"},"WebhookEventType":{"type":"string","enum":["message.sent","message.delivered","message.opened","message.clicked","message.bounced","message.complained","message.failed","contact.unsubscribed"],"title":"WebhookEventType"},"WebhookOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","title":"Events"},"enabled":{"type":"boolean","title":"Enabled"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason","description":"Pourquoi le webhook a été désactivé automatiquement, le cas échéant."},"secret_prefix":{"type":"string","title":"Secret Prefix","description":"Début du secret, pour le reconnaître sans l'afficher."},"last_delivery_status":{"anyOf":[{"$ref":"#/components/schemas/DeliveryStatus"},{"type":"null"}],"description":"Résultat de la dernière livraison (`success` ou `failed`)."},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","url","events","enabled","disabled_reason","secret_prefix","last_delivery_status","created_at"],"title":"WebhookOut"},"WebhookUpdate":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":8},{"type":"null"}],"title":"Url"},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","minItems":1},{"type":"null"}],"title":"Events"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled","description":"Réactiver remet à zéro le compteur d'échecs."}},"type":"object","title":"WebhookUpdate"},"Erreur":{"type":"object","title":"Erreur","properties":{"detail":{"type":"string","description":"Message lisible, destiné à l'utilisateur."}},"required":["detail"]}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer","description":"Clé API de votre organisation : `Authorization: Bearer sk_…`."}}},"tags":[{"name":"Emails transactionnels","description":"Envoyez un email à un ou plusieurs destinataires (un message chacun), puis suivez son statut et ses événements. Le journal est conservé 30 jours."},{"name":"Contacts","description":"Votre base de contacts, identifiés par leur adresse email. Une adresse de la liste de suppression (désinscription, bounce, plainte) ne peut pas être ajoutée."},{"name":"Listes","description":"Les listes regroupent des contacts destinataires de campagnes."},{"name":"Validation d'adresses","description":"Vérifiez des adresses avant de les importer ou de leur écrire : moins de bounces, une meilleure réputation. Crédits mensuels selon votre offre."},{"name":"Templates","description":"Contenus réutilisables : utilisez leur identifiant comme `template_id` dans `POST /v1/send` ou dans une campagne."},{"name":"Campagnes","description":"Emails marketing envoyés à une ou plusieurs listes : créez un brouillon, puis lancez-le tout de suite ou planifiez-le."},{"name":"Statistiques","description":"Chiffres d'envoi agrégés de votre organisation sur une période."},{"name":"Événements","description":"Signalez ce que font vos contacts sur votre site (commande, panier abandonné…) : un événement fait entrer le contact dans les scénarios qui l'attendent, ou le fait sortir de ceux dont c'est l'objectif."},{"name":"Webhooks","description":"Abonnez une URL de votre application aux événements de vos emails (voir [Webhooks](#description/webhooks) pour le format et la signature)."}]}