list_meetings: Get List of Meetings for a User

Description

Get list of meetings for a User. This function retrieves meeting IDs and UUIDs to pass into other functions for detailed analysis.

Usage

list_meetings(
  user_id,
  account_id,
  client_id,
  client_secret,
  meeting_type = "previous_meetings",
  page_size = 300
)

Value

A data frame with meetings hosted by the specified user. The meetings_type column contains integer codes describing the meeting structure/format, while meeting_format_label provides human-readable descriptions:

1 = Instant meeting
2 = Scheduled meeting
3 = Recurring meeting (no fixed time)
8 = Recurring meeting (fixed time)
10 = Screen share only meeting

Arguments

user_id

Zoom User ID or email address.

account_id

Account ID granted by the Zoom developer app.

client_id

Client ID granted by the Zoom developer app.

client_secret

Client secret granted by the Zoom developer app.

meeting_type

Type of meetings to retrieve. Options are:

"previous_meetings" = All previous meetings (default)
"scheduled" = All valid previous, live, and upcoming scheduled meetings
"upcoming" = All upcoming meetings, including live meetings
"upcoming_meetings" = All upcoming meetings, including live meetings
"live" = Currently ongoing meetings

page_size

Number of records per page. Maximum 300, default 300.

Details

Important Limitations:

6-month historical limit: When using "upcoming", "upcoming_meetings", or "previous_meetings", only meetings from the last 6 months are returned
Scheduled meetings only: Does not return instant meetings
Unexpired meetings only: Only returns meetings that haven't expired

For Enhanced Historical Data Access: Users with Pro+ Zoom accounts can access the Reports API endpoint /report/users/{userId}/meetings which offers:

Date range filtering with from and to parameters
Enhanced meeting details including participant information
Better historical data retrieval capabilities

Examples

Run this code

if (FALSE) {
dat <- list_meetings(user_id = "user_id_string",
  your_account_id,
  your_client_id,
  your_client_secret,
  meeting_type = "previous_meetings")
}