Odoo 19.0 Community · Persistant

mailing.list : champs, relations et API

Le modèle mailing.list (« Liste de diffusion ») est un modèle persistant déclaré par le module E-mail Marketing, puis enrichi par 1 autre module. Il expose 21 champs, dont 15 déclarés directement sur le modèle ; 10 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: mailing.list
Libellé: Liste de diffusion
Type: Persistant (models.Model)
Table SQL: mailing_list
Module d'origine: E-mail Marketing (mass_mailing)
Étendu par: mass_mailing_sms
Tri par défaut (_order): create_date DESC

Champs du modèle

15 champs propres, 0 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

21 champs affichés sur 21

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
contact_count	Nombre de contacts	`integer`	calculé
contact_count_blacklisted	Nombre de contacts sur liste noire	`integer`	calculé
contact_count_email	Nombre d'e-mails	`integer`	calculé
contact_count_opt_out	Nombre de désinscrits	`integer`	calculé
contact_count_sms	Contacts SMS	`integer`	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
contact_ids	Listes de diffusion	`many2many` → mailing.contact
contact_pct_blacklisted	Pourcentage de contacts sur liste noire	`float`	calculé
contact_pct_bounce	Pourcentage de rebondis	`float`	calculé
contact_pct_opt_out	Pourcentage de désinscrits	`float`	calculé
is_public	Afficher dans préférences La liste de diffusion est accessible pour les destinataires depuis la page de gestion des abonnements, où ils peuvent mettre à jour leurs préférences.	`boolean`
mailing_count	Nombre d'envois	`integer`	calculé
mailing_ids	E-mail Marketing	`many2many` → mailing.mailing
name	Liste de diffusion	`char`	requis
subscription_ids	Informations relatives aux inscriptions	`one2many` → mailing.subscription	inverse : `list_id`
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

mailing.contact : contact_ids
mailing.mailing : mailing_ids
mailing.subscription : subscription_ids

Champs d'autres modèles qui pointent ici

mail.compose.message : mailing_list_ids
mailing.contact : list_ids
mailing.contact.import : mailing_list_ids
mailing.contact.to.list : mailing_list_id
mailing.list.merge : dest_list_id, src_list_ids
mailing.mailing : contact_list_ids
mailing.subscription : list_id
res.config.settings : newsletter_id
website : newsletter_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/mailing.list/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","active","is_public"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

res = requests.post(
    f"{BASE_URL}/mailing.list/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","active","is_public"], "limit": 5},
)
res.raise_for_status()
print(res.json())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/mailing-list">mailing.list (Odoo 19.0)</a>

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo