Auth type: OAuthDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For setup fundamentals and permissions, start here: App Integrations.
Connect Google Ads
- Go to Settings → Apps in Hyper
- Select Google Ads → Connect New
- Complete OAuth and choose the correct ad account
Common capabilities
- Read campaign/ad group performance
- Propose budgets and bid strategies
- Draft new ad copy and variations
Use in Chat
Enable Google Ads and ask for performance summaries or draft campaigns.Use in Agents
Add Google Ads to toolkits; require approval for write/publish actions.Use in Flows
Automate reporting and experimentation across campaigns.Troubleshooting
- Wrong account: reconnect and select the intended customer account
- Insufficient scopes: reauthorize with required permissions
Available Actions
Hyper agents can run the following actions for this integration. Each action can be individually set to Enabled, Requires Approval, or Disabled in your agent’s toolkit settings. Actions can be set to one of three control states:| State | Behavior |
|---|---|
| Enabled | Agent runs the action automatically |
| Requires Approval | Agent pauses and waits for your confirmation before proceeding |
| Disabled | Action is blocked and cannot be used |
| Action | Description |
|---|---|
| Add Audience Target | Add audience targeting to a Google Ads ad group |
| Add Location Target | Add location targeting to a Google Ads campaign |
| Create Ad | Create a new ad in an ad group |
| Create Ad Group | Create a new Google Ads ad group within an existing campaign |
| Create Budget | Create a new Google Ads campaign budget |
| Create Campaign | Create a new Google Ads campaign with budget |
| Create From Blueprint | Create a full Google Ads campaign (budget + campaign + locations + |
| Create From Pmax Blueprint | Create a full Performance Max campaign (budget + campaign + locations + |
| Create Keyword | Add a keyword to a Google Ads ad group |
| Delete Ad | Delete an ad from an ad group |
| Delete Ad Group | Delete (remove) a Google Ads ad group |
| Delete Keyword | Delete (remove) a keyword from a Google Ads ad group |
| Execute Gaql | Execute a Google Ads Query Language (GAQL) query |
| Get Ad Performance | Get ad performance metrics for specific campaigns and ad groups |
| Get Asset | Get a single asset by id |
| Get Campaign Performance | Get campaign performance metrics for a specific time period |
| Get Health Check | |
| Link Asset | Alias of google_ads_link_asset_smart |
| Link Asset Smart | |
| Link Asset To Ad | Link an asset to a specific RSA ad (HEADLINE or DESCRIPTION) |
| Link Asset To Asset Group | Link an asset to a PMax asset group (field_type e.g., MARKETING_IMAGE) |
| Link Asset To Campaign | Link an asset to a campaign (field_type, e.g., IMAGE) |
| List Accounts | List all accessible Google Ads accounts |
| List Ad Groups | List ad groups for a campaign |
| List Asset Groups | List asset groups for a Performance Max campaign |
| List Assets | List assets for a customer (optionally filter by type) |
| List Audience Targets | List all audience targets for a Google Ads ad group |
| List Campaigns | List campaigns for a given customer id |
| List Keywords | List all keywords in a Google Ads ad group |
| List Location Targets | List all location targets for a Google Ads campaign |
| List My Campaigns | List campaigns for the best default accessible account (no customer_id needed) |
| List Rsa Ads | List Responsive Search Ads in an ad group |
| Preview Blueprint | Preview and validate a full Google Ads campaign blueprint BEFORE |
| Preview Pmax Blueprint | Preview and validate a Performance Max campaign blueprint BEFORE |
| Remove Audience Target | Remove audience targeting from a Google Ads ad group |
| Remove Location Target | Remove location targeting from a Google Ads campaign |
| Run Gaql | Run a custom GAQL query with flexible formatting options |
| Run Health Check | Run a health check on all Google Ads accounts for this integration |
| Search Audiences | Search for available audiences and user lists to use in targeting |
| Search Locations | Search for location IDs to use in location targeting |
| Unlink Asset | Alias of google_ads_unlink_asset_smart |
| Unlink Asset From Ad | Unlink an asset from a specific RSA ad |
| Unlink Asset From Asset Group | Unlink an asset from a PMax asset group |
| Unlink Asset From Campaign | Unlink an asset from a campaign (requires same field_type used when linking) |
| Unlink Asset Smart | |
| Update Ad | Update an existing ad in an ad group |
| Update Ad Group | Update an existing Google Ads ad group (status, name, or bidding) |
| Update Campaign | Update a campaign (status, name, dates, bidding, network settings) |
| Update Keyword | Update an existing keyword in a Google Ads ad group |
| Upload Image Asset | Upload an image asset (accepts image_url or image_base64) |