---
title: "Connect a conferencing provider (link-based / no-OAuth only)"
method: POST
path: "/appointments/conferencing/connect/{provider}"
tags: ["Appointments"]
---

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

`POST /appointments/conferencing/connect/{provider}`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/conferencing/connect/{provider}`
- Auth: HTTP bearer

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).

## Path parameters

- `provider` string, required: Provider: google_meet | roam | roam_auto | whereby | jitsi

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- BodyConnectConferencingAppointmentsConferencingConnectProviderPost
  - `link` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)