- Category: ads & conversion
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 78
- Triggers: 0
- Slug:
GOOGLEADS - Version: 20261101_00
Frequently Asked Questions
Google Ads developer token now belongs on the auth config, not connection initiation
Google Ads developer token now belongs on the auth config, not connection initiation

What can cause Google Ads 429s?
What can cause Google Ads 429s?
RESOURCE_EXHAUSTED is an upstream Google Ads API limit, not a Composio billing-plan or tool-call quota. Google Ads enforces limits on the underlying developer token, account, request pattern, service, and resource usage.This can happen with Composio-managed credentials or with custom Google Ads credentials. Reduce request volume, add backoff, simplify expensive queries, and use an owned Google Ads OAuth app/developer token for production isolation where possible.Google Ads MCC/sub-account targeting
Google Ads MCC/sub-account targeting
GOOGLEADS_LIST_ACCESSIBLE_CUSTOMERS can succeed while GAQL/reporting or campaign calls against a child account fail. Two common Google errors are:- 403
USER_PERMISSION_DENIEDwith guidance that, when accessing a client customer, the manager customer ID must be set in thelogin-customer-idheader. REQUESTED_METRICS_FOR_MANAGERwhen metric fields are queried directly from the MCC manager account instead of a child/customer account.
- target child/customer account ID in the request path, for example
/customers/{child_customer_id}/googleAds:searchStream - manager/MCC customer ID in the
login-customer-idheader
Google Ads OAuth callback token-exchange failures usually point to bad credentials
Google Ads OAuth callback token-exchange failures usually point to bad credentials
OAuth callback failed during token exchange error usually means the credentials used to complete the auth flow are incorrect, most often the client secret. Re-enter or update the client secret in the Google Ads auth config, make sure there are no leading/trailing spaces, and initiate a new connection.What do custom Google OAuth apps need for white-label consent?
What do custom Google OAuth apps need for white-label consent?
Tools
Add or remove to customer list
Add or remove to customer list
GOOGLEADS_ADD_OR_REMOVE_TO_CUSTOMER_LISTSubmit email contacts for addition to or removal from a Google Ads Customer Match list through an asynchronous offline user data job, marking ad user data and personalization consent as granted. The returned status does not confirm processing completion.Input Parameters
Output
Batch Mutate Google Ads Resources
Batch Mutate Google Ads Resources
GOOGLEADS_BATCH_MUTATECreate, update, remove, or act on supported Google Ads resource types in one request. With partial_failure=false (the default), all operations are atomic and execute only if every operation is valid. With partial_failure=true, valid operations execute independently while invalid operations return errors. Use negative temporary resource IDs to connect resources created in the same request. Remove operations are destructive.Input Parameters
Output
Create Callout Asset
Create Callout Asset
GOOGLEADS_CREATE_CALLOUT_ASSETCreate an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field_type CALLOUT. Cleanup removes that association; Google does not allow deleting the asset.Input Parameters
Output
Create Customer Client
Create Customer Client
GOOGLEADS_CREATE_CUSTOMER_CLIENTCreate a new Google Ads client under an eligible direct parent manager. Requires a manager account, not an advertiser client account. Currency and time zone cannot be changed after creation. Set validate_only=true to check eligibility and parameters without account creation. Invitation fields require Google allowlisting.Input Parameters
Output
Create customer list
Create customer list
GOOGLEADS_CREATE_CUSTOMER_LISTCreates a Google Ads Customer Match user list for contact information, not a customer account. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation.Input Parameters
Output
Create data manager user list
Create data manager user list
GOOGLEADS_CREATE_DATA_MANAGER_USER_LISTCreate a Data Manager user list, or validate without creating one.Input Parameters
Output
Create Experiment
Create Experiment
GOOGLEADS_CREATE_EXPERIMENTCreate the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.Input Parameters
Output
Create Experiment Arms
Create Experiment Arms
GOOGLEADS_CREATE_EXPERIMENT_ARMSCreate two Google Ads experiment arms in one atomic batch: one control and one treatment arm belonging to the same experiment. The control arm must contain one campaign, and their traffic splits must total 100%.Input Parameters
Output
Delete data manager user list
Delete data manager user list
End Experiment
End Experiment
GOOGLEADS_END_EXPERIMENTImmediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment’s end date to now.Input Parameters
Output
Generate Keyword Forecast Metrics
Generate Keyword Forecast Metrics
GOOGLEADS_GENERATE_KEYWORD_FORECAST_METRICSForecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.Input Parameters
Output
Generate Keyword Historical Metrics
Generate Keyword Historical Metrics
GOOGLEADS_GENERATE_KEYWORD_HISTORICAL_METRICSRetrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.Input Parameters
Output
Generate Keyword Ideas
Generate Keyword Ideas
GOOGLEADS_GENERATE_KEYWORD_IDEASGenerate keyword ideas and planning metrics from exactly one seed form.Input Parameters
Output
Get Campaign By Id
Get Campaign By Id
GOOGLEADS_GET_CAMPAIGN_BY_IDRetrieve a Google Ads campaign’s name and status by numeric campaign ID for the specified or connected customer account.Input Parameters
Output
Get campaign by name
Get campaign by name
GOOGLEADS_GET_CAMPAIGN_BY_NAMERetrieve the first Google Ads campaign matching an exact name for the specified or connected customer account. Names containing quotes, backslashes, NUL or line breaks are not supported.Input Parameters
Output
Get Conversion Action Tag Snippets
Get Conversion Action Tag Snippets
GOOGLEADS_GET_CONVERSION_ACTION_TAG_SNIPPETSRetrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.Input Parameters
Output
Get conversion ingestion status
Get conversion ingestion status
GOOGLEADS_GET_CONVERSION_INGESTION_STATUSRetrieve one Data Manager ingestion status snapshot. SUCCESS, FAILED, and PARTIAL_SUCCESS are terminal. PROCESSING and REQUEST_STATUS_UNKNOWN are not. The caller owns the documented backoff loop.Input Parameters
Output
Get customer lists
Get customer lists
GOOGLEADS_GET_CUSTOMER_LISTSList a page of Google Ads customer lists (audience and remarketing user segments), not Google Ads accounts. Use the returned next-page token to retrieve further lists, and review similarly named results before selecting one.Input Parameters
Output
Get data manager user list
Get data manager user list
Get Experiment
Get Experiment
Get Experiment Arm
Get Experiment Arm
GOOGLEADS_GET_EXPERIMENT_ARMGet one Google Ads experiment arm, including draft campaigns.Input Parameters
Output
Get Required Google Ads Report
Get Required Google Ads Report
GOOGLEADS_GET_RMF_REPORTRun a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy. Official required columns are always selected; dates default to LAST_30_DAYS.Input Parameters
Output
Ingest ad events
Ingest ad events
GOOGLEADS_INGEST_AD_EVENTSUpload ad events for an allowlisted Data Partner to Google Analytics, not Ads. Requires an eligible Data Partner account linked to the target advertiser. Use validate_only=true for the provider’s deprecated no-execution check. The response is empty; this operation does not return a request ID.Input Parameters
Output
Ingest audience members
Ingest audience members
GOOGLEADS_INGEST_AUDIENCE_MEMBERSValidate or asynchronously ingest Data Manager audience members. Use validate_only=true for a no-upload check. Customer Match terms must already be accepted for contact/mobile data; do not assert acceptance without authority. Consent may be supplied per request or member. A request ID confirms acceptance, not completion; poll request status for processing errors and partial failures.Input Parameters
Output
Ingest conversion events
Ingest conversion events
GOOGLEADS_INGEST_CONVERSION_EVENTSValidate or submit a bounded Google Ads conversion-event batch. Set validate_only=true for a no-ingestion check. False starts irreversible asynchronous processing and returns a request ID for later status checks.Input Parameters
Output
Ingest users
Ingest users
GOOGLEADS_INGEST_USERSIngest account-level identity linkage, not audience-list membership. Requires provider allowlisting. Each user links hashed first-party identifiers with mobile device IDs. Set validate_only=true for no ingestion. A request ID confirms asynchronous acceptance, not completion; poll request status for errors.Input Parameters
Output
List Accessible Customers
List Accessible Customers
GOOGLEADS_LIST_ACCESSIBLE_CUSTOMERSList Google Ads customer resource names directly accessible to the authenticated OAuth user. Google determines the complete result from the OAuth credentials and ignores customer_id and login-customer-id; this action does not filter the response. For MCC child account names, status, and direct hierarchy, use List Sub Accounts.Input Parameters
Output
List data manager conversion actions
List data manager conversion actions
GOOGLEADS_LIST_DATA_MANAGER_CONVERSION_ACTIONSList conversion actions usable as Google Ads Data Manager destinations. Returns numeric destination IDs, true owning accounts, action types, and availability; defaults to enabled offline and enhanced-lead actions.Input Parameters
Output
List data manager user lists
List data manager user lists
GOOGLEADS_LIST_DATA_MANAGER_USER_LISTSList one page of Data Manager user lists and their lifecycle configuration.Input Parameters
Output
List Experiment Arms
List Experiment Arms
List Experiments
List Experiments
GOOGLEADS_LIST_EXPERIMENTSList Google Ads experiments, optionally filtered by status and type.Input Parameters
Output
List Sub Accounts
List Sub Accounts
GOOGLEADS_LIST_SUB_ACCOUNTSList direct child/sub-accounts under a Google Ads manager (MCC) account. Use this before account-scoped read or mutate calls when a user needs to choose which child account to target. The returned customer_id values can be passed to other Google Ads tools as their customer_id.Input Parameters
Output
Mutate Ad Group Ads
Mutate Ad Group Ads
GOOGLEADS_MUTATE_AD_GROUP_ADSCreate, update, or remove ads in Google Ads ad groups, including responsive search ads. Use this after creating campaigns, budgets, ad groups, and keywords so the ad group has creative that can serve.Input Parameters
Output
Mutate Ad Group Assets
Mutate Ad Group Assets
GOOGLEADS_MUTATE_AD_GROUP_ASSETSCreate, update, or remove links between assets and ad groups. Use this after creating assets to attach sitelinks, callouts, snippets, images, and other asset types at ad group level.Input Parameters
Output
Mutate Ad Group Bid Modifiers
Mutate Ad Group Bid Modifiers
GOOGLEADS_MUTATE_AD_GROUP_BID_MODIFIERSCreate, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.Input Parameters
Output
Mutate Ad Group Criteria
Mutate Ad Group Criteria
GOOGLEADS_MUTATE_AD_GROUP_CRITERIACreate, update, or remove Google Ads ad group criteria in a batch, including keywords, audiences, demographics, mobile apps, YouTube placements, topics, webpages, and Shopping listing groups. Manage bids or remove criteria; removal is irreversible, and validate-only requests test changes without committing them.Input Parameters
Output
Mutate Ad Groups
Mutate Ad Groups
GOOGLEADS_MUTATE_AD_GROUPSCreate, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations — deleted ad groups cannot be recovered once removed.Input Parameters
Output
Mutate Ads
Mutate Ads
GOOGLEADS_MUTATE_ADSUpdate existing Google Ads ad creative fields. Does not create or remove ads or modify ad-group association/status. Updating TextAd, ExpandedDynamicSearchAd, GmailAd, and ImageAd is not supported. Use validate_only for a dry run and inspect partial_failure_error when partial_failure is enabled.Input Parameters
Output
Mutate Asset Group Assets
Mutate Asset Group Assets
GOOGLEADS_MUTATE_ASSET_GROUP_ASSETSCreate, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.Input Parameters
Output
Mutate Asset Groups
Mutate Asset Groups
GOOGLEADS_MUTATE_ASSET_GROUPSCreate, update, or remove Google Ads asset groups for Performance Max campaigns. Use validate_only to check operations without making changes. Link assets separately with Mutate Asset Group Assets. Creating Performance Max asset groups may require a GoogleAdsService mutate with asset links in the same request to satisfy minimum asset requirements.Input Parameters
Output
Mutate Assets
Mutate Assets
GOOGLEADS_MUTATE_ASSETSCreate or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets. Use Create Callout Asset for validated immutable callouts. Google Ads does not allow removing assets; cleanup removes their resource associations.Input Parameters
Output
Mutate Asset Sets
Mutate Asset Sets
GOOGLEADS_MUTATE_ASSET_SETSCreate, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses. Link assets to a set separately with an AssetSetAsset mutation, and attach sets to campaigns with Mutate Campaign Asset Sets.Input Parameters
Output
Mutate Audiences
Mutate Audiences
GOOGLEADS_MUTATE_AUDIENCESCreate or update Google Ads audiences combining segment attributes. Does not support removal. Use validate_only to check operations without changing audiences. Inspect partial_failure_error when partial_failure is true.Input Parameters
Output
Mutate Bidding Strategies
Mutate Bidding Strategies
GOOGLEADS_MUTATE_BIDDING_STRATEGIESCreate, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.Input Parameters
Output
Mutate Campaign Assets
Mutate Campaign Assets
GOOGLEADS_MUTATE_CAMPAIGN_ASSETSCreate, update, or remove links between assets and campaigns. Use this after creating assets to attach sitelinks, callouts, snippets, and other asset types at campaign level.Input Parameters
Output
Mutate Campaign Budgets
Mutate Campaign Budgets
GOOGLEADS_MUTATE_CAMPAIGN_BUDGETSCreate, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.Input Parameters
Output
Mutate Campaign Criteria
Mutate Campaign Criteria
GOOGLEADS_MUTATE_CAMPAIGN_CRITERIACreate, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.Input Parameters
Output
Mutate Campaign Labels
Mutate Campaign Labels
GOOGLEADS_MUTATE_CAMPAIGN_LABELSCreate or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.Input Parameters
Output
Mutate Campaigns
Mutate Campaigns
GOOGLEADS_MUTATE_CAMPAIGNSCreate, update, or remove Google Ads campaigns in a batch; removal is irreversible and validate-only can check changes before applying them. Creates default to a declaration that the campaign does not contain EU political advertising and to Manual CPC when no bidding strategy is supplied.Input Parameters
Output
Mutate Campaigns V2
Mutate Campaigns V2
GOOGLEADS_MUTATE_CAMPAIGNS_V2Create, update, or remove Search and Display Google Ads campaigns in a batch; new campaigns default to paused when status is omitted. Removal is irreversible, and validate-only can check changes before applying them.Input Parameters
Output
Mutate Conversion Actions
Mutate Conversion Actions
GOOGLEADS_MUTATE_CONVERSION_ACTIONSCreate, update, or remove Google Ads conversion actions for conversion tracking configuration. This manages Google Ads conversion action resources; installing website/app tags remains outside this action.Input Parameters
Output
Mutate Custom Audiences
Mutate Custom Audiences
GOOGLEADS_MUTATE_CUSTOM_AUDIENCESCreate, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.Input Parameters
Output
Mutate Customer
Mutate Customer
GOOGLEADS_MUTATE_CUSTOMERUpdate one Google Ads customer’s mutable account settings using CustomerService. This is not the GoogleAdsService batch mutate endpoint. Use validate_only=true to check an update without changing account settings.Input Parameters
Output
Mutate Customer Assets
Mutate Customer Assets
GOOGLEADS_MUTATE_CUSTOMER_ASSETSCreate or remove customer-level asset associations. Removal irreversibly removes the current association; recreate it to restore the link. Use this after creating assets to attach callouts, sitelinks, snippets, and other asset types across a Google Ads customer account.Input Parameters
Output
Mutate Keyword Plan Ad Group Keywords
Mutate Keyword Plan Ad Group Keywords
GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUP_KEYWORDSCreate, update, or remove Google Ads Keyword Planner ad group keywords. These are planning resources, not serving keywords. Creates need an existing Keyword Plan ad group. Use validate_only to validate without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.Input Parameters
Output
Mutate Keyword Plan Ad Groups
Mutate Keyword Plan Ad Groups
GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUPSCreate, update, or remove Google Ads Keyword Planner ad groups. These are planning resources, not serving ad groups. A create needs an existing keyword plan campaign. Use validate_only to check operations without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.Input Parameters
Output
Mutate Keyword Plan Campaign Keywords
Mutate Keyword Plan Campaign Keywords
GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGN_KEYWORDSCreate, update, or remove negative keywords in Keyword Plan campaigns. These planning resources do not change serving campaign keywords. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; valid operations may be applied.Input Parameters
Output
Mutate Keyword Plan Campaigns
Mutate Keyword Plan Campaigns
GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGNSCreate, update, or remove campaigns in an existing Keyword Plan. These planning resources do not create serving ad campaigns. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; successful operations may still have been applied.Input Parameters
Output
Mutate Keyword Plans
Mutate Keyword Plans
GOOGLEADS_MUTATE_KEYWORD_PLANSCreate, update, or remove saved Google Ads Keyword Planner plans. These plans are planning resources, not live advertising campaigns. Use validate_only to validate without saving changes. With partial_failure, inspect partial_failure_error even when the HTTP request succeeds.Input Parameters
Output
Mutate Labels
Mutate Labels
GOOGLEADS_MUTATE_LABELSCreate, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.Input Parameters
Output
Mutate Portfolio Bidding Strategies
Mutate Portfolio Bidding Strategies
GOOGLEADS_MUTATE_PORTFOLIO_BIDDING_STRATEGIESCreate, edit, or remove typed Target CPA and Target ROAS portfolio strategies. Attach with Mutate Campaigns, read with Get Required Google Ads Report, and transition all campaigns before removal. Budget alignment is not exposed because Google requires the bidding strategy and campaign budget to be changed atomically with GoogleAdsService.Mutate, while this action uses the resource-specific mutate endpoint. currency_code can be set on create only for manager-account strategies.Input Parameters
Output
Mutate User Lists
Mutate User Lists
GOOGLEADS_MUTATE_USER_LISTSCreate, update, or remove general Google Ads user-list resources used for audience targeting and remarketing.Input Parameters
Output
Remove all audience members
Remove all audience members
Remove audience members
Remove audience members
GOOGLEADS_REMOVE_AUDIENCE_MEMBERSRemove specific users from Data Manager audience destinations. Set validate_only=true to validate without removing users. Execution is asynchronous: a request ID indicates acceptance, not completion. Query its status for errors and partial failures.Input Parameters
Output
Remove users
Remove users
GOOGLEADS_REMOVE_USERSRemove users identified by hashed user data from Data Manager destinations. Available only to allowlisted accounts; takes user_data, not audience_members or mobile IDs. Set validate_only=true to validate without removal. A request ID indicates asynchronous acceptance, not completion; query request status for processing errors and partial failures.Input Parameters
Output
Schedule Experiment
Schedule Experiment
GOOGLEADS_SCHEDULE_EXPERIMENTSchedule a Google Ads experiment and return its long-running operation. This materializes the treatment campaign and can begin serving and spending on its start date; the experiment cannot return to SETUP after scheduling. When validate_only is true, Google validates the request and returns no operation.Input Parameters
Output
Search GAQL
Search GAQL
Search Google Ads Fields
Search Google Ads Fields
GOOGLEADS_SEARCH_GOOGLE_ADS_FIELDSSearch the Google Ads v26 field metadata catalog with GAQL.Input Parameters
Output
Search Stream GAQL
Search Stream GAQL
GOOGLEADS_SEARCH_STREAM_GAQLExecute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order. For very large reports, select only needed fields and use WHERE and LIMIT because action responses are returned inline and are not automatically offloaded.Input Parameters
Output
Update data manager user list
Update data manager user list
GOOGLEADS_UPDATE_DATA_MANAGER_USER_LISTUpdate mutable Data Manager user-list metadata, optionally validating only.Input Parameters
Output
Update Experiment
Update Experiment
Update Experiment Arms
Update Experiment Arms
GOOGLEADS_UPDATE_EXPERIMENT_ARMSUpdate one or more Google Ads experiment arms.Input Parameters
Output
Upload Call Conversions
Upload Call Conversions
GOOGLEADS_UPLOAD_CALL_CONVERSIONSUpload offline call conversions to Google Ads, or validate them without uploading using validate_only. Inspect partial_failure_error for row failures even when the request succeeds.Input Parameters
Output
Upload Click Conversions
Upload Click Conversions
GOOGLEADS_UPLOAD_CLICK_CONVERSIONSUpload offline click conversions with optional enhanced-conversion identifiers, consent, and cart data. Restricted to existing allowlisted upload integrations; new integrations should use the Data Manager API. This records conversions unless validate_only is true. Inspect partial_failure_error for row failures even on HTTP 200; validate-only does not return conversion results.Input Parameters
Output
Upload Conversion Adjustments
Upload Conversion Adjustments
GOOGLEADS_UPLOAD_CONVERSION_ADJUSTMENTSUpload retractions, restatements, or enhancements of existing conversions. Set validate_only=true to check without changing conversions. Inspect partial_failure_error even when HTTP succeeds.Input Parameters
Output
Upload User Data
Upload User Data
GOOGLEADS_UPLOAD_USER_DATAAppend or remove already-hashed user data in a Google Ads Customer Match list. This endpoint performs real uploads: it has no validation-only or partial-failure mode. Supply consent as appropriate; per-user consent overrides list metadata. Uploads through this service are not visible in the UI’s Segment members section. Requires an existing Google-approved Customer Match upload integration; new integrations should use Data Manager audience ingestion instead.