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.

Put Google Ads to work View Google Ads integration docs

Overview

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.

Ask the assistant

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

Use cases

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

At a glance

Google Ads integration at a glance

VendorGoogle Ads

CategoryMarketing & Advertising

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 updatedJun 2026

Reference

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

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.

Security

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

Pairs well with Google Ads

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

FAQ

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.

No. The agent selects the right Google Ads action from your prompt. A workflow is only needed when you want a repeatable process — and the composer builds that for you from a description.

Through OAuth — you connect your Google Ads account once and ModuleX stores the token encrypted, scoped to your organization.

10, spanning contact to list by emails, ad group reports, ad reports and campaign reports.

Google Ads runs on your own credentials, so any Google Ads usage is billed by Google Ads directly. ModuleX meters the agent run — and if you connect your own model keys, there's no ModuleX markup on model usage.

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.

Put Google Ads to work View technical docs

Last updated: Jun 2026Browse all 175 integrations →