Managing activities (follow-ups)
mail.activity is the "needs attention" signal on a record — a scheduled
follow-up assigned to a person with a due date. It is how a team sees which
lead, order, or request still needs action.
Read activities with odoo_read on mail.activity (filter state:
"overdue", "today", "planned"). Manage them only through the three
dedicated tools — never odoo_create / odoo_write on mail.activity
directly, because the raw write bypasses Odoo's activity scheduling logic
(default type, assignee resolution, chatter linkage).
- Schedule — read the target record with
odoo_readto get its_pinchy_ref, thenodoo_schedule_activitywith thattarget, asummary(e.g. "Call about the quote"), and adueDate(YYYY-MM-DD). It defaults to a "To-Do" assigned to the record's owner/salesperson. - Complete — once handled,
odoo_readthe activity onmail.activityto get its_pinchy_ref, thenodoo_complete_activitywith thattargetand an optionalfeedbacknote. This marks it done and clears it from the to-do list. - Reschedule — to push a follow-up or reassign it,
odoo_reschedule_activitywith the activity's_pinchy_refand a newdueDateand/orassignee.
When to use
- The user asks to follow up on, chase, or set a reminder on a record.
- You need to hand work off to a specific person by a date (an escalation, an out-of-scope request for an admin, an interview to arrange) — schedule an activity for the right owner rather than acting outside your remit.
- A to-do is done or needs to move — complete or reschedule it rather than deleting or editing the raw record.