Skip to content
Google Ads logo

Google Ads integration

Marketing & Advertising · 10 actions · OAuth auth

Google Ads API integration: run GAQL reports across Campaigns, Ad Groups, Ads, and Customers; create customer lists; send offline conversions; generate keyword ideas.

The ModuleX Google Ads integration lets a ModuleX agent operate Google Ads on your behalf, running create, send and list actions across contact to list by emails, ad group reports and ad reports, directly from a plain-English request, using your organization's own Google Ads credentials. No pre-built workflow is required: the agent picks the right Google Ads action for the task.

Google Ads is a marketing & advertising platform. ModuleX adds the agent layer: ask for an outcome and it selects and runs the right Google Ads action. Or, when you want a repeatable process, the composer assembles a Google Ads workflow for you, streaming the nodes onto the canvas as it builds.

Drive Google Ads in plain English

Type what you want. A ModuleX agent picks the right Google Ads action, or chains several, and runs it. No workflow to build.

  • Add a contact to a Google Ads Customer Match user list by email
    resolves toadd_contact_to_list_by_email
  • Create a ConversionAction (offline conversion tracking) via ConversionActionService.mutate
    resolves tosend_offline_conversion
  • Show me the account id options that match what I describe
    resolves tolist_account_id_options

What you can automate with Google Ads

  • Add a contact to list by email on the flyadd_contact_to_list_by_email
  • Create an ad group report straight from a requestcreate_ad_group_report
  • Pull a list of account id options for a reportlist_account_id_options
  • Send an offline conversion where it needs to gosend_offline_conversion

Google Ads integration at a glance

Actions available10
AuthenticationOAuth
Uses your own credentialsYes
Works with the assistantYes
Works in the composerYes
Multi-step / tool-chainingYes
Technical referenceView docs
Integration version1.0.0
Last updatedJul 2026

All 10 Google Ads actions

Contact to List by Emails1
add_contact_to_list_by_email
Add a contact to a Google Ads Customer Match user list by email. Lists typically update in 6 to 12 hours. The email is SHA-256 hashed locally before upload.
Ad Group Reports1
create_ad_group_report
Run a GAQL search report for the ad_group resource via GoogleAdsService.search.
Ad Reports1
create_ad_report
Run a GAQL search report for the ad_group_ad resource via GoogleAdsService.search.
Campaign Reports1
create_campaign_report
Run a GAQL search report for the campaign resource via GoogleAdsService.search.
Customer Lists1
create_customer_list
Create a Google Ads UserList (CRM_BASED / RULE_BASED / LOGICAL / BASIC_USER_LIST / LOOKALIKE). Returns the new user list ID and resource name.
Customer Reports1
create_customer_report
Run a GAQL search report for the customer resource via GoogleAdsService.search.
Reports1
create_report
Run a GAQL search report against any resource via GoogleAdsService.search. Builds a SELECT/WHERE/ORDER/LIMIT query from the supplied fields/segments/metrics.
Keyword Ideas1
generate_keyword_ideas
Generate keyword ideas via KeywordPlanIdeaService.generateKeywordIdeas. Pass the GenerateKeywordIdeasRequest body fields under additional_fields.
Account ID Options1
list_account_id_options
List customer resources directly accessible by the authenticated user via CustomerService.ListAccessibleCustomers. Useful to discover candidate account_id values.
Offline Conversions1
send_offline_conversion
Create a ConversionAction (offline conversion tracking) via ConversionActionService.mutate.

See full parameters and response schemas in the Google Ads integration docs

Two ways to use Google Ads in ModuleX

Ask the assistantType what you want done and a ModuleX agent picks the right Google Ads action and runs it. No workflow to build.
Compose a workflowNeed it to happen every time? Describe the process and the composer wires Google Ads into a repeatable workflow you can run on a schedule, from chat, or as an API.

Connecting Google Ads

OAuthGoogle Ads uses OAuth. You connect your Google Ads account once; ModuleX stores the access token encrypted and scoped to your organization, so your team shares a single secure connection.

Step-by-step setup in the Google Ads docs

Works with Google Ads

Agents often chain Google Ads with these. Connect them once and one agent can use all of them in a single task.

Google Ads + ModuleX FAQ

  • A ModuleX agent can run any of Google Ads's 10 actions, across contact to list by emails, ad group reports, ad reports and campaign reports, from a plain-English request, using your organization's own Google Ads credentials.

Put Google Ads to work in ModuleX.

Connect Google Ads once with your own credentials and let your agent run all 10 actions on demand.

Last updated: Jul 2026Browse all 179 integrations