MailMoo
EndpointsMeetings

List meetings

Meetings on the workspace's connected calendars, with who each one is with. Guests are matched to CRM people by email address, and their current company comes with them. Filter by time, outcome, meeting type, person, company or sender. One real-world call is one meeting, however many connected calendars carry it. Pass nextCursor back as cursor for the next page.

GET/meetings.list

Authorization

bearerAuth
AuthorizationBearer <token>

Enter your MailMoo API key (format: sk_live_...)

In: header

Query Parameters

from?string

Meetings starting at or after this time.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
to?string

Meetings starting before this time.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
outcomes?array<>
Itemsitems <= 6
meetingTypes?array<>
Itemsitems <= 12
personId?string

Only meetings this CRM person is a guest on.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
Formatuuid
companyId?string

Only meetings with someone from this company, past or present.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
Formatuuid
sdrProfileId?string

Only meetings on the calendar linked to this sender profile.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
Formatuuid
callsOnly?boolean

Only calls with a guest from outside your company. Leaves out team meetings, personal events and all-day events.

Defaultfalse
hasTranscript?boolean
search?string

Matched against the title and the guests' names and emails.

Lengthlength <= 100
order?string
Default"asc"

Value in

  • "asc"
  • "desc"
cursor?|null
limit?integer
Range1 <= value <= 100
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/meetings.list"
{  "meetings": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "title": "string",      "meetingType": "INTRO",      "startsAt": "string",      "endsAt": "string",      "allDay": true,      "timezone": "string",      "outcome": "UPCOMING",      "outcomeLabel": "string",      "moved": true,      "status": "SCHEDULED",      "attendance": "UNKNOWN",      "attendanceSource": "MANUAL",      "source": "CALENDAR_SYNC",      "meetingUrl": "string",      "location": "string",      "isRecurring": true,      "isCall": true,      "hasTranscript": true,      "openFollowUps": -9007199254740991,      "bookedBySender": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      },      "attendees": [        {          "email": "string",          "name": "string",          "responseStatus": "string",          "isOrganizer": true,          "isExternal": true,          "personId": "f3e5ff26-28ff-4cd6-9b1b-e303a185a13a",          "jobTitle": "string",          "company": {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "name": "string"          },          "matchedByName": true,          "suggestedCompany": {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "name": "string"          }        }      ]    }  ],  "nextCursor": -9007199254740991}