mailing.list: fields, relations and API
The mailing.list model ("Mailing List") is a persistent model declared by the Email Marketing module, then extended by 1 other module. It exposes 21 fields, 15 of them declared directly on the model; 10 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.
Model identity
- Technical name
mailing.list- Label
- Mailing List
- Type
- Persistent (models.Model)
- SQL table
mailing_list- Origin module
- Email Marketing (
mass_mailing) - Extended by
- mass_mailing_sms
- Default order (_order)
create_date DESC
Model fields
15 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
21 of 21 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| active | Active | boolean | |
| contact_count | Number of Contacts | integer | computed |
| contact_count_blacklisted | Number of Blacklisted | integer | computed |
| contact_count_email | Number of Emails | integer | computed |
| contact_count_opt_out | Number of Opted-out | integer | computed |
| contact_count_sms | SMS Contacts | integer | computed added by SMS Marketing ( |
| contact_ids | Mailing Lists | many2many | |
| contact_pct_blacklisted | Percentage of Blacklisted | float | computed |
| contact_pct_bounce | Percentage of Bouncing | float | computed |
| contact_pct_opt_out | Percentage of Opted-out | float | computed |
| is_public | Show In Preferences The mailing list can be accessible by recipients in the subscription management page to allow them to update their preferences. | boolean | |
| mailing_count | Number of Mailing | integer | computed |
| mailing_ids | Mass Mailings | many2many | |
| name | Mailing List | char | required |
| subscription_ids | Subscription Information | one2many | inverse: |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | read-onlyautomatic |
| display_name | Display Name | char | read-onlycomputedautomatic |
| id | ID | integer | read-onlyautomatic |
| write_date | Last Updated on | datetime | read-onlyautomatic |
| write_uid | Last Updated by | many2one | read-onlyautomatic |
Relations
Models linked from this model
- mailing.contact: contact_ids
- mailing.mailing: mailing_ids
- mailing.subscription: subscription_ids
Fields of other models pointing here
- 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
Reading this model through the API
Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.
curl -X POST "https://your-instance.odoo.com/json/2/mailing.list/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","active","is_public"],"limit":5}'import requests
BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}
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())- External API access requires Odoo's Custom plan.
- XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
- The access rights and record rules of the key's user apply.
Cite this tool
Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.
<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/mailing-list">mailing.list (Odoo 19.0)</a>Sources
Data verified on September 23, 2026 · Odoo 19.0 Community
Have an Odoo project, or want to put your ERP to work with AI? Let's talk
Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.