Skip to content

Connect a conferencing provider (link-based / no-OAuth only)

POST
/appointments/conferencing/connect/{provider}

Connect a conferencing provider that does not require a browser OAuth flow. Supported providers: google_meet, roam, roam_auto, whereby, jitsi. Zoom and office365_video (Teams) are excluded - they require a browser OAuth redirect that cannot be completed via an API key.

google_meet: clears the google_meet_suppressed flag (requires an existing google_calendar credential - no credential row is created for Meet itself).

roam, whereby, jitsi: creates a credential row; optional link is the meeting URL validated against the provider’s URL pattern.

roam_auto: creates a stub credential row (no OAuth tokens - the Roam Auto integration requires a prior OAuth flow to be completed in the web app).

Authorizations

Parameters

Path Parameters

provider
required

Provider: google_meet | roam | roam_auto | whereby | jitsi

string

Provider: google_meet | roam | roam_auto | whereby | jitsi

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body

object
link
Any of:
string

Responses

201

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string