OQL Β· Entities
Meetings
OQL field reference for meetings. Logged meetings with contacts, including location.
Last updated Jul 16, 2026
Meetings are logged meetings with contacts, including location and free-text notes.
Fields
Legend: F filterable, S sortable, A aggregatable, G groupable.
| Field | Type | F | S | A | G | Description |
|---|---|---|---|---|---|---|
id | ID | Y | β | β | β | Meeting ID |
text | string | β | β | β | β | Meeting notes (select only) |
contact_id | ID | Y | β | β | Y | Associated contact ID |
author | string | β | β | β | β | Author display name (select only) |
author_id | ID | Y | β | β | Y | Author user ID |
place | string | Y | β | β | β | Meeting location (max 100 chars) |
meeting_time | time | Y | Y | β | Y | When the meeting occurred |
created_at | time | Y | Y | β | Y | Record creation timestamp |
modified_at | time | Y | Y | β | Y | Last modification timestamp |
Notes
textis select-only β OQL has no full-text search over meeting notes.placeis freeform. There is no enum or place lookup.- Lookups:
contact(viacontact_id). Reference the contactβs fields inline ascontact.<field>inselect,where, andorder_by. See Concepts βΊ Lookups.
Example queries
My meetings this week:
{
"from": "meetings",
"where": {
"author_id": "ME()",
"meeting_time": { ">=": "THIS_WEEK()" }
},
"order_by": [{ "meeting_time": "asc" }]
}
Meeting count by author this quarter:
{
"from": "meetings",
"select": ["author_id", "count()"],
"where": { "meeting_time": { ">=": "THIS_QUARTER()" } },
"group_by": ["author_id"]
}
All meetings on a specific contact:
{
"from": "meetings",
"where": { "contact_id": "507f1f77bcf86cd799439011" },
"order_by": [{ "meeting_time": "desc" }]
}