---
title: "Get OAuth authorization URL"
method: GET
path: "/v4/calendar-connections/auth/{provider}/url"
tags: ["Calendar Auth V4"]
---

# Get OAuth authorization URL

`GET /v4/calendar-connections/auth/{provider}/url`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/calendar-connections/auth/{provider}/url`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

Get the OAuth authorization URL for connecting a calendar provider. The user should be redirected to this URL to complete the OAuth flow. After authorization, the provider will redirect back to the API callback endpoint.

## Path parameters

- `provider` 'google' | 'outlook' | 'icloud' | 'caldav' | 'exchange' | 'smart-we' | 'ics', required

## Query parameters

- `redirectUrl` string
- `userId` string
- `setAsCalendarSync` boolean

## Response `200`

Authorization URL generated successfully

- object
  - `authUrl` string: OAuth authorization URL to redirect user to
  - `provider` 'google' | 'outlook' | 'icloud' | 'caldav' | 'exchange' | 'smart-we' | 'ics': Calendar provider

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `404`: No such resource in your account. Resources belonging to another account are reported the same way.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)