Sign in
Conversions

List conversion actions

Lists Google Ads conversion actions on the resolved customer, all types by default. Each action's tagSnippets (global site tag + event snippet) is included when Google has them for that action's type, e.g. WEBPAGE. Google-only; other platforms return 501. Requires the Ads add-on.

adAccountId (alias customerId) is optional: when omitted, it is resolved from the connection's accessible Google Ads customers, and the call fails with 400 when more than one is accessible (pass adAccountId to disambiguate).

The list itself is cached for the quota window (1 hour fresh, up to 7 days last-good; the cache key does not vary on type). The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

get/v1/ads/conversions/actions

Query parameters

accountIdstring required

SocialAccount _id (must be a googleads account).

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer.

customerIdstring

Alias of adAccountId, kept for existing callers

typestring

Filter by Google's ConversionActionType enum (e.g. WEBPAGE, UPLOAD_CLICKS).

Response

The resolved customer and its conversion actions.

customerIdstring

The Google Ads customer id the actions were read from.

cachedAtstring date-time nullable

When this list was fetched from Google. Null when it was never served from cache.

staleboolean

True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

Changes