Get a connect link

GET
/v1/calendar/connect

Returns the link the person opens to connect Google Calendar or an Outlook calendar. They sign in on the provider's own page; VoiceLayer never sees their password. Connecting again, or approving one more permission, uses the same link.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Query Parameters

app*string

Which calendar to connect: google or outlook.

Value in"google""outlook"

Response Body

The link to open and what to do with it

application/json
  1. response
url*string
app*string
summary*string
Example Request
curl "https://api.vlayers.ai/v1/calendar/connect?app=google" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "url": "https://vlayers.ai/dashboard/connections/connect/google-calendar",  "app": "Google Calendar",  "summary": "Open this link and sign in to Google Calendar; it takes under a minute and I can use it right after: https://vlayers.ai/dashboard/connections/connect/google-calendar"}