mail.activity: fields, relations and API
The mail.activity model ("Activity") is a persistent model declared by the Discuss module, then extended by 3 other modules. It exposes 33 fields, 27 of them declared directly on the model. 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.activity- Label
- Activity
- Type
- Persistent (models.Model)
- SQL table
mail_activity- Origin module
- Discuss (
mail) - Extended by
- calendar, crm, website_slides
- Default order (_order)
date_deadline ASC, id ASC- Display field (_rec_name)
summary
Model fields
27 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
33 of 33 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| active | Active | boolean | |
| activity_category | Activity Category | selection | read-only related: |
| activity_decoration | Activity Decoration | selection | read-only related: |
| activity_type_id | Activity Type | many2one | |
| attachment_ids | Attachments | many2many | |
| automated | Automated activity Indicates this activity has been created automatically and not by any user. | boolean | read-only |
| calendar_event_id | Calendar Meeting | many2one | added by Calendar ( |
| can_write | Can Write | boolean | computed |
| chaining_type | Chaining Type | selection | read-only related: |
| date_deadline | Due Date | date | required |
| date_done | Done Date | date | computed, stored |
| feedback | Feedback | text | |
| has_recommended_activities | Next activities available | boolean | computed |
| icon | Icon | char | read-only related: |
| mail_template_ids | Mail Template | many2many | read-only related: |
| note | Note | html | |
| previous_activity_type_id | Previous Activity Type | many2one | read-only |
| recommended_activity_type_id | Recommended Activity Type | many2one | |
| request_partner_id | Requesting Partner | many2one | added by eLearning ( |
| res_id | Related Document ID | many2one_reference | |
| res_model | Related Document Model | char | read-only related: |
| res_model_id | Document Model | many2one→ ir.model | |
| res_name | Document Name | char | read-onlycomputed, stored |
| state | State | selection | computed Values: |
| summary | Summary | char | |
| user_id | Assigned to | many2one | |
| user_tz | Timezone | selection | related: |
| 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
- calendar.event: calendar_event_id
- ir.attachment: attachment_ids
- ir.model: res_model_id
- mail.activity.type: activity_type_id, previous_activity_type_id, recommended_activity_type_id
- mail.template: mail_template_ids
- res.partner: request_partner_id
- res.users: user_id
Fields of other models pointing here
No Many2one or Many2many field of another model points to this model.
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.activity/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["summary","date_deadline","state","activity_type_id","calendar_event_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.activity/search_read",
headers=headers,
json={"domain": [], "fields": ["summary","date_deadline","state","activity_type_id","calendar_event_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-activity">mail.activity (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.