Skip to main content
GET
Get a calendar connection

Authorizations

Authorization
string
header
required

Your API key, sent bare. See Authentication.

Path Parameters

id
string
required

Response

The connection.

id
string

Stable typed ID beginning with cal_. Treat it as an opaque string.

object
string

Always calendar_connection.

workspace_id
string

Workspace ID, beginning with wks_. Treat it as an opaque string.

Example:

"wks_01k6a2r9s8x7c2dvq3m5n6p4ab"

member_id
string

The member whose calendar this is.

provider
enum<string>

The connected calendar.

  • google: Google Calendar.
  • microsoft: Microsoft Outlook calendar.
Available options:
google,
microsoft
status
enum<string>
  • active: syncing.
  • error: the account stopped granting access; send the member a new connect link.
  • disconnected: disconnected by you or in MeetingKit, or the member was removed.
Available options:
active,
error,
disconnected
account_email
string | null

The email of the connected Google or Microsoft account.

error
object | null

Why the connection stopped working, while status is error; otherwise null.

connected_at
string<date-time> | null

When the member last finished consent, in ISO 8601.

last_synced_at
string<date-time> | null

When the calendar last synced, in ISO 8601.

created_at
string<date-time>

When the connection was first made, in ISO 8601.