mail.alias: fields, relations and API
The mail.alias model ("Email Aliases") is a persistent model declared by the Discuss module, then extended by 1 other module. It exposes 19 fields, 13 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.alias- Label
- Email Aliases
- Type
- Persistent (models.Model)
- SQL table
mail_alias- Origin module
- Discuss (
mail) - Extended by
- hr
- Default order (_order)
alias_model_id, alias_name- Display field (_rec_name)
alias_name
Model fields
13 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
19 of 19 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| alias_bounced_content | Custom Bounced Message If set, this content will automatically be sent out to unauthorized users instead of the default message. | html | translatable |
| alias_contact | Alias Contact Security Policy to post a message on the document using the mailgateway. - everyone: everyone can post - partners: only authenticated partners - followers: only followers of the related document or members of following channels | selection | required Values: |
| alias_defaults | Default Values A Python dictionary that will be evaluated to provide default values when creating new records for this alias. | text | required |
| alias_domain | Alias domain name | char | related: |
| alias_domain_id | Alias Domain | many2one | |
| alias_force_thread_id | Record Thread ID Optional ID of a thread (record) to which all incoming messages will be attached, even if they did not reply to it. If set, this will disable the creation of new records completely. | integer | |
| alias_full_name | Alias Email | char | computed, stored |
| alias_incoming_local | Local-part based incoming detection | boolean | |
| alias_model_id | Aliased Model The model (Odoo Document Kind) to which this alias corresponds. Any incoming email that does not reply to an existing record will cause the creation of a new record of this model (e.g. a Project Task) | many2one→ ir.model | required |
| alias_name | Alias Name The name of the email alias, e.g. 'jobs' if you want to catch emails for <[email protected]> | char | |
| alias_parent_model_id | Parent Model Parent model holding the alias. The model holding the alias reference is not necessarily the model given by alias_model_id (example: project (parent_model) and task (model)) | many2one→ ir.model | |
| alias_parent_thread_id | Parent Record Thread ID ID of the parent record holding the alias (example: project holding the task creation alias) | integer | |
| alias_status | Alias Status Alias status assessed on the last message received. | selection | computed, stored Values: |
| 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
- ir.model: alias_model_id, alias_parent_model_id
- mail.alias.domain: alias_domain_id
Fields of other models pointing here
- crm.team: alias_id
- hr.job: alias_id
- hr.recruitment.source: alias_id
- mail.alias.mixin: alias_id
- mail.alias.mixin.optional: alias_id
- maintenance.team: alias_id
- project.project: alias_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.alias/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["alias_name","alias_contact","alias_defaults","alias_model_id","alias_domain_id"],"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.alias/search_read",
headers=headers,
json={"domain": [], "fields": ["alias_name","alias_contact","alias_defaults","alias_model_id","alias_domain_id"], "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-alias">mail.alias (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.