Skip to main content
GET
/
v4
/
calendar-connections
/
auth
/
{provider}
/
url
Get OAuth authorization URL
curl --request GET \
  --url https://api.example.com/v4/calendar-connections/auth/{provider}/url \
  --header 'x-meetergo-api-user-id: <api-key>'
{
  "authUrl": "https://accounts.google.com/oauth/authorize?client_id=...",
  "provider": "google"
}

Authorizations

​
x-meetergo-api-user-id
string
header
required

User ID to act as when using API Key authentication (required with API Key)

Path Parameters

​
provider
enum<string>
required

Calendar provider to connect (google, outlook)

Available options:
google,
outlook,
icloud,
caldav,
exchange,
smart-we,
ics

Query Parameters

​
redirectUrl
string

URL to redirect to after OAuth completion (defaults to frontend URL)

Example:

"https://yourapp.com/calendar-success"

​
userId
string

User ID to connect for (admin only - connects calendar for specified user)

Example:

"user-uuid"

​
setAsCalendarSync
boolean

Whether to automatically set this connection as the calendar sync provider after successful OAuth. If the user already has a calendar sync provider, this will be ignored.

Example:

true

Response

200 - application/json

Authorization URL generated successfully

​
authUrl
string

OAuth authorization URL to redirect user to

Example:

"https://accounts.google.com/oauth/authorize?client_id=..."

​
provider
enum<string>

Calendar provider

Available options:
google,
outlook,
icloud,
caldav,
exchange,
smart-we,
ics
Example:

"google"