Odoo 19.0 Community · Persistent

mail.guest: fields, relations and API

The mail.guest model ("Guest") is a persistent model declared by the Discuss module. It exposes 26 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.

View source code Search another model

Model identity

Technical name: mail.guest
Label: Guest
Type: Persistent (models.Model)
SQL table: mail_guest
Origin module: Discuss (mail)
Inherits from (mixins): avatar.mixin bus.listener.mixin

Model fields

10 own fields, 10 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

26 of 26 fields shown

Technical name	Label	Type	Details
access_token	Access Token	`char`	requiredread-only
channel_ids	Channels	`many2many` → discuss.channel
country_id	Country	`many2one` → res.country
email	Email	`char`
im_status	IM Status	`char`	computed
lang	Language	`selection`	Values computed at runtime
name	Name	`char`	required
offline_since	Offline since	`datetime`	computed
presence_ids	Presence	`one2many` → mail.presence	inverse: `guest_id`
timezone	Timezone	`selection`	Values computed at runtime
avatar_1024	Avatar 1024	`image`	computed inherited from avatar.mixin
avatar_128	Avatar 128	`image`	computed inherited from avatar.mixin
avatar_1920	Avatar	`image`	computed inherited from avatar.mixin
avatar_256	Avatar 256	`image`	computed inherited from avatar.mixin
avatar_512	Avatar 512	`image`	computed inherited from avatar.mixin
image_1024	Image 1024	`image`	related: `image_1920` inherited from image.mixin
image_128	Image 128	`image`	related: `image_1920` inherited from image.mixin
image_1920	Image	`image`	inherited from image.mixin
image_256	Image 256	`image`	related: `image_1920` inherited from image.mixin
image_512	Image 512	`image`	related: `image_1920` inherited from image.mixin
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	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` → res.users	read-onlyautomatic

Relations

Models linked from this model

discuss.channel: channel_ids
mail.presence: presence_ids
res.country: country_id

Fields of other models pointing here

discuss.channel: livechat_customer_guest_ids
discuss.channel.member: guest_id
discuss.channel.rtc.session: guest_id
im_livechat.channel.member.history: guest_id
mail.message: author_guest_id
mail.message.reaction: guest_id
mail.presence: guest_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

curl -X POST "https://your-instance.odoo.com/json/2/mail.guest/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","access_token","country_id","email","lang"],"limit":5}'

Python (requests)

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.guest/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","access_token","country_id","email","lang"], "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-guest">mail.guest (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.