List Meetings
List meetings (activities with type=‘meeting’) for the active org.
Filters: from / to (ISO 8601, applied to due_at), owner_id, account_id.
order may be ‘asc’ or ‘desc’ (applied to due_at). NULLS go last either way
so unscheduled meetings sort to the bottom.
type='meeting' across the active org, with embedded account/deal/contact summaries. Sorted by due_at (direction controlled by order), with NULLS LAST in either direction so unscheduled meetings always sort to the bottom, then by created_at descending as a tiebreaker.
Returns a bare JSON array — no total-count header, no pagination envelope. limit is capped at 500 server-side.
unlinked_account=true together with an explicit account_id, or unlinked_deal=true with deal_id, sends the same PostgREST query key twice (eq.<id> and is.null), which is a self-contradicting AND — you get an empty result, not an error.Auth
Requires a CRM read scope and an active organization on the token. Any ofcontacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.
Response
Array of meeting objects:Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Only return meetings with due_at on or after this ISO 8601 timestamp — filters due_at, not effective_time.
Only return meetings with due_at on or before this ISO 8601 timestamp — filters due_at, not effective_time.
Filter to meetings owned by this user's id.
Filter to meetings linked to this account.
Filter to meetings linked to this deal.
If true, only return meetings with no account_id. Combining with an explicit account_id filter yields an empty result.
If true, only return meetings with no deal_id. Combining with an explicit deal_id filter yields an empty result.
Sort direction for due_at, compared case-insensitively: 'asc' (any capitalization) sorts ascending, anything else sorts descending. Meetings with no due_at always sort last.
Maximum rows to return; capped at 500 server-side.
Number of rows to skip, for pagination.
Response
Successful Response