mailing.contact: fields, relations and API
The mailing.contact model ("Mailing Contact") is a persistent model declared by the Email Marketing module, then extended by 1 other module. It exposes 39 fields, 11 of them declared directly on the model; 3 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.contact- Label
- Mailing Contact
- Type
- Persistent (models.Model)
- SQL table
mailing_contact- Origin module
- Email Marketing (
mass_mailing) - Extended by
- mass_mailing_sms
- Default order (_order)
name ASC, id DESC- Inherits from (mixins)
- mail.thread.blacklistproperties.base.definition.mixinmail.thread.phone
Model fields
11 own fields, 22 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
39 of 39 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| company_name | Company Name | char | |
| country_id | Country | many2one | |
char | |||
| first_name | First Name | char | |
| last_name | Last Name | char | |
| list_ids | Mailing Lists | many2many | |
| mobile | Mobile | char | added by SMS Marketing ( |
| name | Name | char | computed, stored |
| opt_out | Opt Out Opt out flag for a specific mailing list. This field should not be used in a view without a unique and active mailing list context. | boolean | computed |
| subscription_ids | Subscription Information | one2many | inverse: |
| tag_ids | Tags | many2many | |
| email_normalized | Normalized Email This field is used to search on email address as the primary email field can contain more than strictly an email address. | char | computed, stored inherited from mail.thread.blacklist |
| has_message | Has Message | boolean | computed inherited from mail.thread |
| is_blacklisted | Blacklist If the email address is on the blacklist, the contact won't receive mass mailing anymore, from any list | boolean | computed inherited from mail.thread.blacklist |
| message_attachment_count | Attachment Count | integer | computed inherited from mail.thread |
| message_bounce | Bounce Counter of the number of bounced emails for this contact | integer | inherited from mail.thread.blacklist |
| message_follower_ids | Followers | one2many | inverse: inherited from mail.thread |
| message_has_error | Message Delivery error If checked, some messages have a delivery error. | boolean | computed inherited from mail.thread |
| message_has_error_counter | Number of errors Number of messages with delivery error | integer | computed inherited from mail.thread |
| message_has_sms_error | SMS Delivery error If checked, some messages have a delivery error. | boolean | computed inherited from mail.thread |
| message_ids | Messages | one2many | inverse: inherited from mail.thread |
| message_is_follower | Is Follower | boolean | computed inherited from mail.thread |
| message_needaction | Action Needed If checked, new messages require your attention. | boolean | computed inherited from mail.thread |
| message_needaction_counter | Number of Actions Number of messages requiring action | integer | computed inherited from mail.thread |
| message_partner_ids | Followers (Partners) | many2many | computed inherited from mail.thread |
| phone_blacklisted | Blacklisted Phone is Phone Indicates if a blacklisted sanitized phone number is a phone number. Helps distinguish which number is blacklisted when there is both a mobile and phone field in a model. | boolean | computed inherited from mail.thread.phone |
| phone_mobile_search | Phone Number | char | inherited from mail.thread.phone |
| phone_sanitized | Sanitized Number Field used to store sanitized phone number. Helps speeding up searches and comparisons. | char | computed, stored inherited from mail.thread.phone |
| phone_sanitized_blacklisted | Phone Blacklisted If the sanitized phone number is on the blacklist, the contact won't receive mass mailing sms anymore, from any list | boolean | computed inherited from mail.thread.phone |
| properties | Properties | properties | inherited from properties.base.definition.mixin |
| properties_base_definition_id | Properties Base Definition | many2one | computed inherited from properties.base.definition.mixin |
| rating_ids | Ratings | one2many | inverse: inherited from mail.thread |
| website_message_ids | Website Messages Website communication history | one2many | inverse: inherited from mail.thread |
| 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.list: list_ids
- mailing.subscription: subscription_ids
- res.country: country_id
- res.partner.category: tag_ids
Fields of other models pointing here
- mailing.contact.to.list: contact_ids
- mailing.list: contact_ids
- mailing.subscription: contact_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.contact/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","country_id","company_name","email","first_name"],"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.contact/search_read",
headers=headers,
json={"domain": [], "fields": ["name","country_id","company_name","email","first_name"], "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-contact">mailing.contact (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.