mail.group: fields, relations and API
The mail.group model ("Mail Group") is a persistent model declared by the Mail Group module, then extended by 1 other module. It exposes 37 fields, 25 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
mail.group- Label
- Mail Group
- Type
- Persistent (models.Model)
- SQL table
mail_group- Origin module
- Mail Group (
mail_group) - Extended by
- website_mail_group
- Default order (_order)
is_closed ASC, create_date DESC, id DESC- Inherits from (mixins)
- mail.alias.mixin
Model fields
25 own fields, 6 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
37 of 37 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| access_group_id | Authorized Group | many2one | |
| access_mode | Privacy | selection | required Values: |
| active | Active | boolean | |
| can_manage_group | Can Manage Can manage the members | boolean | computed |
| description | Description | text | |
| image_128 | Image | image | |
| is_closed | Is Closed Closed groups might still be accessed, but emails sent to it will bounce | boolean | |
| is_member | Is Member | boolean | computed |
| is_moderator | Moderator Current user is a moderator of the group | boolean | computed |
| mail_group_message_count | Messages Count Number of message in this group | integer | computed |
| mail_group_message_ids | Pending Messages | one2many | inverse: |
| mail_group_message_last_month_count | Messages Per Month | integer | computed |
| mail_group_message_moderation_count | Pending Messages Count Messages that need an action | integer | computed |
| member_count | Members Count | integer | computed |
| member_ids | Members | one2many | inverse: |
| member_partner_ids | Partners Member | many2many | computed |
| moderation | Moderate | boolean | |
| moderation_guidelines | Send guidelines to new members Newcomers on this moderated group will automatically receive the guidelines. | boolean | |
| moderation_guidelines_msg | Guidelines | html | |
| moderation_notify | Automatic notification People receive an automatic notification about their message being waiting for moderation. | boolean | |
| moderation_notify_msg | Notification message | html | |
| moderation_rule_count | Moderated emails count | integer | computed |
| moderation_rule_ids | Moderated Emails | one2many | inverse: |
| moderator_ids | Moderators | many2many | |
| name | Name | char | requiredtranslatable |
| alias_defaults | Alias Defaults | text | inherited from mail.alias.mixin |
| alias_domain | Alias Domain Name | char | related: inherited from mail.alias.mixin.optional |
| alias_domain_id | Alias Domain | many2one | related: inherited from mail.alias.mixin.optional |
| alias_email | Email Alias | char | computed inherited from mail.alias.mixin.optional |
| alias_id | Alias | many2one | required inherited from mail.alias.mixin |
| alias_name | Alias Name | char | inherited from mail.alias.mixin |
| 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.group.member: member_ids
- mail.group.message: mail_group_message_ids
- mail.group.moderation: moderation_rule_ids
- res.groups: access_group_id
- res.partner: member_partner_ids
- res.users: moderator_ids
Fields of other models pointing here
- mail.group.member: mail_group_id
- mail.group.message: mail_group_id
- mail.group.moderation: mail_group_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.group/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","access_mode","access_group_id","active","description"],"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.group/search_read",
headers=headers,
json={"domain": [], "fields": ["name","access_mode","access_group_id","active","description"], "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-group">mail.group (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.