API Endpoint(s) and/or Zoom API Event(s) List the calendars in the user’s own calendarList
GET /calendars/users/{userIdentifier}/calendarList
Description
I am encountering a persistent 401 Unauthorized error when calling the listCalendarLists endpoint, even though my OAuth token is freshly generated and contains the required scopes.
API Endpoint: GET /v2/users/{userId}/calendar/calendarLists
Technical Details:
App Type: General User-managed OAuth App (Admin-approved for the account)
Scopes associated with the token: user:read:user meeting:read:list_meetings meeting:read:meeting meeting:read:summary meeting:read:past_meeting meeting:read:list_past_participants meeting:read:participant meeting:read:list_upcoming_meetings meeting:read:meeting_audio meeting:read:meeting_transcript cloud_recording:read:list_user_recordings cloud_recording:read:list_recording_files cloud_recording:read:meeting_transcript calendar:read:list_calendar_lists calendar:read:event calendar:read:list_events calendar:read:instance_event calendar:read:calendar_list calendar:read:calendar meeting:read:assets
How To Reproduce curl ‘``https://api.zoom.us/v2/calendars/users/me/calendarList?maxResults=250&minAccessRole=reader&showDeleted=false&showHidden=false’`` –header ‘Authorization: Bearer TOKEN’
Troubleshooting Steps Taken:
Verified the token is fresh and includes the calendar:read:list_calendar_lists scope in the response payload.
Tested with both the me context and the explicit userId.
Confirmed other endpoints (like /v2/users/me) work correctly with this same token, confirming the token itself is valid for the General API.
Confirmed “Calendar and Contact Integration” is enabled for the user/account. Google calendar connected.
Hi @chunsiong.zoom , I have checked and Zoom Mail and Calendar is already enabled for my account.
Moreover, I mentioned earlier that the Calendar and Contacts Integration is also enabled and my Google account is connected. But even with all this the API seems to throw the same “Invalid token payload” error.
@Rani The Calender API provides access to Zoom’s native Calender service. I see that in your account, you are connect to Google’s Calender Service. There are 2 separate services.
You have the license for Zoom Calendar, but it is not enabled. I believe you are using Google’s Workspace for your organization.
When I visit my profile alpha-sense.zoom.us/profile, I can see that “Zoom Mail and Calendar” shows as Enabled. Could you please confirm whether this is the correct setting? If not, could you guide us on the steps required to fully enable the service?
Could you clarify which of these services allows access to all calendar events, including third-party events?
Based on the introduction section of the Calendar API documentation: developers.zoom.us/docs/api/calendar/#description/introduction , it states that the Calendar APIs should allow access to all events, including third-party calendar events. The documentation mentions that:
The Calendar APIs allow developers to interface with Zoom Calendar features programmatically. These APIs enable applications to manage calendar events, automate scheduling, sync across platforms, and integrate Zoom Calendar with third-party apps for seamless event management.
Could you please confirm whether the APIs support retrieving all synced third-party calendar events, or only events created directly within Zoom?