> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark integrations calendar google-oauth start

> Start connecting a Google Calendar

Returns a URL to open in a browser. Google has no credential a request body can carry, so connecting one is two steps: ask for this URL, let the customer consent, and Roark finishes the rest server-side (it exchanges the code, verifies that both calendar permissions were granted, reads the account’s own timezone when none was given, and stores the connection). Nothing is created until the customer consents, and a link that is not used expires. Read the result with `GET /v1/integrations/calendar?provider=GOOGLE`.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark integrations calendar google-oauth start [options]
```

> [!NOTE]
>
> Calls `POST /v1/integrations/calendar/google/authorize-url`

## Options

**--label** `string` *required*

Customer-facing name for the connection, unique within the project. Decided now because the consent screen has nowhere to carry it.

**--timezone** `string`

The named IANA timezone to offer slots in, for example `America/Los_Angeles`. Omit to adopt the Google account’s own. A fixed offset such as `-08:00` is rejected: it does not observe DST.

**--login-hint** `string`

The Google account to preselect on the consent screen. A hint only: it is ignored if the user is signed into another account, and nothing is authorized by it.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark integrations calendar google-oauth start --label <value>
```

Every command also takes the [global options](https://docs.roark.ai/cli-reference/overview.md#global-options) and sets one
of the [exit codes](https://docs.roark.ai/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.