Odoo 19.0 Community · Persistent

snailmail.letter: fields, relations and API

The snailmail.letter model ("Snailmail Letter") is a persistent model declared by the Snail Mail module. It exposes 30 fields, 24 of them declared directly on the model; 1 field from other models points 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: snailmail.letter
Label: Snailmail Letter
Type: Persistent (models.Model)
SQL table: snailmail_letter
Origin module: Snail Mail (snailmail)

Model fields

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

Hide inherited fields

30 of 30 fields shown

Technical name	Label	Type	Details
attachment_datas	Document	`binary`	related: `attachment_id.datas`
attachment_fname	Attachment Filename	`char`	related: `attachment_id.name`
attachment_id	Attachment	`many2one` → ir.attachment
city	City	`char`
color	Color	`boolean`
company_id	Company	`many2one` → res.company	requiredread-only
country_id	Country	`many2one` → res.country
cover	Cover Page	`boolean`
duplex	Both side	`boolean`
error_code	Error	`selection`	Values computed at runtime
info_msg	Information	`html`
message_id	Snailmail Status Message	`many2one` → mail.message
model	Model	`char`	required
notification_ids	Notifications	`one2many` → mail.notification	inverse: `letter_id`
partner_id	Recipient	`many2one` → res.partner	required
reference	Related Record	`char`	read-onlycomputed
report_template	Optional report to print and attach	`many2one` → ir.actions.report
res_id	Document ID	`integer`	required
state	Status When a letter is created, the status is 'Pending'. If the letter is correctly sent, the status goes in 'Sent', If not, it will got in state 'Error' and the error message will be displayed in the field 'Error Message'.	`selection`	requiredread-only Values: `pending` (In Queue), `sent` (Sent), `error` (Error), `canceled` (Cancelled)
state_id	State	`many2one` → res.country.state
street	Street	`char`
street2	Street2	`char`
user_id	Sent by	`many2one` → res.users
zip	Zip	`char`
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

ir.actions.report: report_template
ir.attachment: attachment_id
mail.message: message_id
mail.notification: notification_ids
res.company: company_id
res.country: country_id
res.country.state: state_id
res.partner: partner_id
res.users: user_id

Fields of other models pointing here

mail.notification: letter_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/snailmail.letter/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["company_id","model","partner_id","res_id","state"],"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}/snailmail.letter/search_read",
    headers=headers,
    json={"domain": [], "fields": ["company_id","model","partner_id","res_id","state"], "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/snailmail-letter">snailmail.letter (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.