Integrations
Google Ads
A Google Ads integration connects Google Ads to Mobius so agents can query Ads accounts, generate Keyword Planner ideas, and update campaign status.
Use Google Ads when an agent needs keyword research, campaign monitoring, or a controlled campaign change after review.
For the shared Google credential model, see Google integrations.
Capability map
| Capability | Value |
|---|---|
| Provider ID | google_ads |
| Auth kind | oauth2_user |
| Connect flow | Google OAuth user grant plus Mobius Google Ads developer token |
| Actions | Yes |
| Events | No |
| Webhook delivery | No |
| Event samples | No |
| Live status | Yes |
Google Ads calls require your Google OAuth grant and a Google Ads developer token configured by Mobius. If Continue with Google is unavailable, or a connected account reports a developer-token error, contact your organization administrator or Mobius support. There is no server configuration for you to paste into this page.
Connect Google Ads
| Surface | Support |
|---|---|
| App | Open Library > Integrations, choose Google Ads, and continue through Google OAuth. |
| CLI | The mobius CLI does not connect Google Ads integrations yet. Use the app or API. |
| API | Call POST /v1/integrations/providers/google_ads/connect. The response is a redirect flow. |
After OAuth, Mobius lists the Google Ads customers directly accessible to the connected account and stores the discovered customer IDs in the integration configuration.
If the account is part of a manager hierarchy, connect with a user that can see the client accounts the agent will query or change.
Account defaults
Use the Google Ads integration page to set:
| Setting | Use |
|---|---|
| Default customer ID | The Ads customer used when an action omits customer_id. |
| Manager customer ID | Optional login-customer-id for accounts accessed through a Google Ads Manager hierarchy. |
The fields accept hyphenated or bare customer IDs. Mobius stores the normalized ID without spaces or hyphens.
Set Default customer ID for the account most work should use. Set
Manager customer ID only when Google Ads requires a login-customer-id
header for access through a manager account. Individual action inputs can still
override both fields.
Actions
google_ads.customer.list_accessible
google_ads.search
google_ads.keyword_ideas.generate
google_ads.campaign.status.setUse google_ads.keyword_ideas.generate for keyword research and historical
metrics. Use google_ads.search for GAQL queries. Campaign status changes are
mutating, so add an interaction before changing
live campaigns when a human should approve the update.
Keyword ideas input
google_ads.keyword_ideas.generate needs one seed:
| Seed | Use when |
|---|---|
keywords | You already have one or more seed phrases. |
page_url | You want Google Ads to infer ideas from one landing page. |
site_domain | You want ideas from a whole domain. Do not combine this with keywords or page_url. |
language_id defaults to 1000 for English. keyword_plan_network defaults
to GOOGLE_SEARCH.
Campaign status changes
google_ads.campaign.status.set accepts ENABLED, PAUSED, or REMOVED.
Use validate_only: true when you want Google Ads to check the mutation without
changing the campaign.
Events
Google Ads does not register source events.
Troubleshooting
Google returns developer-token errors
The OAuth account may be valid while Mobius's developer token is missing, pending approval, or not allowed to call the target account. Send the error text and connected Ads customer ID to your organization administrator or Mobius support.
No accessible customers appear after OAuth
Reconnect with a Google user that has access to the Ads account. If the account is behind a manager account, set Manager customer ID on the integration page.
Actions ask for customer_id
Set Default customer ID after connecting. Leave action-level customer_id
blank for the common account, and provide it only when an agent needs a different
Ads customer.
Next
- Inspect action schemas from actions.
- Store research outputs in tables.
- Gate campaign updates with interactions.