For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Analytics

Your Toolhouse AI Worker can connect to Google Analytics using 69 specialized tools.

Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.

Tools (69)

Google Analytics Archive Custom Dimension

Integration name: GOOGLE_ANALYTICS_ARCHIVE_CUSTOM_DIMENSION

Tool to archive a CustomDimension on a property. Use when you need to remove a custom dimension from active use without permanently deleting it. Archived dimensions cannot be used in new reports.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/customDimensions/13661259421"

Required. The resource name of the CustomDimension to archive. Must be in the exact format: properties/{property_id}/customDimensions/{dimension_id} where property_id and dimension_id are numeric identifiers. IMPORTANT: Must start with 'properties/' prefix, contain '/customDimensions/' in the middle, have no trailing slashes, and no additional path segments. Valid example: 'properties/489591273/customDimensions/13661259421'. Invalid examples: '489591273/13661259421' (missing prefix), 'properties/489591273/customDimensions/13661259421/' (trailing slash), 'properties/489591273/customDimensions/13661259421/extra' (extra segments)


Google Analytics Batch Run Pivot Reports

Integration name: GOOGLE_ANALYTICS_BATCH_RUN_PIVOT_REPORTS

Tool to return multiple pivot reports in a batch for a GA4 property. Use when you need to fetch multiple pivot table reports with multi-dimensional analysis in a single request.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

property

string

"properties/123456789"

Required. The GA4 property resource name. Format: properties/{property_id}

requests

array

Required. Up to 5 individual RunPivotReportRequest objects. Each request can have dimensions, metrics, dateRanges, pivots, dimensionFilter, metricFilter, currencyCode, cohortSpec, keepEmptyRows, returnPropertyQuota, and comparisons fields. CRITICAL CONSTRAINT: Every dimension defined in 'dimensions' MUST be used in at least one of: pivots (fieldNames), dimensionFilter, or orderBys. Dimensions not used anywhere will cause a 400 error. The only exception is 'dateRange' dimensions. Additionally, all fieldNames in pivots must reference dimensions defined in the request's 'dimensions' array, and no two pivots can share the same dimension.


Google Analytics Batch Run Reports

Integration name: GOOGLE_ANALYTICS_BATCH_RUN_REPORTS

Tool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

property

string

"properties/123456789"

Required. The property resource name. Format: properties/{property_id}

requests

array

[{"metrics":[{"name":"activeUsers"}],"dateRanges":[{"endDate":"2024-01-31","startDate":"2024-01-01"}],"dimensions":[{"name":"country"}]}]

Required. Up to 5 individual RunReportRequest objects (minimum 1, maximum 5). CRITICAL: Non-cohort requests MUST contain 'dateRanges' (list of {startDate, endDate}); cohort requests (containing 'cohortSpec') must NOT include 'dateRanges'. Key fields per request: dateRanges, dimensions (list of {name}), metrics (list of {name}), dimensionFilter/metricFilter (FilterExpression: use andGroup/orGroup/notExpression/filter at top level), cohortSpec, offset, limit, orderBys, keepEmptyRows. NOTE: Do NOT include 'pivots' field - use batchRunPivotReports action for pivot reports.

unwrapped_filters

array

Internal field to track which filters were unwrapped during validation


Google Analytics Check Compatibility

Integration name: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY

Tool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

metrics

array

Optional. List of metrics to check compatibility for. Maximum of 10 metrics allowed per request.

property

string

"properties/1234"

Required. GA4 property resource name. Format: properties/{property_id}.

dimensions

array

Optional. List of dimensions to check compatibility for.

metricFilter

object

Optional. A FilterExpression for metrics; must follow GA4 FilterExpression JSON schema.

dimensionFilter

object

Optional. A FilterExpression for dimensions; must follow GA4 FilterExpression JSON schema.

compatibilityFilter

string

Compatibility status for dimensions or metrics per Google Analytics Data API v1beta. Valid values: COMPATIBILITY_UNSPECIFIED, COMPATIBLE, INCOMPATIBLE. Note: Values like 'REPORT_COMPATIBLE' are NOT valid - use 'COMPATIBLE' instead.


Google Analytics Create Audience Export

Integration name: GOOGLE_ANALYTICS_CREATE_AUDIENCE_EXPORT

Tool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. This initiates a long-running asynchronous request that returns an operation resource name immediately. The export begins in CREATING state with rowCount=0; the operation must complete before export data is accessible for querying.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Parent property resource name where the audience export will be created. Format: properties/{property_id}.

audience

string

"properties/489591273/audiences/11228260226"

Audience resource name identifying the audience to export. Format: properties/{property_id}/audiences/{audience_id}.

dimensions

array

Optional list of dimensions requested and displayed in the export. Each dimension is specified by dimensionName.


Google Analytics Create Audience List

Integration name: GOOGLE_ANALYTICS_CREATE_AUDIENCE_LIST

Tool to create an audience list for later retrieval by initiating a long-running asynchronous request. Use when you need to create a snapshot of users currently in an audience. The method returns quickly with an Operation resource while processing occurs in the background.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The parent property resource name. Format: 'properties/{property_id}'. Example: 'properties/489591273'

audience

string

"properties/489591273/audiences/11228260226"

Required. The audience resource name identifying the audience being listed. Format: 'properties/{property_id}/audiences/{audience_id}'. Example: 'properties/489591273/audiences/11228260226'

dimensions

array

Required. The dimensions requested and displayed in the query response. At least one dimension is required. Each entry must be an object with a dimensionName key (e.g., [{'dimensionName': 'deviceId'}]). Only dimensions supported for audience lists on that property are valid; unsupported values return a 400 INVALID_ARGUMENT error. Use GOOGLE_ANALYTICS_GET_METADATA to retrieve valid dimension names.

webhookNotification

object

Webhook notification configuration for audience list operation updates.


Google Analytics Create Custom Dimension

Integration name: GOOGLE_ANALYTICS_CREATE_CUSTOM_DIMENSION

Tool to create a CustomDimension for a Google Analytics property. Use when you need to add a new custom dimension to track specific user properties, event parameters, or eCommerce item parameters.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

scope

string

"EVENT"

Required. Immutable. The scope of this dimension. Must be one of: EVENT, USER, or ITEM

parent

string

"properties/489591273"

Required. The property in which to create the CustomDimension. Format: properties/{property_id}

description

string

"Custom dimension to track user segments"

Optional. Description for this custom dimension. Max length of 150 characters

displayName

string

"User Segment"

Required. Display name for this custom dimension as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter

parameterName

string

"user_segment"

Required. Immutable. Tagging parameter name for this custom dimension. For user-scoped dimensions, this is the user property name. For event-scoped dimensions, this is the event parameter name. For item-scoped dimensions, this is the parameter name in the eCommerce items array. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 24 characters for user-scoped dimensions, 40 characters for event-scoped dimensions

disallowAdsPersonalization

boolean

Optional. If set to true, sets this dimension as NPA and excludes it from ads personalization. This is currently only supported by user-scoped custom dimensions


Google Analytics Create Custom Metric

Integration name: GOOGLE_ANALYTICS_CREATE_CUSTOM_METRIC

Tool to create a custom metric in Google Analytics. Use when you need to define a new custom metric for tracking specific event parameters.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

scope

string

"EVENT"

Required. Immutable. The scope of this custom metric.

parent

string

"properties/489591273"

Required. The property where the custom metric will be created. Format: properties/{property_id}

description

string

"Test custom metric created via API"

Optional. Description for this custom metric. Max length of 150 characters.

displayName

string

"Test Custom Metric"

Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter.

parameterName

string

"test_custom_metric"

Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 40 characters for event-scoped metrics.

measurementUnit

string

"STANDARD"

Required. The type for the custom metric's value.

restrictedMetricType

array

Optional. Types of restricted data that this metric may contain. Required for metrics with CURRENCY measurement unit. Must be empty for metrics with a non-CURRENCY measurement unit.


Google Analytics Create Expanded Data Set

Integration name: GOOGLE_ANALYTICS_CREATE_EXPANDED_DATA_SET

Tool to create an expanded data set for a property. Use when you need to combine specific dimensions and metrics into a custom dataset after property creation.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/123456789"

Parent property resource name. Format: properties/{propertyId}

expandedDataSet

object

Definition of the ExpandedDataSet to create.


Google Analytics Create Recurring Audience List

Integration name: GOOGLE_ANALYTICS_CREATE_RECURRING_AUDIENCE_LIST

Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data. Use when you need to automate audience list creation and reduce quota token consumption.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Parent property resource name where the recurring audience list will be created. Format: properties/{property_id}.

audience

string

"properties/489591273/audiences/11228260226"

Audience resource name identifying the audience being listed. Format: properties/{property_id}/audiences/{audience_id}.

dimensions

array

List of dimensions requested and displayed in the audience list response.

activeDaysRemaining

integer

Counter decreasing daily. Defaults to 180 days for Analytics 360 properties (max 365) and 14 days for standard properties (max 30).

webhookNotification

object

Configuration for receiving webhook notifications about recurring audience list status.


Google Analytics Create Report Task

Integration name: GOOGLE_ANALYTICS_CREATE_REPORT_TASK

Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports. Use when you need to generate large or complex reports that process asynchronously.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Property identifier in format 'properties/{propertyId}'. The Google Analytics property for which to create the report task.

reportDefinition

object

Defines how the report executes.


Google Analytics Create Rollup Property

Integration name: GOOGLE_ANALYTICS_CREATE_ROLLUP_PROPERTY

Tool to create a roll-up property. Use when consolidating multiple GA4 properties into one aggregated view.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

account

string

Required. Parent account resource. Format: accounts/{account_id}

timeZone

string

Required. IANA time zone for the roll-up property.

displayName

string

Required. Display name for the roll-up property.

sourceProperties

array

Optional. List of source property resource names to link. Format: properties/{property_id}.


Google Analytics Get Account

Integration name: GOOGLE_ANALYTICS_GET_ACCOUNT

Tool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"accounts/100"

Required. The resource name of the Account to retrieve. Must be in the exact format: accounts/{account_id} where account_id is a numeric identifier. IMPORTANT: Must start with 'accounts/' prefix, contain no forward slashes in the account_id, have no trailing slashes, and no additional path segments. Valid example: 'accounts/100'. Invalid examples: '100' (missing prefix), 'accounts/100/' (trailing slash), 'accounts/100/extra' (extra segments)


Google Analytics Get Attribution Settings

Integration name: GOOGLE_ANALYTICS_GET_ATTRIBUTION_SETTINGS

Tool to retrieve attribution configuration for a Google Analytics property. Use when you need to check attribution models, lookback windows, and conversion export settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/attributionSettings"

Required. The resource name of the attribution settings to retrieve. Must be in the exact format: properties/{property_id}/attributionSettings where property_id is a numeric identifier. IMPORTANT: Must start with 'properties/' prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with '/attributionSettings'. Valid example: 'properties/489591273/attributionSettings'. Invalid examples: '489591273' (missing prefix), 'properties/489591273' (missing suffix), 'properties/489591273/attributionSettings/' (trailing slash)


Google Analytics Get Audience

Integration name: GOOGLE_ANALYTICS_GET_AUDIENCE

Tool to retrieve a single Audience configuration from a Google Analytics property. Use when you need detailed audience information including membership criteria and filter clauses.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

audienceId

string

"11228260226"

Required. The audience identifier to retrieve. Provide the numeric audience ID (e.g., '11228260226').

propertyId

string

"123456789"

Required. The Google Analytics property identifier. Can be provided as just the numeric ID (e.g., '123456789') or as full resource name (e.g., 'properties/123456789').


Google Analytics Get Audience Export

Integration name: GOOGLE_ANALYTICS_GET_AUDIENCE_EXPORT

Tool to get configuration metadata about a specific audience export. Use when you need to understand an audience export after it has been created or check its status.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/audienceExports/19298228"

Required. The audience export resource name. Format: properties/{property}/audienceExports/{audience_export}. Example: properties/489591273/audienceExports/19298228


Google Analytics Get Audience List

Integration name: GOOGLE_ANALYTICS_GET_AUDIENCE_LIST

Tool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/1234/audienceLists/5678"

Required. The resource name of the Audience List to retrieve. Format: properties/{property}/audienceLists/{audienceList}.


Google Analytics Get Custom Dimension

Integration name: GOOGLE_ANALYTICS_GET_CUSTOM_DIMENSION

Tool to retrieve a single CustomDimension by its resource name. Use when you need detailed information about a specific custom dimension including its display name, scope, and parameter name.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/customDimensions/13661238280"

Required. The resource name of the CustomDimension to retrieve. Must be in the exact format: properties/{property_id}/customDimensions/{customDimension_id} where both property_id and customDimension_id are numeric identifiers. IMPORTANT: Must start with 'properties/' prefix, contain exactly one '/customDimensions/' segment, have no trailing slashes, and no additional path segments. Valid example: 'properties/489591273/customDimensions/13661238280'. Invalid examples: '489591273/13661238280' (missing prefix), 'properties/489591273/customDimensions/13661238280/' (trailing slash), 'properties/489591273/customDimensions/13661238280/extra' (extra segments)


Google Analytics Get Data Retention Settings

Integration name: GOOGLE_ANALYTICS_GET_DATA_RETENTION_SETTINGS

Tool to retrieve data retention configuration for a Google Analytics property. Use when you need to check event-level and user-level data retention durations and reset settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/dataRetentionSettings"

Required. The resource name of the data retention settings to retrieve. Must be in the exact format: properties/{property_id}/dataRetentionSettings where property_id is a numeric identifier. IMPORTANT: Must start with 'properties/' prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with '/dataRetentionSettings'. Valid example: 'properties/489591273/dataRetentionSettings'. Invalid examples: '489591273' (missing prefix), 'properties/489591273' (missing suffix), 'properties/489591273/dataRetentionSettings/' (trailing slash)


Google Analytics Get Data Sharing Settings

Integration name: GOOGLE_ANALYTICS_GET_DATA_SHARING_SETTINGS

Tool to retrieve data sharing configuration for a Google Analytics account. Use when you need to check which data sharing settings are enabled for an account, including sharing with Google support, sales teams, products, and benchmarking.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"accounts/1000/dataSharingSettings"

Required. The resource name of the data sharing settings to retrieve. Must be in the exact format: accounts/{account_id}/dataSharingSettings where account_id is a numeric identifier. IMPORTANT: Must start with 'accounts/' prefix, contain no forward slashes in the account_id, have no trailing slashes, and must end with '/dataSharingSettings'. Valid example: 'accounts/1000/dataSharingSettings'. Invalid examples: '1000' (missing prefix), 'accounts/1000' (missing suffix), 'accounts/1000/dataSharingSettings/' (trailing slash)


Google Analytics Get Google Signals Settings

Integration name: GOOGLE_ANALYTICS_GET_GOOGLE_SIGNALS_SETTINGS

Tool to retrieve Google Signals configuration settings for a GA4 property. Use when you need to check whether Google Signals is enabled and the consent status for a property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/1000/googleSignalsSettings"

Required. The resource name of the Google Signals settings to retrieve. Must be in the exact format: properties/{property_id}/googleSignalsSettings where property_id is a numeric identifier. IMPORTANT: Must start with 'properties/' prefix, contain no forward slashes in the property_id, have no trailing slashes, and must end with '/googleSignalsSettings'. Valid example: 'properties/1000/googleSignalsSettings'. Invalid examples: '1000' (missing prefix), 'properties/1000' (missing suffix), 'properties/1000/googleSignalsSettings/' (trailing slash)


Google Analytics Get Key Event

Integration name: GOOGLE_ANALYTICS_GET_KEY_EVENT

Tool to retrieve a Key Event. Use after confirming the key event resource name. Read-only; create, update, or delete operations require the Google Analytics UI.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/123/keyEvents/456"

Required. Resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{keyEvent}.


Google Analytics Get Metadata

Integration name: GOOGLE_ANALYTICS_GET_METADATA

Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use to discover available fields before building a report — always derive dimension/metric apiNames from this output rather than hardcoding from GA4 UI labels, which differ. Available fields vary per property; skip validation and downstream report tools like GOOGLE_ANALYTICS_RUN_REPORT return 400 INVALID_ARGUMENT on incompatible or invalid field combinations. Response can contain hundreds of fields; filter to relevant subset before passing to downstream logic.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/123456789/metadata"

Resource name of the metadata to retrieve. Format: properties/{property_id}/metadata. Use property_id=0 to return only universal (non-custom) metadata.


Google Analytics Get Property

Integration name: GOOGLE_ANALYTICS_GET_PROPERTY

Tool to retrieve a single GA4 Property by its resource name. Use when you need detailed property configuration including display name, time zone, currency, and other settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273"

Required. The resource name of the Property to retrieve. Must be in the exact format: properties/{property_id} where property_id is a numeric identifier. IMPORTANT: Must start with 'properties/' prefix, contain no forward slashes in the property_id, have no trailing slashes, and no additional path segments. Valid example: 'properties/489591273'. Invalid examples: '489591273' (missing prefix), 'properties/489591273/' (trailing slash), 'properties/489591273/extra' (extra segments)


Google Analytics Get Property Quotas Snapshot

Integration name: GOOGLE_ANALYTICS_GET_PROPERTY_QUOTAS_SNAPSHOT

Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property. Use when you need to check current quota usage. Snapshot data can lag real consumption by several minutes; treat reported values as approximate and avoid scheduling high-volume jobs at full apparent capacity.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

property

string

"properties/1234"

Required. The property resource. Format: properties/{property_id}.


Google Analytics Get Recurring Audience List

Integration name: GOOGLE_ANALYTICS_GET_RECURRING_AUDIENCE_LIST

Tool to get configuration metadata about a specific recurring audience list. Use when you need to understand a recurring audience list's state after it has been created or to get the resource name of the most recent audience list instance.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/recurringAudienceLists/16375634"

Required. The recurring audience list resource name. Format: properties/{property}/recurringAudienceLists/{recurring_audience_list}


Google Analytics Get Report Task

Integration name: GOOGLE_ANALYTICS_GET_REPORT_TASK

Tool to get report metadata about a specific report task. Use after creating a report task to check its processing state or inspect its report definition.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/reportTasks/7995923"

Required. The report task resource name. Format: properties/{property}/reportTasks/{reportTask}


Google Analytics List Accounts

Integration name: GOOGLE_ANALYTICS_LIST_ACCOUNTS

DEPRECATED: Use ListAccountsV1Beta instead. Tool to list all Accounts accessible by the caller. Use when you need to enumerate all Google Analytics accounts your credentials can access. Empty or partial results may indicate a permissions issue rather than no resources existing. Returned resource names follow the format accounts/{account_id}; use these in subsequent calls.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pageSize

integer

100

Optional. Maximum number of accounts to return. Must be ≥1.

pageToken

string

"token123"

Optional. Token for retrieving the next page of results.

showDeleted

boolean

Optional. Whether to include soft-deleted (trashed) Accounts.


Google Analytics List Account Summaries

Integration name: GOOGLE_ANALYTICS_LIST_ACCOUNT_SUMMARIES

Tool to retrieve summaries of all Google Analytics accounts accessible by the caller. Use when you need a high-level overview of accounts and their properties without fetching full account details.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pageSize

integer

50

Maximum number of account summaries to return. The service may return fewer than this value. If unspecified, at most 50 resources will be returned. Maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Page token received from a previous ListAccountSummaries call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccountSummaries must match the call that provided the page token.


Google Analytics List Accounts V1 Beta

Integration name: GOOGLE_ANALYTICS_LIST_ACCOUNTS_V1_BETA

Tool to list all Google Analytics accounts accessible by the caller using v1beta API. Use when you need to enumerate accounts. Note that these accounts might not have GA properties yet. Soft-deleted accounts are excluded by default.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pageSize

integer

50

The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

A page token, received from a previous ListAccounts call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccounts must match the call that provided the page token.

showDeleted

boolean

Whether to include soft-deleted (ie: 'trashed') Accounts in the results. Accounts can be inspected to determine whether they are deleted or not. Defaults to false (soft-deleted accounts are excluded).


Integration name: GOOGLE_ANALYTICS_LIST_ADSENSE_LINKS

Tool to list all AdSenseLinks on a property. Use when you need to fetch all AdSense links for a given Google Analytics property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/1234"

Required. Resource name of the property. Format: properties/{propertyId} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of results to return. Must be between 1 and 200. Defaults to 50.

pageToken

string

"token123"

Optional. Token for retrieving the next page of results.


Google Analytics List Audience Exports

Integration name: GOOGLE_ANALYTICS_LIST_AUDIENCE_EXPORTS

Tool to list all audience exports for a property. Use when you need to find and reuse existing audience exports rather than creating new ones.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Property identifier in format 'properties/{propertyId}'. Example: 'properties/489591273'

pageSize

integer

200

Optional. Maximum number of audience exports to return. Default: 200, Maximum: 1000

pageToken

string

"token123"

Optional. Token from a previous response for pagination to retrieve the next page of results


Google Analytics List Audience Lists

Integration name: GOOGLE_ANALYTICS_LIST_AUDIENCE_LISTS

Tool to list all audience lists for a specified property to help find and reuse existing lists. Use when you need to retrieve a property's configured audience lists after confirming the property ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/1234"

Required. Resource name of the parent property. Format: properties/{property_id}

pageSize

integer

200

Optional. Maximum number of audience lists to return. Defaults to 200; maximum is 1000.

pageToken

string

"token123"

Optional. Token for retrieving the next page of results. All other parameters must match original request.


Google Analytics List Audiences

Integration name: GOOGLE_ANALYTICS_LIST_AUDIENCES

Tool to list Audiences on a property. Use when you need to retrieve audience configurations for a Google Analytics property. Audiences created before 2020 may not be supported.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The property for which to list Audiences. Format: properties/{propertyId} Scoped to a single property per call; invoke separately for each property to list audiences across multiple GA4 properties.

pageSize

integer

50

Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListAudiences call. Provide this to retrieve the subsequent page


Integration name: GOOGLE_ANALYTICS_LIST_BIGQUERY_LINKS

Tool to list BigQuery Links on a property. Use when you need to retrieve BigQuery link resources associated with a Google Analytics property. Results support pagination for large datasets.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The name of the property to list BigQuery links under. Format: properties/{property_id} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of resources to return. The service may return fewer than this value. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Optional. A page token received from a previous ListBigQueryLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListBigQueryLinks must match the call that provided the page token.


Google Analytics List Calculated Metrics

Integration name: GOOGLE_ANALYTICS_LIST_CALCULATED_METRICS

List Calculated Metrics

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Property identifier in format 'properties/{propertyId}'. Example: 'properties/1234'

pageSize

integer

50

Optional. Maximum number of results to return per request. Default: 50, Maximum: 200

pageToken

string

"token123"

Optional. Token from a previous response for pagination to retrieve the next page of results


Google Analytics List Channel Groups

Integration name: GOOGLE_ANALYTICS_LIST_CHANNEL_GROUPS

Tool to list ChannelGroups on a property. Use when you need to retrieve channel groups that categorize traffic sources in Analytics reports.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The property for which to list ChannelGroups. Format: properties/{property_id}

pageSize

integer

50

Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListChannelGroups call. Provide this to retrieve the subsequent page


Google Analytics List Conversion Events

Integration name: GOOGLE_ANALYTICS_LIST_CONVERSION_EVENTS

Tool to list conversion events on a property. Use when you need to retrieve conversion events configured for a given property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The resource name of the parent property. Format: 'properties/{propertyId}'

pageSize

integer

50

Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListConversionEvents call. Provide this to retrieve the subsequent page


Google Analytics List Custom Dimensions

Integration name: GOOGLE_ANALYTICS_LIST_CUSTOM_DIMENSIONS

List Custom Dimensions

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The property for which to list CustomDimensions. Format: properties/{property_id}

pageSize

integer

50

Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListCustomDimensions call. Provide this to retrieve the subsequent page


Google Analytics List Custom Metrics

Integration name: GOOGLE_ANALYTICS_LIST_CUSTOM_METRICS

Tool to list CustomMetrics on a property. Use when you need to retrieve all custom metrics configured for a given property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Property identifier in format 'properties/{propertyId}'. Example: 'properties/1234'

pageSize

integer

50

Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. Maximum value is 200

pageToken

string

"token123"

Optional. Token from a previous ListCustomMetrics call for pagination to retrieve the next page of results


Google Analytics List Data Streams

Integration name: GOOGLE_ANALYTICS_LIST_DATA_STREAMS

Tool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The Google Analytics property identifier. Must be in format 'properties/NUMERIC_ID' where NUMERIC_ID is your actual property ID (e.g., 'properties/489591273'). Do NOT use placeholder syntax like 'properties/{propertyId}' - replace the placeholder with a real numeric property ID.

pageSize

integer

50

Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListDataStreams call. Provide this to retrieve the subsequent page


Integration name: GOOGLE_ANALYTICS_LIST_DV360_AD_LINKS

Tool to list Display & Video 360 advertiser links on a property. Use when you need to retrieve DisplayVideo360AdvertiserLink resources associated with a Google Analytics property. Results support pagination for large datasets.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The name of the property to list DisplayVideo360AdvertiserLinks under. Format: properties/{property_id} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of resources to return. The service may return fewer than this value. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Optional. A page token received from a previous ListDisplayVideo360AdvertiserLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the call that provided the page token.


Integration name: GOOGLE_ANALYTICS_LIST_DV360_LINK_PROPOSALS

Tool to list DisplayVideo360AdvertiserLinkProposals on a property. Use when you need to retrieve Display & Video 360 advertiser link proposals associated with a Google Analytics property. Results support pagination for large datasets.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The name of the property to list DisplayVideo360AdvertiserLinkProposals under. Format: properties/{property_id} (e.g., properties/489591273).

pageSize

integer

50

Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Optional. A page token received from a previous ListDisplayVideo360AdvertiserLinkProposals call. Provide this to retrieve the subsequent page. When paginating, all other parameters must match the call that provided the page token.


Google Analytics List Event Create Rules

Integration name: GOOGLE_ANALYTICS_LIST_EVENT_CREATE_RULES

Tool to list EventCreateRules configured on a web data stream. Use when you need to retrieve event create rules for a specific GA4 property data stream.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273/dataStreams/456789"

Required. Resource name of the parent data stream. Format: properties/{propertyId}/dataStreams/{dataStreamId}.

pageSize

integer

50

Optional. Maximum number of event create rules to return. Default is 50, maximum allowed is 200.

pageToken

string

"token123"

Optional. A page token received from a previous list call. Provide this to retrieve the next page of results.


Google Analytics List Expanded Data Sets

Integration name: GOOGLE_ANALYTICS_LIST_EXPANDED_DATA_SETS

Tool to list ExpandedDataSets on a property. Use when you need to retrieve expanded data set configurations for a Google Analytics 360 property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The name of the property to list ExpandedDataSets for. Format: properties/{property_id}

pageSize

integer

50

Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200

pageToken

string

"token123"

Optional. A page token received from a previous ListExpandedDataSets call. Provide this to retrieve the subsequent page


Integration name: GOOGLE_ANALYTICS_LIST_FIREBASE_LINKS

Tool to list FirebaseLinks on a property. Use when you need to retrieve Firebase connections associated with a Google Analytics property. Each property can have at most one FirebaseLink.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The property for which to list FirebaseLinks. Format: properties/{property_id} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Optional. A page token received from a previous ListFirebaseLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListFirebaseLinks must match the call that provided the page token.


Integration name: GOOGLE_ANALYTICS_LIST_GOOGLE_ADS_LINKS

Tool to list GoogleAdsLinks on a property. Use when you need to retrieve Google Ads account links configured for a Google Analytics property. Supports pagination for large result sets.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. The property resource name. Format: properties/{propertyId} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; higher values will be coerced to the maximum.

pageToken

string

"token123"

Optional. A page token received from a previous ListGoogleAdsLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters must match the call that provided the page token.


Google Analytics List Key Events

Integration name: GOOGLE_ANALYTICS_LIST_KEY_EVENTS

Tool to list Key Events. Use when you need to retrieve all key event definitions for a given property. Key events are read-only via API; creation, updates, and deletion require the Google Analytics UI. An empty results list means no key events are configured, not a failure. Do not infer key-event status from report data (e.g., eventCount); use this tool to confirm.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/123"

Required. Resource name of the parent property. Format: properties/{property_id}.

pageSize

integer

50

Optional. Maximum number of results to return. Must be between 1 and 200. If not specified or 0, the API uses its default page size.

pageToken

string

"token123"

Optional. Token for retrieving the next page of results.


Google Analytics List Measurement Protocol Secrets

Integration name: GOOGLE_ANALYTICS_LIST_MEASUREMENT_PROTOCOL_SECRETS

Tool to list MeasurementProtocolSecrets under a data stream. Use when you need to retrieve measurement protocol secrets for server-side event tracking.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273/dataStreams/1234567890"

Required. The resource name of the parent data stream. Format: properties/{property}/dataStreams/{dataStream}

pageSize

integer

10

Optional. Maximum number of resources to return. If unspecified, at most 10 resources will be returned. The maximum value is 10

pageToken

string

"token123"

Optional. A page token received from a previous ListMeasurementProtocolSecrets call. Provide this to retrieve the subsequent page


Google Analytics List Properties

Integration name: GOOGLE_ANALYTICS_LIST_PROPERTIES

DEPRECATED: Use ListPropertiesV1Beta instead. Tool to list GA4 properties under a specific account. Use after obtaining an account ID; supports pagination and including soft-deleted properties. Results may include legacy Universal Analytics properties; verify property type before use.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

account

string

"accounts/123456789"

Required. Google Analytics account resource name in format accounts/{account_id} where account_id is a Google Analytics account ID (typically 6-10 digits). Use GOOGLE_ANALYTICS_LIST_ACCOUNTS to get valid account IDs. Note: Do not use Google Account IDs (long numeric IDs from OAuth user info) - only Google Analytics account IDs are valid.

pageSize

integer

100

Optional. Maximum number of properties to return; must be between 1 and 200.

pageToken

string

"token123"

Optional. Token returned from a previous call to retrieve the next page of results.

showDeleted

boolean

Optional. Whether to include soft-deleted (trashed) properties.


Google Analytics List Properties Filtered

Integration name: GOOGLE_ANALYTICS_LIST_PROPERTIES_FILTERED

Tool to list GA4 properties based on filter criteria. Use when you need to find properties under a specific parent account or with specific firebase projects. Supports pagination and including soft-deleted properties.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

filter

string

"parent:accounts/123456789"

Required. Expression for filtering the results. Fields eligible for filtering: parent: (resource name of parent account/property), ancestor: (resource name of parent account), or firebase_project: (id or number of linked firebase project). Examples: 'parent:accounts/123' (account with id 123), 'parent:properties/123' (property with id 123), 'ancestor:accounts/123' (account with id 123), 'firebase_project:project-id' (firebase project with id project-id), 'firebase_project:123' (firebase project with number 123).

pageSize

integer

50

Optional. Maximum number of properties to return (1-200). Default is 50.

pageToken

string

"token123"

Optional. Token from previous ListProperties call to retrieve the next page.

showDeleted

boolean

Optional. Whether to include soft-deleted (trashed) properties. Default is false.


Google Analytics List Recurring Audience Lists

Integration name: GOOGLE_ANALYTICS_LIST_RECURRING_AUDIENCE_LISTS

Tool to list all recurring audience lists for a GA4 property. Use when you need to find and reuse existing recurring audience lists.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Resource name of the parent property. Format: properties/{property_id}

pageSize

integer

200

Optional. Maximum number of recurring audience lists to return. Defaults to 200; maximum is 1000.

pageToken

string

"token123"

Optional. Token for retrieving the next page of results.


Google Analytics List Reporting Data Annotations

Integration name: GOOGLE_ANALYTICS_LIST_REPORTING_DATA_ANNOTATIONS

Tool to list all Reporting Data Annotations for a specific property. Use when you need to retrieve annotations that document important events or periods in GA4 reporting data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

filter

string

"color = RED AND title =~ 'campaign'"

Optional. Expression to refine results. Supported fields: name, title, description, annotationDate, annotationDateRange, color. Helper functions: annotation_duration(), is_annotation_in_range(). Operators: =, !=, <, >, <=, >=, :, =, !, NOT, AND, OR.

parent

string

"properties/123456789"

Required. Resource name of the property. Format: properties/{property_id}. Example: properties/123456789

pageSize

integer

50

Optional. Maximum number of resources per response. Default: 50, Max: 200.

pageToken

string

"abc123"

Optional. Pagination token from previous response to retrieve next page.


Google Analytics List Report Tasks

Integration name: GOOGLE_ANALYTICS_LIST_REPORT_TASKS

Tool to list all report tasks for a Google Analytics property. Use when you need to retrieve report task definitions and their execution status.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Property identifier in format 'properties/{propertyId}'. The Google Analytics property whose report tasks should be listed.

pageSize

integer

50

Optional. Maximum number of report tasks to return per page. If unspecified, server determines page size.

pageToken

string

"token123"

Optional. Pagination token from previous list response for retrieving next page of results. Omit for first page.


Integration name: GOOGLE_ANALYTICS_LIST_SEARCH_ADS360_LINKS

Tool to list all SearchAds360Links on a property. Use when you need to retrieve all Search Ads 360 links for a given Google Analytics property. Supports pagination for large result sets.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/1234"

Required. The property resource name. Format: properties/{propertyId} (e.g., properties/1234).

pageSize

integer

50

Optional. Maximum number of resources to return. Default is 50, maximum is 200. Values exceeding 200 are capped at maximum.

pageToken

string

"token123"

Optional. A page token received from a previous list call. Use this to retrieve the next page. All other parameters must match the original request.


Google Analytics List Sk Ad Network Conversion Value Schemas

Integration name: GOOGLE_ANALYTICS_LIST_SK_AD_NETWORK_CONVERSION_VALUE_SCHEMAS

Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream. Use when you need to retrieve conversion value schemas for iOS app tracking. Maximum one schema per property is supported.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/123456789/dataStreams/1234567890"

Required. The DataStream resource to list schemas for. Format: properties/{property_id}/dataStreams/{dataStream}. Example: 'properties/123456789/dataStreams/1234567890'

pageSize

integer

50

Optional. Maximum number of resources per response. Default: 50, Maximum: 200.

pageToken

string

"token123"

Optional. Token from previous call for pagination to retrieve next page of results.


Google Analytics List Subproperty Event Filters

Integration name: GOOGLE_ANALYTICS_LIST_SUBPROPERTY_EVENT_FILTERS

Tool to list all subproperty event filters on a property. Use when you need to retrieve event filters that route events to subproperties.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/489591273"

Required. Resource name of the ordinary property. Format: properties/{property_id}

pageSize

integer

50

Optional. Maximum number of resources to return; at most 50 by default, maximum 200.

pageToken

string

"token123"

Optional. Page token received from a previous call to retrieve the next page.


Google Analytics List Subproperty Sync Configs

Integration name: GOOGLE_ANALYTICS_LIST_SUBPROPERTY_SYNC_CONFIGS

Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. Use when you need to fetch subproperty sync configs for a GA4 property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

parent

string

"properties/123456789"

Required. Resource name of the property. Format: properties/{property_id}. Example: properties/123

pageSize

integer

50

Optional. The maximum number of resources to return. May return fewer. If unspecified, at most 50 resources will be returned. Maximum value is 200.

pageToken

string

"token123"

Optional. A page token received from a previous ListSubpropertySyncConfig call. Provide this to retrieve the subsequent page.


Google Analytics Provision Account Ticket

Integration name: GOOGLE_ANALYTICS_PROVISION_ACCOUNT_TICKET

Tool to request a ticket for creating a Google Analytics account. Use when you need to initiate the account creation flow that requires user acceptance of Terms of Service.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

account

object

Required. Account details including display name and region code.

redirectUri

string

"https://example.com/redirect"

Required. Redirect URI where the user will be sent after accepting Terms of Service. Must be configured in Cloud Console as a Redirect URI.


Google Analytics Query Audience Export

Integration name: GOOGLE_ANALYTICS_QUERY_AUDIENCE_EXPORT

Tool to query a completed audience export. Use when you need to fetch user rows with pagination.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/1234/audienceExports/5678"

Required. Resource name of the audience export. Format: properties/{property}/audienceExports/{audienceExport}, where {property} and {audienceExport} must be integers.

limit

integer

1000

Optional. Number of rows to return. Must be between 1 and 250000. Defaults to 10000.

offset

integer

0

Optional. Zero-based start row index for pagination. Defaults to 0.


Google Analytics Query Audience List

Integration name: GOOGLE_ANALYTICS_QUERY_AUDIENCE_LIST

Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/1234/audienceLists/abcd-5678"

Required. Audience list resource to query. Format: properties/{property}/audienceLists/{audienceList}.

limit

integer

1000

Optional. Number of rows to return; default 10,000; maximum 250,000.

offset

integer

0

Optional. Zero-based row offset for pagination.


Google Analytics Query Report Task

Integration name: GOOGLE_ANALYTICS_QUERY_REPORT_TASK

Tool to retrieve a report task's content. Use this after creating a report task with CreateReportTask and confirming it is in ACTIVE state. This method returns an error if the report task's state is not ACTIVE.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/489591273/reportTasks/173003"

Required. Report task name in format 'properties/{propertyId}/reportTasks/{reportTaskId}'. The report task must be in ACTIVE state.

limit

integer

100

Optional. Number of rows to return (max 250,000). If unspecified, 10,000 rows are returned. Must be positive. Limited by the ReportTask's own limit.

offset

integer

0

Optional. Row offset for pagination (0-indexed). First request omits offset or sets to 0. For subsequent pages, set to the previous limit value.


Google Analytics Run Funnel Report

Integration name: GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT

Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property. Funnel step sequence is determined by step attributes in the response, not row order.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

Number of rows to return. Default 10000; max 250000.

funnel

object

Funnel configuration object. Must include a 'steps' key with at least one step. Each step requires a 'name' and optionally a 'filterExpression'. Use 'funnelEventFilter' for event filters and 'funnelFieldFilter' for field filters. Filter expressions with 'fieldName' + 'stringFilter' are auto-wrapped in 'funnelFieldFilter'. Example: {"steps": [{"name": "First visit", "filterExpression": {"funnelEventFilter": {"eventName": "first_visit"}}}]}

property

string

"properties/1234"

GA4 property resource name, format: properties/{property_id}.

segments

array

Up to 4 segments; each yields its own row in the report.

dateRanges

array

List of date ranges to read; overlapping ranges duplicate days across ranges.

dimensionFilter

object

Dimension-only filter expression.

funnelBreakdown

object

Breakdown dimension configuration for the funnel table sub-report.

funnelNextAction

object

Next-action dimension configuration for the funnel visualization sub-report.

returnPropertyQuota

boolean

If true, includes the property's current quota state.

funnelVisualizationType

string

Visualization type: STANDARD_FUNNEL (default) or TRENDED_FUNNEL.


Google Analytics Run Pivot Report

Integration name: GOOGLE_ANALYTICS_RUN_PIVOT_REPORT

Tool to run a customized pivot report of Google Analytics event data. Use when you need a pivot table view with advanced segmentation and multi-dimensional analysis of GA4 data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pivots

array

[{"limit":5,"fieldNames":["country"]}]

Optional. Visual format configuration for dimensions. Each pivot has 'fieldNames' (required string array), 'limit' (required), optional 'orderBys', 'offset', and 'metricAggregations'.

metrics

array

[{"name":"activeUsers"},{"name":"sessions"}]

Required. At least one metric is required. Each metric has a 'name' field, optional 'expression', and optional 'invisible' boolean.

property

string

"properties/123456789"

Required. The GA4 property resource name. Format: properties/{property_id}

cohortSpec

object

Optional. Cohort configuration with 'cohorts' (required), optional 'cohortsRange' and 'cohortReportSettings'.

dateRanges

array

[{"endDate":"2024-12-09","startDate":"2024-12-01"}]

Optional. Date ranges for event data retrieval. Each range has 'startDate' and 'endDate' (YYYY-MM-DD format or relative like 'NdaysAgo', 'yesterday', 'today'), and optional 'name'.

dimensions

array

[{"name":"country"},{"name":"deviceCategory"}]

Optional. Dimensions to request. Each dimension has a 'name' field and optional 'dimensionExpression'. Dimensions must be used in pivots, filters, or orderBys.

comparisons

array

Optional. Comparison configurations. Each comparison has optional 'name' and required 'dimensionFilter' or 'comparison'.

currencyCode

string

"USD"

Optional. ISO4217 currency code (e.g., 'USD', 'EUR').

metricFilter

object

Optional. Post-aggregation filter (SQL HAVING clause equivalent).

keepEmptyRows

boolean

Optional. If true, includes rows where all metrics equal 0.

dimensionFilter

object

Optional. Filter clause for dimensions only. Can use andGroup, orGroup, notExpression, or filter.

returnPropertyQuota

boolean

Optional. If true, returns current quota state in PropertyQuota.


Google Analytics Run Realtime Report

Integration name: GOOGLE_ANALYTICS_RUN_REALTIME_REPORT

Tool to run a customized realtime report of Google Analytics event data. Use when you need realtime data (last 30-60 minutes) with dimensions and metrics for a GA4 property.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

50

Max rows to return (default 10000, max 250000).

metrics

array

[{"name":"activeUsers"},{"name":"screenPageViews"}]

Metrics to measure (max 10). At least one dimension or metric is required. Valid names: activeUsers, eventCount, keyEvents, screenPageViews.

orderBys

array

Sorting specification. Example: [{'metric': {'metricName': 'activeUsers'}, 'desc': true}] or [{'dimension': {'dimensionName': 'country'}}].

property

string

"properties/123456789"

Required. The GA4 property resource name. Format: properties/{property_id}. Get property IDs from GOOGLE_ANALYTICS_LIST_PROPERTIES.

dimensions

array

[{"name":"country"},{"name":"city"}]

Dimensions to group by (max 9). At least one dimension or metric is required. Valid names: appVersion, audienceId, audienceName, city, cityId, country, countryId, deviceCategory, eventName, minutesAgo, platform, streamId, streamName, unifiedScreenName. Custom: 'customUser:param_name'.

metricFilter

object

Post-aggregation filter on metric values. Applied after row aggregation.

minuteRanges

array

[{"name":"last_30_minutes","endMinutesAgo":0,"startMinutesAgo":29}]

Time ranges to report on. Default is last 30 minutes. Each range has startMinutesAgo (default 29) and endMinutesAgo (default 0).

dimensionFilter

object

Filter to restrict data by dimension values. Structure: {'filter': {'fieldName': 'country', 'stringFilter': {'value': 'United States'}}} or use andGroup/orGroup/notExpression for complex filters.

metricAggregations

array

["TOTAL"]

Request aggregated metric values. Values: 'TOTAL', 'MINIMUM', 'MAXIMUM', 'COUNT'.

returnPropertyQuota

boolean

If true, includes API quota usage info in the response.


Google Analytics Run Report

Integration name: GOOGLE_ANALYTICS_RUN_REPORT

Tool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges. IMPORTANT - DIMENSION/METRIC COMPATIBILITY: The Google Analytics Data API has strict compatibility rules between dimensions and metrics. Not all combinations are valid. If you receive a 400 error with a message about incompatible dimensions/metrics, use the GOOGLE_ANALYTICS_CHECK_COMPATIBILITY action first to validate your dimension/metric combinations before running reports. Common incompatibilities include: - Demographic dimensions (userAgeBracket, userGender) with session-scoped dimensions/filters (sessionCampaignName, sessionSource) - Certain user-scoped dimensions with event-scoped metrics For complex queries, consider starting with simpler dimension/metric combinations or use CHECK_COMPATIBILITY to pre-validate your request.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

1000

Optional. Number of rows to return. Must be between 1 and 250000.

offset

integer

0

Optional. 0-based start row for pagination. Must be >= 0.

metrics

array

{"name":"activeUsers"}

Optional. The metrics to request and display. Maximum 10 metrics per request. Each metric MUST be an object with a required non-empty 'name' field. Common valid metric names: activeUsers, totalUsers, newUsers, sessions, engagedSessions, screenPageViews, eventCount, conversions, userEngagementDuration, engagementRate, bounceRate, averageSessionDuration, sessionsPerUser, screenPageViewsPerSession, purchaseRevenue, totalRevenue, transactions, ecommercePurchases, publisherAdClicks, publisherAdImpressions, totalAdRevenue. Custom metrics use format 'customEvent:parameter_name'. CRITICAL: 'averageEngagementTime' is NOT a valid metric - use 'userEngagementDuration' or 'averageSessionDuration' instead. 'exits' is NOT a valid metric in GA4.

orderBys

array

{"desc":true,"metric":{"metricName":"activeUsers"}}

Optional. Specify how rows are ordered. Each OrderBy object must have 'desc' (boolean) at the top level and exactly one of: 'metric' (with 'metricName' string), 'dimension' (with 'dimensionName' or 'name' string and optional 'orderType': 'ALPHANUMERIC', 'CASE_INSENSITIVE_ALPHANUMERIC', or 'NUMERIC'), or 'pivot'. Note: For dimension ordering, you can use either 'dimensionName' or 'name' field - both are accepted and normalized. Example for metric ordering: {'desc': true, 'metric': {'metricName': 'activeUsers'}}. Example for dimension ordering: {'desc': false, 'dimension': {'dimensionName': 'country', 'orderType': 'ALPHANUMERIC'}}.

property

string

"properties/123456789"

Required. The property resource on which to run the report. Format: properties/{property_id} where property_id must be a numeric ID (e.g., 'properties/123456789').

cohortSpec

object

Optional. Cohort specification. Requires requesting the cohort dimension.

dateRanges

array

{"endDate":"2023-01-31","startDate":"2023-01-01"}

The date ranges to read. Required for standard reports. Each range MUST be an object with required 'startDate' and 'endDate' fields (both must be non-empty). Dates can be in YYYY-MM-DD format or special values like 'today', 'yesterday', '7daysAgo', '30daysAgo'. IMPORTANT: For cohort requests (when cohortSpec is provided), dateRanges must be omitted.

dimensions

array

{"name":"city"}

Optional. The dimensions to request and display. Maximum 9 dimensions per request. Each dimension MUST be an object with a required non-empty 'name' field. Common valid dimension names: date, dateHour, dateHourMinute, year, month, week, day, dayOfWeek, hour, city, cityId, country, countryId, continent, continentId, region, subContinent, deviceCategory, browser, operatingSystem, platform, platformDeviceCategory, screenResolution, sessionSource, sessionMedium, sessionSourceMedium, sessionCampaignName, sessionDefaultChannelGroup, firstUserSource, firstUserMedium, firstUserCampaignName, firstUserDefaultChannelGroup, pagePath, pagePathPlusQueryString, pageTitle, landingPage, hostname, eventName, streamName, userAgeBracket, userGender, language, newVsReturning. Custom dimensions: 'customEvent:parameter_name' or 'customUser:parameter_name'. 'dateRange' is NOT a valid dimension — use date dimensions (date, dateHour, year, month, etc.) instead. 'exits' is NOT a valid dimension in GA4. COMPATIBILITY: Not all dimensions can be combined with each other or with certain metrics/filters. If you receive a compatibility error, use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to validate combinations, or see https://developers.google.com/analytics/devguides/reporting/data/v1/compatibility

comparisons

array

Optional. The comparison configuration. Adds a comparison column to the response.

currencyCode

string

"USD"

Optional. The currency code to apply, in ISO 4217 format. Defaults to property currency.

metricFilter

object

Optional. Filter expression to restrict rows by metric values. Applied after aggregation. IMPORTANT: Only use metric field names here (e.g., 'activeUsers', 'sessions', 'ecommercePurchases', 'purchaseRevenue'). Do NOT use dimension names in metricFilter - if you need to filter by a dimension (e.g., 'country', 'city', 'pagePath'), use dimensionFilter instead. The action validates that only metric names are used in metricFilter and will reject dimension names with a clear error. Structure: {'filter': {'fieldName': '<metric_name>', 'numericFilter': {'operation': 'GREATER_THAN', 'value': {'int64Value': '0'}}}} or use 'andGroup'/'orGroup' for multiple conditions.

keepEmptyRows

boolean

Optional. If true, rows with all zero metrics will be returned; otherwise omitted.

dimensionFilter

object

Optional. Filter expression to restrict rows by dimension values. IMPORTANT: Only use dimension field names here (e.g., 'country', 'city', 'date', 'deviceCategory', 'pagePath'). Do NOT use metric names in dimensionFilter - if you need to filter by a metric (e.g., 'activeUsers', 'sessions', 'ecommercePurchases'), use metricFilter instead. Structure: {'filter': {'fieldName': '<dimension_name>', 'stringFilter': {...}}} or use 'andGroup'/'orGroup' for multiple conditions. COMPATIBILITY WARNING: Dimension filters must be compatible with the dimensions in your request. For example, filtering on 'sessionCampaignName' while using demographic dimensions (userAgeBracket, userGender) will fail. The filter field creates an implicit dimension that must be compatible with all other dimensions and metrics. Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to verify your filter dimensions work with your requested dimensions/metrics.

metricAggregations

array

"TOTAL"

Optional. Aggregation types to include over metrics, e.g., 'TOTAL', 'MINIMUM', 'MAXIMUM'.

returnPropertyQuota

boolean

Optional. If true, include the property's current quota state in the response.

removed_dimensions_internal

array

Internal field to store filtered dimension names for execution message. Not sent to API.


Google Analytics Send Events

Integration name: GOOGLE_ANALYTICS_SEND_EVENTS

Tool to send event data to Google Analytics 4 using the Measurement Protocol. Use when you need to track server-side events that supplement client-side gtag.js or Firebase tracking. The Measurement Protocol allows sending event data directly to GA4 from servers, applications, or other devices. Events are processed asynchronously and typically appear in reports within 24-48 hours. For validation, use the validation server endpoint first (mp/collect/validate).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

events

array

[{"name":"purchase","params":{"value":42.5,"currency":"USD"}}]

Required. Array of event objects to send. Maximum 25 events per request. Each event must have a 'name' and can optionally include 'params'.

consent

object

{"ad_user_data":"GRANTED","ad_personalization":"DENIED"}

Consent settings for Google Analytics 4.

user_id

string

"user_12345"

Optional. A unique identifier for a logged-in user. This should be a non-PII identifier that you use internally to identify a user. Maximum 256 characters.

client_id

string

"test_client_123"

Required. A unique identifier for a user/client. This should be a UUID or similar unique string that identifies a specific user across sessions. Maximum 256 characters.

api_secret

string

"abcd1234xyz"

Required. The API secret generated in the Google Analytics UI under Admin > Data Streams > Measurement Protocol API secrets. Used to authenticate requests.

measurement_id

string

"G-XXXXXXXXXX"

Required. The measurement ID for the web stream in the format G-XXXXXXX. This is found in the Google Analytics UI under Admin > Data Streams > Web Stream Details.

user_properties

object

{"subscription_tier":{"value":"premium"}}

Optional. User properties to set for this measurement. Each property must have a 'value' field. User properties persist across events.

timestamp_micros

integer

1234567890000000

Optional. Unix timestamp in microseconds for when the event occurred. If not provided, the current time is used. Can be up to 72 hours in the past.


Google Analytics Update Property

Integration name: GOOGLE_ANALYTICS_UPDATE_PROPERTY

Tool to update an existing GA4 Property. Use when you need to modify property settings such as display name, time zone, currency code, or industry category.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"properties/525798648"

Required. The resource name of the Property to update. Must be in the exact format: properties/{property_id} where property_id is a numeric identifier. IMPORTANT: Must start with 'properties/' prefix, contain no forward slashes in the property_id, have no trailing slashes, and no additional path segments. Valid example: 'properties/489591273'. Invalid examples: '489591273' (missing prefix), 'properties/489591273/' (trailing slash), 'properties/489591273/extra' (extra segments)

parent

string

"accounts/100"

Immutable. Resource name of this property's logical parent. Format: accounts/{account}, properties/{property}. Example: 'accounts/100', 'properties/101'

timeZone

string

"America/Los_Angeles"

Required. Reporting Time Zone, used as the day boundary for reports. Format: IANA time zone. Example: 'America/Los_Angeles'

updateMask

string

"displayName"

Required. The list of fields to be updated. Field names must be in snake case (e.g., 'display_name', 'time_zone', 'currency_code'). Omitted fields will not be updated. To replace the entire entity, use one path with the string '*' to match all fields. Common fields: 'display_name', 'time_zone', 'currency_code', 'industry_category'

displayName

string

"My Updated Property"

Human-readable display name for this property. The max allowed display name length is 100 UTF-16 code units.

currencyCode

string

"USD"

The currency type used in reports involving monetary values. Format: ISO 4217. Examples: 'USD', 'EUR', 'JPY'

propertyType

string

Property type for a property.

industryCategory

string

Industry category for a property.


Google Analytics Validate Events

Integration name: GOOGLE_ANALYTICS_VALIDATE_EVENTS

Tool to validate Measurement Protocol events before sending them to production. Use when you need to verify event structure and parameters are correct before sending real data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

events

array

[{"name":"test_event","params":{"session_id":"123","engagement_time_msec":"100"}}]

Required. Array of events to validate. Each event must have a 'name' field and optional 'params' object.

consent

object

Optional. The consent state for the user.

user_id

string

"user_123"

Optional. A unique identifier for a user.

client_id

string

"test_client_123"

Required. Unique client identifier. This uniquely identifies a user instance of a web client.

api_secret

string

"test_secret"

Required. The API secret from Google Analytics for the Measurement Protocol.

measurement_id

string

"G-ABC123XYZ"

Required. The measurement ID for web streams. Format: G-XXXXXXXXXX where X is alphanumeric.

user_properties

object

Optional. The user properties for the measurement.

timestamp_micros

string

"1234567890000000"

Optional. A Unix timestamp (in microseconds) for the time to associate with the event.