Apps IA (MCP)
Tools du compte
Tous les tools du serveur du compte. La liste visible par votre app dépend des permissions que vous avez accordées.
- 75 tools
- 10 groupes
https://g.sendcorex.com/mcp/accountDomaines
10domain_listLister les domaines d'envoi
Liste tous les domaines d'envoi du compte (léger, sans vérification DNS en direct).
Lecture seuledomain:readdomain_getObtenir un domaine et vérifier le DNS
Renvoie un domaine avec les enregistrements DNS à publier et vérifie le DNS en direct : marque le domaine comme validé dès que Return-Path (CNAME) et DKIM sont publiés, et active une clé DKIM 2048 bits en attente lorsque son nouvel enregistrement TXT est visible.
Lecture seuledomain:readdomain_list_freeLister les domaines gratuits partagés
Liste les domaines partagés utilisables pour créer un expéditeur sans posséder de domaine (passez-en un comme domain dans sender_create).
Lecture seuledomain:readdomain_send_dns_instructionsEnvoyer les instructions DNS par e-mail
Envoie par e-mail, à n'importe quelle adresse, les enregistrements DNS (SPF, DKIM, Return-Path, DMARC) nécessaires à un domaine, par ex.
Modifie des donnéesdomain:readdomain_addAjouter un domaine d'envoi
Ajoute un domaine d'envoi au compte et génère sa clé DKIM ; le domaine reste non validé tant que les enregistrements DNS renvoyés ne sont pas publiés (vérifiez ensuite avec domain_get).
Modifie des donnéesdomain:createdomain_start_dkim_upgradeLancer la mise à niveau DKIM 2048 bits
Commence à remplacer une clé DKIM 1024 bits par une clé 2048 bits sous un nouveau sélecteur ; l'ancienne clé continue de signer jusqu'à la publication du nouvel enregistrement TXT (dns_records.dkim_pending), après quoi domain_get l'active automatiquement.
Modifie des donnéesdomain:createdomain_cancel_dkim_upgradeAnnuler la mise à niveau DKIM
Annule une mise à niveau DKIM 2048 bits en attente et supprime la clé en attente ; la clé actuelle reste utilisée.
Demande confirmationdomain:createdomain_update_descriptionDéfinir la description du domaine
Définit ou efface la description libre (note interne) d'un domaine ; une chaîne vide ou null l'efface.
Modifie des donnéesdomain:createdomain_request_remediationDemander une révision de blocklist
Soumet une demande de révision manuelle pour un domaine que domain_add a rejeté comme BLACKLISTED ; une fois approuvée, domain_add peut être relancé.
Modifie des donnéesdomain:createdomain_deleteSupprimer un domaine d'envoi
Supprime définitivement un domaine, ses clés DKIM et TOUS ses expéditeurs ; c'est irréversible.
Demande confirmationdomain:delete
Expéditeurs
6sender_listLister les expéditeurs
Liste tous les expéditeurs (adresses d'envoi) du compte.
Lecture seulesender:readsender_getObtenir un expéditeur
Renvoie un expéditeur par sender_id, avec les mêmes champs qu'un élément de sender_list (réputation incluse).
Lecture seulesender:readsender_createCréer un expéditeur
Crée l'expéditeur username@domain sur un domaine validé du compte, ou sur un domaine partagé de domain_list_free.
Modifie des donnéessender:createsender_updateMettre à jour un expéditeur
Modifie le from_name et/ou le reply_to d'un expéditeur (au moins un doit être envoyé ; username et domain ne peuvent pas changer).
Modifie des donnéessender:updatesender_update_descriptionDéfinir la description de l'expéditeur
Définit ou efface la description libre (note interne) d'un expéditeur ; une chaîne vide ou null l'efface.
Modifie des donnéessender:updatesender_deleteSupprimer un expéditeur
Supprime définitivement un expéditeur ; c'est irréversible.
Demande confirmationsender:delete
Templates
8template_listLister les templates
Liste les templates d'e-mail du compte (les plus récemment mis à jour en premier), avec un filtre facultatif par type (unlayer, custom ou html).
Lecture seuletemplate:readtemplate_getObtenir un template
Obtient un template par template_id (html_<uuid>, unlayer_<number> ou custom_<uuid>), contenu inclus.
Lecture seuletemplate:readtemplate_renderRendre un template
Rend un template en remplaçant les placeholders {{variable}} par les valeurs fournies (échappées en HTML dans html, brutes dans subject et text) pour prévisualiser ce qui sera envoyé.
Lecture seuletemplate:readtemplate_list_versionsLister les versions du template
Liste les versions enregistrées d'un template (chaque mise à jour conserve une version ; seules les 10 dernières sont gardées).
Lecture seuletemplate:readtemplate_createCréer un template HTML
Crée un nouveau template de type html à partir de votre propre HTML (512 Ko max. ; le contenu dangereux est rejeté).
Modifie des donnéestemplate:createtemplate_updateMettre à jour un template HTML
Met à jour un template de type html : envoyez au moins un des champs name, html, text ou subject (text/subject à null les efface).
Demande confirmationtemplate:updatetemplate_restore_versionRestaurer une version du template
Restaure un template de type html à une version précédente, en écrasant son contenu actuel.
Demande confirmationtemplate:updatetemplate_deleteSupprimer un template HTML
Supprime définitivement un template de type html (les templates Unlayer et Custom ne peuvent être supprimés que dans le dashboard : TEMPLATE_READ_ONLY).
Demande confirmationtemplate:delete
Logs d'e-mails
2logs_listLister les logs d'e-mails
Recherche dans les logs des e-mails envoyés du compte (API, SMTP et campagnes ; warmup exclu), les plus récents en premier, avec des filtres combinés en AND ; la période par défaut couvre les 60 derniers jours.
Lecture seulelogs:readlogs_getObtenir des logs d'e-mails par id
Récupère des logs d'e-mails par id d'e-mail (UUID), jusqu'à 50 par appel ou 10 avec include_content=true (ajoute content.html, le HTML envoyé).
Lecture seulelogs:read
Bounces et plaintes
2feedback_listLister les événements de feedback
Liste les événements de bounce, de plainte et d'e-mail abandonné du compte, les plus anciens en premier (rétention de 90 jours), pour synchroniser les suppressions : conservez next_cursor et passez-le à l'appel suivant (has_more=true signifie que d'autres sont déjà disponibles).
Lecture seulefeedback:readfeedback_get_emailObtenir le feedback d'un e-mail
Obtient les événements de feedback d'un e-mail envoyé par email_id : au plus un bounce, une plainte et un événement d'abandon.
Lecture seulefeedback:read
Compteurs
5counters_get_totalsObtenir les totaux depuis le début
Obtient les compteurs d'envoi du compte depuis le début, API, SMTP et campagnes confondus.
Lecture seulecounters:readcounters_get_monthObtenir les compteurs du mois
Obtient les compteurs d'envoi d'un mois calendaire (UTC) ; par défaut, le mois en cours.
Lecture seulecounters:readcounters_get_monthsObtenir les compteurs par mois
Obtient les compteurs d'envoi par mois (UTC) sur une plage de mois, plus le total de la période ; omettez from/to pour une plage ouverte (tous les mois).
Lecture seulecounters:readcounters_get_dailyObtenir les compteurs par jour
Obtient les compteurs d'envoi par jour sur une plage de dates (bornes incluses, 400 jours max.), avec des jours découpés selon le fuseau horaire IANA fourni (UTC par défaut).
Lecture seulecounters:readcounters_get_hourlyObtenir les compteurs par heure
Obtient les compteurs d'envoi par heure UTC entre deux instants (7 jours d'écart max.).
Lecture seulecounters:read
Contacts
30contacts_getObtenir des contacts par e-mail
Récupère jusqu'à 100 contacts par adresse e-mail exacte.
Lecture seulecontact:readcontacts_queryInterroger les contacts
Recherche/filtre les contacts avec un filtre 'where' et un tri facultatif, paginé (limit 1–1000, 50 par défaut).
Lecture seulecontact:readcontacts_countCompter les contacts
Compte les contacts correspondant à un filtre 'where' (le même que contacts_query), en s'arrêtant à 'max' (100000 par défaut).
Lecture seulecontact:readcontacts_list_eventsLister les événements d'un contact
Liste la chronologie d'activité d'un contact (envoi, ouverture, clic, bounce, plainte, désabonnement), les plus récents en premier, paginée (limit 1–1000, 50 par défaut).
Lecture seulecontact:readcontacts_get_statsObtenir les totaux des contacts
Compteurs de contacts de tout le compte sans parcours : renvoie {total, status: {status: n}, lists: {list_id: {total, ok, opened, clicked}}, tags: {tag: n}}.
Lecture seulecontact:readcontacts_list_fieldsLister les champs personnalisés
Liste les définitions des champs de contact personnalisés du compte (key, name, type, options, created_at, updated_at).
Lecture seulecontact:readcontacts_define_fieldDéfinir un champ personnalisé
Crée un champ de contact personnalisé, ou met à jour le name/options d'un champ existant (le type ne peut pas changer).
Modifie des donnéescontact:createcontacts_delete_fieldSupprimer un champ personnalisé
Supprime la définition d'un champ personnalisé et efface ses valeurs de tous les contacts en arrière-plan (irréversible).
Demande confirmationcontact:deletecontacts_list_listsLister les listes de contacts
Liste toutes les listes de contacts, les plus anciennes en premier.
Lecture seulecontact:readcontacts_get_listObtenir une liste de contacts
Obtient une liste avec les statistiques de ses membres {total, ok, opened, clicked}.
Lecture seulecontact:readcontacts_list_membersLister les membres de la liste
Parcourt page par page les membres d'une liste : chaque membre a email, sendable, subscribed, added_at, plus le contact complet si hydrate vaut true.
Lecture seulecontact:readcontacts_create_listCréer une liste de contacts
Crée une liste de contacts (l'id est généré sauf si list_id est fourni).
Modifie des donnéescontact:createcontacts_update_listMettre à jour une liste de contacts
Met à jour les attributs d'une liste ; seuls les args fournis changent, et null/"" efface un attribut facultatif.
Modifie des donnéescontact:updatecontacts_delete_listSupprimer une liste de contacts
Supprime une liste : elle disparaît immédiatement et ses appartenances sont retirées des contacts en arrière-plan (les contacts eux-mêmes sont conservés).
Demande confirmationcontact:deletecontacts_list_segmentsLister les segments
Liste les segments enregistrés (segment_id, name, where, sort, created_at, updated_at).
Lecture seulecontact:readcontacts_get_segmentObtenir un segment
Obtient la définition d'un segment enregistré (segment_id, name, where, sort, created_at, updated_at).
Lecture seulecontact:readcontacts_run_segmentExécuter un segment
Renvoie les contacts qui correspondent actuellement à un segment enregistré (son where + sort), paginé comme contacts_query (limit 1–1000, 50 par défaut).
Lecture seulecontact:readcontacts_save_segmentEnregistrer un segment
Crée un segment enregistré, ou remplace le name/where/sort d'un segment existant lorsque segment_id est fourni (omettre sort l'efface).
Modifie des donnéescontact:createcontacts_delete_segmentSupprimer un segment
Supprime la définition d'un segment enregistré (les contacts ne sont pas affectés).
Demande confirmationcontact:deletecontacts_upsertCréer ou mettre à jour des contacts
Crée ou met à jour jusqu'à 500 contacts par e-mail ; seuls les attributs fournis changent (null efface un attribut ou un champ du profil).
Modifie des donnéescontact:createcontact:updatecontacts_updateMettre à jour des contacts existants
Identique à contacts_upsert mais ne crée jamais : les e-mails sans contact échouent avec NOT_FOUND.
Modifie des donnéescontact:updatecontacts_add_tagsAjouter des tags aux contacts
Ajoute des tags à jusqu'à 500 contacts existants.
Modifie des donnéescontact:updatecontacts_remove_tagsRetirer des tags des contacts
Retire des tags de jusqu'à 500 contacts existants.
Demande confirmationcontact:updatecontacts_add_to_listsAjouter des contacts aux listes
Ajoute jusqu'à 500 contacts existants à une ou plusieurs listes (comme membres abonnés).
Modifie des donnéescontact:updatecontacts_remove_from_listsRetirer des contacts des listes
Retire jusqu'à 500 contacts existants d'une ou plusieurs listes (supprime l'appartenance ; pour la garder mais arrêter les envois, utilisez contacts_set_list_subscription).
Demande confirmationcontact:updatecontacts_set_list_subscriptionDéfinir l'abonnement à la liste
Abonne ou désabonne jusqu'à 500 contacts au sein d'une liste (l'appartenance est conservée ; les membres désabonnés ne reçoivent plus d'envois de cette liste).
Modifie des donnéescontact:updatecontacts_set_statusDéfinir le statut du contact
Définit le statut global de jusqu'à 500 contacts (subscribed, unsubscribed, bounced, complained, blocked) ; seuls les contacts subscribed peuvent recevoir des envois.
Modifie des donnéescontact:updatecontacts_set_fieldsDéfinir des valeurs de champs personnalisés
Définit des valeurs de champs personnalisés sur jusqu'à 500 contacts (les mêmes valeurs pour tous).
Modifie des donnéescontact:updatecontacts_unset_fieldsEffacer des valeurs de champs personnalisés
Retire des valeurs de champs personnalisés (par key) de jusqu'à 500 contacts ; les définitions des champs restent.
Demande confirmationcontact:updatecontacts_deleteSupprimer des contacts
Supprime définitivement jusqu'à 500 contacts (profil, champs, tags, appartenances aux listes).
Demande confirmationcontact:delete
Préférences de suivi
5privacy_get_preferencesObtenir les préférences de suivi du destinataire
Renvoie la préférence de suivi des ouvertures/clics choisie par un destinataire (via la page de confidentialité, le dashboard ou l'API).
Lecture seuleprivacy:readprivacy_get_manyObtenir les préférences de suivi de plusieurs destinataires
Consultation groupée des préférences de suivi des ouvertures/clics pour 1 à 100 destinataires.
Lecture seuleprivacy:readprivacy_get_historyObtenir l'historique des préférences du destinataire
Renvoie l'historique des modifications des préférences de suivi d'un destinataire, les plus récentes en premier.
Lecture seuleprivacy:readprivacy_list_changesLister les modifications des préférences de suivi
Flux incrémental de toutes les modifications de préférences des destinataires du compte (les plus anciennes en premier, 90 derniers jours), pour synchroniser un CRM.
Lecture seuleprivacy:readprivacy_set_preferencesDéfinir les préférences de suivi du destinataire
Enregistre le choix de suivi des ouvertures et/ou des clics d'un destinataire (source "api") ; un champ omis garde sa valeur actuelle, et au moins un des champs track_opens/track_clicks est requis.
Modifie des donnéesprivacy:write
Validation d'e-mails
5validator_validate_emailValider une adresse e-mail
Valide entièrement une adresse e-mail (syntaxe, domaine/MX, jetable, faute de frappe et vérification de délivrabilité SMTP en direct) ; coûte 1 crédit de validation (les résultats en cache sous 5 min sont aussi facturés) et peut prendre jusqu'à ~40 s.
Modifie des donnéestools:validatevalidator_validate_emailsValider un lot d'e-mails
Valide entièrement jusqu'à 50 adresses e-mail en un appel (mêmes vérifications que validator_validate_email, SMTP compris) ; peut prendre jusqu'à ~110 s.
Modifie des donnéestools:validatevalidator_list_validationsLister les validations passées
Liste l'historique des validations d'e-mails du compte, les plus récentes en premier, avec un filtre facultatif sur une adresse e-mail ; gratuit (sans crédits).
Lecture seuletools:validatevalidator_check_disposableVérifier un domaine d'e-mail jetable
Vérifie si une adresse e-mail ou un domaine appartient à un fournisseur d'e-mails jetables/temporaires (vérifications DNS et réputation, sans SMTP) ; passez email ou domain (au moins un).
Modifie des donnéestools:validatevalidator_list_disposable_checksLister les vérifications de jetables passées
Liste l'historique des vérifications de jetables du compte, les plus récentes en premier ; gratuit (sans crédits).
Lecture seuletools:validate
Envoyer un e-mail
2email_sendEnvoyer un e-mail transactionnel
Envoie un e-mail transactionnel via l'Email API de Sendcorex (identique à POST /v3.0/send) : validation, anti-spam, crédits (1 par destinataire) et limite quotidienne, suivi, listes de contacts, programmation.
Demande confirmationemail:sendemail_cancel_scheduledAnnuler un e-mail programmé
Annule un e-mail programmé avec email_send + scheduled_at, avant son envoi.
Modifie des donnéesemail:send