← All action domains

Google insights

6 operations. Call each with POST https://app.chirply.io/api/v1/actions/<name> and a bearer token; the response is { "data": { "action", "summary", "result" } }. A read badge means the operation changes nothing; write requires the credential’s write scope.

Load Google properties

google_insights.choicesreadadmin only

List GA4 properties and verified Search Console sites accessible through this account's Google Insights grant. Uses Google API quota, changes nothing and incurs no advertising spend.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this Chirply account.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.choices \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_choices at https://app.chirply.io/api/mcp, same bearer token, same input.

Connect Google Insights

google_insights.connectreadadmin only

Return an account-bound Google consent link. An account manager must approve read-only Analytics and Search Console access in Google. Does not install tracking, change Google data or spend money.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.connect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_connect at https://app.chirply.io/api/mcp, same bearer token, same input.

Disconnect Google Insights

google_insights.disconnectwriteconfirmadmin only

Remove the stored Google Insights refresh token from this account and stop its reports until reconnected. Keeps property selection for reconnection. Does not delete Google data or revoke other Google integrations; Google-side app permissions can be removed separately in Google.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this Chirply account.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.disconnect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_disconnect at https://app.chirply.io/api/mcp, same bearer token, same input.

Refresh Google reports

google_insights.reportread

Read aggregate GA4 users, sessions, page views and key events, plus Search Console web clicks, impressions, CTR and position for this account's saved properties. Includes daily trends and top ten channels, queries and pages. Uses Google API quota. Omits the newest three days, requests final Search Console data, and exposes partial failures rather than zeroing failed reports. Query rows may omit anonymized searches. No Google data is changed and no money is spent.

Parameters

FieldTypeRequiredDescription
days7 | 28 | 90optionalNumber of completed days to report; excludes the latest three days to accommodate Google processing delays. Default: 28

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.report \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_report at https://app.chirply.io/api/mcp, same bearer token, same input.

Save reporting properties

google_insights.savewriteadmin only

Verify property access and save this account's GA4 and/or Search Console dashboard selection. Reports are shared with account members. Does not change Google properties, install tracking or spend money.

Parameters

FieldTypeRequiredDescription
connection_idstring (uuid)requiredGoogle Insights connection ID belonging to this Chirply account.
property_idstring (or null)requiredGA4 property resource from the property picker, or null for Search Console only.
site_urlstring (or null)requiredExact Search Console site URL or sc-domain identifier from the site picker, or null for Analytics only.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.save \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "property_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "site_url": "https://example.com"
  }'
Test with your API key

Over MCP the same operation is the tool google_insights_save at https://app.chirply.io/api/mcp, same bearer token, same input.

Google Insights connections

google_insights.statusread

Read this account's Google Insights connection status and selected reporting properties. Excludes credentials; does not change data or spend money.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/google_insights.status \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
Test with your API key

Over MCP the same operation is the tool google_insights_status at https://app.chirply.io/api/mcp, same bearer token, same input.

The machine-readable version of this page is GET https://app.chirply.io/api/v1/actions?domain=google_insights — same operations, with full JSON Schemas. Authentication, errors and rate limits are covered in the API documentation home.