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

# Google Analytics

> Configure a workflow step that queries GA4 reports and property metadata using a connected account

Use **Google Analytics** when you want a workflow step to fetch GA4 property metadata, validate dimension/metric combinations, or list accounts and properties from a connected account.

## Configuration

| Option              | Required | Description                                                                                                                                                                                              |
| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                | No       | Label for the step in the workflow canvas.                                                                                                                                                               |
| Authentication      | Yes      | The connected Google Analytics account to use for this step.                                                                                                                                             |
| Action              | Yes      | The analytics action to perform (for example Get Metadata, Check Compatibility, List Account Summaries).                                                                                                 |
| Arguments           | Yes      | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No       | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails.                                                                                                          |

Before you configure this step, connect Google Analytics in **Integrations** for your workspace using the OAuth flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section automatically renders a form driven by the action's input schema. Property fields include a resource picker populated from your connected account.

Switch to the **Raw JSON** tab for power users or when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Available actions

The workflow action picker shows a curated read-only subset:

| Action                 | Description                                                        |
| ---------------------- | ------------------------------------------------------------------ |
| Get Metadata           | Discover valid dimensions and metrics for a property.              |
| Check Compatibility    | Validate dimension and metric combinations before running reports. |
| List Account Summaries | List accounts and child properties.                                |
| List Property          | List properties matching a filter expression.                      |
| Get Property           | Retrieve details for a single property.                            |

Report actions (Run Report, Run Realtime Report, and Batch Run Reports) are not currently exposed in the workflow action picker.

Advanced optional filter fields (`metricFilter`, `dimensionFilter`) are hidden from the form UI for **Check Compatibility**; use the **Raw JSON** tab if you need them.

Write and admin actions (creating audiences, updating properties, sending events, and similar) are not exposed in the workflow action picker.

## Output

This step stores the Google Analytics API response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Google Analytics if you have not already done that.
2. Add a **Google Analytics** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **List Account Summaries** in **Action**.
5. Review the returned accounts and properties in **Output**, or switch to **Get Metadata** / **Get Property** for a specific property.
6. Click **Run** in the step header to test the action.

## Notes

* This step depends on a connected Google Analytics integration in your workspace.
* Use **Get Metadata** or **Check Compatibility** when building complex reports to avoid invalid dimension/metric combinations.
* OAuth may show third-party authorization branding during the connect flow.

## Using Google Analytics as an Agent Tool

You can also add Google Analytics as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Google Analytics**. In the tool settings panel, choose the connected account the agent should use.

See also: [Integrations](../../../workspace/integrations), [Creating and Editing](../../creating-and-editing), and [Testing and Iteration](../../testing-and-iteration)