Skip to main content
Verifies the credential against the provider and, only if it works, stores it encrypted. A credential the provider rejects is a 400 and no connection is created: a connection that has never worked would next be exercised by an inbound call at 2am, with nobody there to fix it.
Calls POST /v1/integrations/calendar

​
Options

​
string
required
Who holds the calendar. CAL_COM is connected with an API key; GOOGLE is connected by consent, through POST /v1/integrations/calendar/google/authorize-url. CALENDLY is described by capabilities but not yet connectable. One of CAL_COM, GOOGLE, CALENDLY
​
string
required
Customer-facing name for this account, unique within the project. Required.
​
string
required
The provider account’s API key. For CAL_COM, a Cal.com API key (starts with cal_). It is verified against the provider before anything is stored, so an invalid key is a 400 and no connection is created. Stored encrypted and never returned.
​
string
The named IANA timezone to offer slots in, for example America/Los_Angeles. Omit to adopt the provider account’s own timezone. A fixed offset such as -08:00 is rejected: it does not observe DST.

​
Example

Every command also takes the global options and sets one of the exit codes.