curl --request GET \
--url https://api.example.com/activities/meetings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/activities/meetings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/activities/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/activities/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/activities/meetings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/activities/meetings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/activities/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}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.
curl --request GET \
--url https://api.example.com/activities/meetings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/activities/meetings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/activities/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/activities/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/activities/meetings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/activities/meetings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/activities/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}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:| Field | Type | Description |
|---|---|---|
id | string (uuid) | Primary key. |
type | string | Always "meeting" on this endpoint. |
subject | string | null | Meeting title. |
body | string | null | Free-text notes. |
due_at | string | null (timestamptz) | Scheduled time. |
completed_at | string | null (timestamptz) | When the meeting was marked done, if applicable. |
duration_minutes | integer | null | Meeting length. |
metadata | object | null (jsonb) | Free-form. When populated by a connected calendar/video integration it typically carries {"transcript", "recording_url", "attendees": [{"name","email"}], "started_at", "ended_at", "location", "provider"}, but manual logging (via ActivityBody) only ever writes transcript, recording_url, attendees, location, and provider — there’s no field for started_at/ended_at on manual entries, so those two keys only appear on synced rows. |
account_id | string | null (uuid) | Linked account. |
deal_id | string | null (uuid) | Linked deal. |
contact_id | string | null (uuid) | Linked contact. |
owner_id | string | null | Logto user sub of the owning rep. |
source | string | manual, import, or a sync source (calendar, gmail, outlook, slack, teams). |
direction | string | null | Not typically meaningful for meetings; carried over from the shared select. |
created_at | string (timestamptz) | Row creation time. |
accounts | object | null | Embedded: { id, name, domain }. null if account_id is unset. |
deals | object | null | Embedded: { id, name, stage_id }. null if deal_id is unset. |
contacts | object | null | Embedded: { id, first_name, last_name, email }. null if contact_id is unset. |
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