# Google Ads — Pipedream Connect

> Reach customers wherever they are. Show up at the right time and place across the vast Google Ads ecosystem.

- API slug: `google_ads` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Data Analytics
- Website: https://ads.google.com
- Managed OAuth scopes: `email` · `profile` · `https://www.googleapis.com/auth/adwords`
- This page (HTML): https://pipedream.com/apps/google-ads
- Tools: 37 actions · 2 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: google_ads`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "google_ads",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Contact to Customer List by Email:
const result = await mcp.callTool({
  name: "google_ads-add-contact-to-list-by-email",
  arguments: {
    accountId: "Use Google Ads As",
    customerClientId: "Managed Account",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Google Ads endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://www.googleapis.com/oauth2/v1/userinfo

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vb2F1dGgyL3YxL3VzZXJpbmZv?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_ads-add-contact-to-list-by-email",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_ads: { authProvisionId: "apn_xxxxxxx" },
    accountId: "Use Google Ads As",
    customerClientId: "Managed Account",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (37)

### `google_ads-add-contact-to-list-by-email` — Add Contact to Customer List by Email (Write)

Adds a contact to a specific customer list in Google Ads. Lists typically update in 6 to 12 hours after operation. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/add-contact-to-list-by-email.md

### `google_ads-create-ad-group-report` — Create Ad Group Report (Read-only)

Creates a report for the Ad Group resource. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-ad-group-report.md

### `google_ads-create-ad-report` — Create Ad Report (Read-only)

Creates a report for the Ad resource. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-ad-report.md

### `google_ads-create-campaign-report` — Create Campaign Report (Read-only)

Creates a report for the Campaign resource. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-campaign-report.md

### `google_ads-create-customer-list` — Create Customer List (Write)

Create a new customer list in Google Ads. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-customer-list.md

### `google_ads-create-customer-report` — Create Customer Report (Read-only)

Creates a report for the Customer resource. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-customer-report.md

### `google_ads-create-or-remove-campaign-criteria` — Create or Remove Campaign Criteria (Write)

Creates or removes criteria for a campaign (e.g., keyword targeting, brand lists). See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-remove-campaign-criteria.md

### `google_ads-create-or-remove-campaign-shared-set` — Create or Remove Campaign Shared Set (Write)

Attaches or detaches a shared set from a campaign. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-remove-campaign-shared-set.md

### `google_ads-create-or-remove-shared-criteria` — Create or Remove Shared Criteria (Write)

Creates or removes criteria from a shared set (e.g., negative keywords). See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-remove-shared-criteria.md

### `google_ads-create-or-update-ad-group` — Create or Update Ad Group (Write)

Creates or updates an ad group. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-ad-group.md

### `google_ads-create-or-update-bidding-strategy` — Create or Update Bidding Strategy (Write)

Creates, updates, or removes a portfolio bidding strategy. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-bidding-strategy.md

### `google_ads-create-or-update-campaign` — Create or Update Campaign (Write)

Creates or updates a campaign. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-campaign.md

### `google_ads-create-or-update-campaign-budget` — Create or Update Campaign Budget (Write)

Creates, updates, or removes a campaign budget. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-campaign-budget.md

### `google_ads-create-or-update-shared-sets` — Create or Update Shared Sets (Write)

Creates or updates shared sets (reusable lists of negative keywords or placements). See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-shared-sets.md

### `google_ads-create-report` — Create Report (Read-only)

Generates a report from your Google Ads data. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-report.md

### `google_ads-create-responsive-search-ad` — Create Responsive Search Ad (Write)

Creates a Responsive Search Ad (RSA) in an ad group. RSA copy (headlines, descriptions) cannot be edited in-place after creation — to change ad copy, remove the existing ad and create a new one. URL fields (finalUrls, trackingUrlTemplate, etc.) can be updated in-place via the Create or Update Ad…

Full schema: https://pipedream.com/apps/google-ads/actions/create-responsive-search-ad.md

### `google_ads-create-or-update-ad-group-ad` — Create, Update, or Remove Ad Group Ad (Write)

Creates, updates, or removes an ad group ad. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-ad-group-ad.md

### `google_ads-create-or-update-keywords` — Create, Update, or Remove Keywords (Write)

Creates, updates, or removes keyword criteria for an ad group. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/create-or-update-keywords.md

### `google_ads-generate-keyword-ideas` — Generate Keyword Ideas (Read-only)

Generate keyword ideas using the Google Ads API. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/generate-keyword-ideas.md

### `google_ads-get-keyword-quality-scores` — Get Keyword Quality Scores (Read-only)

Retrieves current and historical quality score data (Quality Score, Ad Relevance, Landing Page Experience, Expected CTR) for keywords in a customer account. Current scores reflect the latest evaluation; historical scores are averaged over the selected date range. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/get-keyword-quality-scores.md

### `google_ads-list-account-id-options` — List Account ID Options (Read-only)

Retrieves available options for the Account ID field.

Full schema: https://pipedream.com/apps/google-ads/actions/list-account-id-options.md

### `google_ads-list-ad-group-ads` — List Ad Group Ads (Read-only)

List ads within ad groups for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-ad-group-ads.md

### `google_ads-list-ad-group-criteria` — List Ad Group Criteria (Read-only)

List criteria (keywords, placements, audiences, etc.) for ad groups in a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-ad-group-criteria.md

### `google_ads-list-ad-groups` — List Ad Groups (Read-only)

List ad groups for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-ad-groups.md

### `google_ads-list-bidding-strategies` — List Bidding Strategies (Read-only)

List portfolio bidding strategies for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-bidding-strategies.md

### `google_ads-list-campaign-budgets` — List Campaign Budgets (Read-only)

List campaign budgets for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-campaign-budgets.md

### `google_ads-list-campaign-criteria` — List Campaign Criteria (Read-only)

List criteria (keywords, placements, etc.) for campaigns in a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-campaign-criteria.md

### `google_ads-list-campaign-shared-sets` — List Campaign Shared Sets (Read-only)

List shared sets attached to campaigns for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-campaign-shared-sets.md

### `google_ads-list-campaigns` — List Campaigns (Read-only)

List campaigns for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-campaigns.md

### `google_ads-list-customer-clients` — List Customer Clients (Read-only)

List all customer clients for a given account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-customer-clients.md

### `google_ads-list-keywords` — List Keywords (Read-only)

List keyword criteria for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-keywords.md

### `google_ads-list-shared-criteria` — List Shared Criteria (Read-only)

List criteria within shared sets for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-shared-criteria.md

### `google_ads-list-shared-sets` — List Shared Sets (Read-only)

List shared sets for a customer account. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/list-shared-sets.md

### `google_ads-send-offline-conversion` — Send Offline Conversion (Write)

Create a Google Ads conversion action. To record conversions against an upload-type action, use Upload Click Conversion or Upload Call Conversion. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/send-offline-conversion.md

### `google_ads-update-campaign-ai-max-settings` — Update Campaign AI Max Settings (Write)

Enables or configures AI Max for Search settings on a campaign. Only supported on Search campaigns. Toggling AI Max while simultaneously editing brand or text customization settings on the same campaign may fail — update them separately. Ad group-level search term matching is controlled via the…

Full schema: https://pipedream.com/apps/google-ads/actions/update-campaign-ai-max-settings.md

### `google_ads-upload-call-conversion` — Upload Call Conversion (Write)

Uploads an offline conversion attributed to a phone call. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/upload-call-conversion.md

### `google_ads-upload-click-conversion` — Upload Click Conversion (Write)

Uploads an offline conversion attributed to an ad click. See the documentation

Full schema: https://pipedream.com/apps/google-ads/actions/upload-click-conversion.md

## Triggers (2)

### `google_ads-new-campaign-created` — New Campaign Created (Polling)

Emit new event when a new campaign is created. See the documentation

Full schema: https://pipedream.com/apps/google-ads/triggers/new-campaign-created.md

### `google_ads-new-lead-form-entry` — New Lead Form Entry (Polling)

Emit new event for new leads on a Lead Form. See the documentation

Full schema: https://pipedream.com/apps/google-ads/triggers/new-lead-form-entry.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt