Skip to main content

List Calendar Connections

POST 
/oauth/list

Lists the authenticated user's external calendar connections: for each connected provider (Google Calendar or Microsoft Outlook), the ID of the calendar in that account that Terros writes the user's events to, and invalid, which means a Google sync has failed since the user last connected (it does not mean sync stopped). An empty connections array means no external calendar is connected, so events are not synced anywhere. Use it to answer whether a user's events reach Google or Microsoft and which calendar they land in; the event itself comes from /calendar/event/get. There is no userId parameter: to see another user's connections, make the request as that user (impersonating them needs user:login). Access tokens are never returned. calendarId is absent until the first event syncs, and the calendar's name is not stored.

Request​

Responses​

Success