mail.message.subtype: fields, relations and API
The mail.message.subtype model ("Message subtypes") is a persistent model declared by the Discuss module, then extended by 1 other module. It exposes 16 fields, 10 of them declared directly on the model; 7 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
mail.message.subtype- Label
- Message subtypes
- Type
- Persistent (models.Model)
- SQL table
mail_message_subtype- Origin module
- Discuss (
mail) - Extended by
- hr_holidays
- Default order (_order)
sequence, id
Model fields
10 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
16 of 16 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| default | Default Activated by default when subscribing. | boolean | |
| description | Description Description that will be added in the message posted for this subtype. If void, the name will be added instead. | text | translatable |
| internal | Internal Only Messages with internal subtypes will be visible only by employees, aka members of base_user group | boolean | |
| name | Message Type Message subtype gives a more precise type on the message, especially for system notifications. For example, it can be a notification related to a new record (New), or to a stage change in a process (Stage change). Message subtypes allow to precisely tune the notifications the user want to receive on its wall. | char | requiredtranslatable |
| parent_id | Parent Parent subtype, used for automatic subscription. This field is not correctly named. For example on a project, the parent_id of project subtypes refers to task-related subtypes. | many2one | |
| relation_field | Relation field Field used to link the related model to the subtype model when using automatic subscription on a related document. The field is used to compute getattr(related_document.relation_field). | char | |
| res_model | Model Model the subtype applies to. If False, this subtype applies to all models. | char | |
| sequence | Sequence Used to order subtypes. | integer | |
| track_recipients | Track Recipients Whether to display all the recipients or only the important ones. | boolean | |
| 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
- mail.message.subtype: parent_id
Fields of other models pointing here
- crm.activity.report: subtype_id
- hr.leave.type: allocation_notif_subtype_id, leave_notif_subtype_id
- mail.compose.message: subtype_id
- mail.followers: subtype_ids
- mail.message: subtype_id
- mail.message.subtype: parent_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/mail.message.subtype/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","parent_id","default","description","hidden"],"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}/mail.message.subtype/search_read",
headers=headers,
json={"domain": [], "fields": ["name","parent_id","default","description","hidden"], "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/mail-message-subtype">mail.message.subtype (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.