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

# GET /api/integrations/google/status — Google Status

> GET /api/integrations/google/status — Check whether your Flowmatic account is connected to Google Drive and retrieve the linked Google account email.

Before triggering a Google OAuth flow or running workflows that depend on Google Drive, you can call this endpoint to check whether your Flowmatic account already has an active Google connection. The response tells you both whether a connection exists and, if so, which Google account is linked. This is useful for building UIs that conditionally show a "Connect Google" button, or for verifying integration state programmatically before executing a workflow.

## Endpoint

```bash theme={null}
GET /api/integrations/google/status
```

## Authentication

All requests must include a valid Bearer token in the `Authorization` header.

```bash theme={null}
Authorization: Bearer <accessToken>
```

## Request Body

This endpoint does not accept a request body or query parameters.

## Response

<ResponseField name="connected" type="boolean">
  Indicates whether your Flowmatic account currently has an active Google integration. `true` means a Google account has been authorized and linked; `false` means no connection exists.
</ResponseField>

<ResponseField name="email" type="string">
  The email address of the connected Google account. This field is **only present** when `connected` is `true`. When `connected` is `false`, this field is omitted entirely from the response.
</ResponseField>

### Example Response — Not Connected

```json theme={null}
{ "connected": false }
```

### Example Response — Connected

```json theme={null}
{ "connected": true, "email": "user@gmail.com" }
```

<Note>
  Always check the value of `connected` before reading `email`. When `connected` is `false`, the `email` field will not be present in the response object, and attempting to access it directly without a guard may cause unexpected errors in your application code.
</Note>

## Recommended Usage Pattern

Call this endpoint first to determine the current connection state, then take action accordingly:

* If `connected` is `false`, redirect the user (or instruct them to open) the [Google Connect](/api-reference/integrations/google-connect) URL to initiate the OAuth flow.
* If `connected` is `true`, you can proceed to run workflows that depend on Google Drive without any further authorization steps.

## curl Example

```bash theme={null}
curl -s https://api.flowmatic.io/api/integrations/google/status \
  -H "Authorization: Bearer <accessToken>"
```

## Related Endpoints

* [GET /api/integrations/google/connect](/api-reference/integrations/google-connect) — initiate the Google OAuth flow to link an account.