Skip to main content
POST
Start connecting a Google Calendar

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input for starting a Google Calendar connection.

label
string
required

Customer-facing name for the connection, unique within the project. Decided now because the consent screen has nowhere to carry it.

Required string length: 1 - 120
timezone
string | null

The named IANA timezone to offer slots in, for example America/Los_Angeles. Omit to adopt the Google account’s own. A fixed offset such as -08:00 is rejected: it does not observe DST.

Minimum string length: 1
loginHint
string<email> | null

The Google account to preselect on the consent screen. A hint only: it is ignored if the user is signed into another account, and nothing is authorized by it.

Response

A URL to open, and when it stops working.

data
CalendarOauthStart · object
required