Journal des modifications : API REST

Le serveur MCP à l’adresse https://api.emailit.com/mcp couvre désormais tout ce que propose l’API v2 :

• Nouveaux groupes d’outils (toolsets) : campagnes, automatisations, formulaires, rapports DMARC, vérification d’e-mails, événements, actions groupées et export de contacts, abonnés, ainsi que tests, relances et rotation du secret des webhooks. Consultez la référence des outils.
• Annotations : chaque outil est étiqueté read-only, destructive, idempotent ou open-world, pour que les clients puissent demander confirmation avant d’exécuter des actions d’écriture.
• Résultats structurés : les outils renvoient du JSON sous forme de texte et sous forme de contenu structuré pour les clients qui l’analysent.
• Instructions intégrées : le serveur demande aux assistants de confirmer les destinataires avant d’envoyer et de demander l’accord avant de supprimer quoi que ce soit.
• Groupes d’outils et mode lecture seule : chargez moins d’outils avec ?toolsets= ou masquez les outils d’écriture avec ?read_only=true. Consultez Groupes d’outils.
• Transport sans état : aucune session MCP qui expire ; les clients envoient chaque requête en POST.

Correction : les connexions OAuth approuvées avec à la fois la portée sending et la portée full fonctionnent désormais avec tous les outils, et l’espace de travail vers lequel vous basculez reste sélectionné après l’actualisation du jeton par le client.

• Les clés API créées avant l’introduction du préfixe secret_ sont de nouveau acceptées sur /v2.
• Récupérer un e-mail renvoie l’objet e-mail complet, y compris object, from et to.
• Les réponses des domaines renvoient track_loads et track_clicks sous la forme 0 ou 1, comme documenté.

Ouvrez Email API → Logs pour voir les requêtes réussies et en échec, de la dernière heure jusqu’aux 30 derniers jours. Filtrez par source (API ou SMTP), résultat, méthode, chemin, code de statut, durée ou clé API, et ouvrez une requête pour voir les corps de la requête et de la réponse. Les valeurs sensibles sont masquées et les corps longs sont tronqués.

Consultez Logs de requêtes.

Dans le tableau de bord, utilisez Filters pour combiner des conditions avec Match all ou Match any, cliquez sur les en-têtes de colonne pour trier, et choisissez les colonnes dans Display options.

Dans l’API, filtrez avec des paramètres de requête field.condition=value, combinez-les avec match=all ou match=or, et triez avec order et direction :

curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Chaque endpoint de liste documente ses champs filtrables. Consultez Filtrage et tri.

• Contacts : créez, listez, récupérez, mettez à jour et supprimez des contacts. Retrouvez un contact par son ID con_ ou son adresse e-mail, et ajoutez-le à des listes de contacts dans le même appel.
• Événements : listez les événements, filtrés par un ou plusieurs types et éventuellement avec leurs données, et récupérez un événement précis.
• Webhooks : créez, listez, récupérez, mettez à jour et supprimez des endpoints de webhook.

Ces endpoints nécessitent une clé à accès complet. Consultez la référence de l’API.

Les ID sont uniques sur l’ensemble des services et se trient par date de création. Préfixes courants : em_ pour les e-mails, dom_ pour les domaines, key_ pour les clés API, aud_ pour les listes de contacts, sub_ pour les abonnés, con_ pour les contacts, sup_ pour les adresses bloquées, wh_ pour les webhooks, evt_ pour les événements et cmp_ pour les campagnes.

Stockez les ID comme des chaînes opaques au lieu de les analyser.

Les nouvelles fonctionnalités ne sortent que dans l’API v2, à l’adresse https://api.emailit.com/v2. Si vous appelez encore /v1, passez aux endpoints v2 et envoyez votre clé API dans l’en-tête Authorization: Bearer.

Consultez Gestion des versions.

Les clés API remplacent les identifiants. Une clé a la portée full ou sending, une clé d’envoi peut être restreinte à un seul domaine d’envoi, et vous pouvez gérer les clés via l’API. L’API v1 est restée disponible pendant votre migration.

Consultez la référence de l’API.