Skip to main content
GET
List Meetings
Lists activities with 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.
Passing a linked-filter together with its matching id-filter matches nothing: 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 of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Array of meeting objects:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from
string | null

Only return meetings with due_at on or after this ISO 8601 timestamp — filters due_at, not effective_time.

to
string | null

Only return meetings with due_at on or before this ISO 8601 timestamp — filters due_at, not effective_time.

owner_id
string | null

Filter to meetings owned by this user's id.

account_id
string | null

Filter to meetings linked to this account.

deal_id
string | null

Filter to meetings linked to this deal.

unlinked_account
boolean
default:false

If true, only return meetings with no account_id. Combining with an explicit account_id filter yields an empty result.

unlinked_deal
boolean
default:false

If true, only return meetings with no deal_id. Combining with an explicit deal_id filter yields an empty result.

order
string
default:desc

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.

limit
integer
default:200

Maximum rows to return; capped at 500 server-side.

offset
integer
default:0

Number of rows to skip, for pagination.

Response

Successful Response