Skip to main content
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

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: 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:

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, Creating and Editing, and Testing and Iteration