Google Ads Connector

Manage campaigns, conversions, customers, and local services in Google Ads.

Connections

OAuth 2.0

OAuth 2.0 connection

This component uses OAuth 2.0 to connect to the Google Ads API.

Prerequisites

A Developer Token is required to work with Google Ads
The Customer ID of the Ads Manager account (the hyphenated number in the top-left corner of the Ads app) must be noted
A Google Developer account is required

Developer Token

The Developer Token is obtained from a Google Ads Manager account:

Sign in to Google Ads with the Google account that will be used for the integration
Click Tools & Settings in the top right corner
Under Setup, click API Center
In the Developer token section, click Create token or view the existing token
Copy and save the Developer Token value securely
Take note of the Customer ID displayed in the top-right corner of Google Ads (XXX-XXX-XXXX). This will be needed when configuring the connection.

Configure Google Cloud Project

Access the project selector in the top-left and select an existing project or create a new one.
Select APIs & Services -> Enabled APIs & services from the left hand menu
Click Enable APIs and Services towards the top of the screen
Search for "google ads api" and select Google Ads API in the results (avoid selecting AdWords as that is deprecated)
Click the Enable button to add the API to the project
On the sidebar, select Credentials.
An OAuth 2.0 app includes a "Consent Screen". Click CONFIGURE CONSENT SCREEN.
1. The app will be externally available to customers, so choose a User Type of External.
2. Fill out the OAuth consent screen with an app name, support email, app logo, domain, etc.
3. On the next page, add the https://www.googleapis.com/auth/adwords scope to the app.
4. Enter some test users for testing purposes. The app will only work for those testing users until it is "verified" by Google. When ready for verification, click PUBLISH APP on the OAuth consent screen. That will allow customers to authorize the integration to access their Google Ads.
Once the "Consent Screen" is configured, open the Credentials page from the sidebar again.
Click +CREATE CREDENTIALS and select OAuth client ID.
1. Under Application type select Web application.
2. Under Authorized redirect URIs enter the OAuth 2.0 callback URL: https://oauth2.integrations.acme.com/callback
3. Click CREATE.
Take note of the Client ID and Client Secret that are generated.

Configure the Connection

Client ID: From the Google Cloud Console OAuth client credentials
Client Secret: From the Google Cloud Console OAuth client credentials
Developer Token: From the Google Ads API Center
API Version: The Google Ads API version to use. Refer to the Google Ads API release notes for the latest version.

Supported API Versions

The component supports multiple API versions through the API Version connection field:

Version	Status	Tentative Sunset
v22	Recommended (default)	October 2026
v21	Stable	August 2026
v20	Stable	June 2026
v19	Legacy	February 2026

Sunset dates are tentative and subject to change. See the official deprecation and sunset schedule for the latest information.

After entering the credentials, authorize the connection by signing in with the same Google account used to create the Developer Token and OAuth credentials.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Client ID	Client Identifier of your app for the Google Ads API. Obtain from the Google Cloud Console.
Client Secret	Client Secret of your app for the Google Ads API. Obtain from the Google Cloud Console.
Developer Token	Developer token of your Account Manager account. Obtain from the Google Ads API Center.
API Version	The version of the Google Ads API to use. Defaults to v22. Older versions (v19, v20, v21) are supported by specifying the version explicitly. See API versions documentation.	v22

Triggers

Account Change History

Checks for account modifications with user attribution on a configured schedule.

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Resource Types	Types of resources to track changes for. Leave empty to track all resource types.
Include User Info	When true, user email and client type will be included in change events.	true

Campaign Budget Alerts

Checks for campaigns approaching or exceeding budget thresholds on a configured schedule.

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Alert Threshold (%)	Budget spend percentage at which to trigger an alert.	80
Include Shared Budgets	When true, shared budgets across multiple campaigns will be monitored.	true

New and Updated Campaigns

Checks for new and updated campaigns in a Google Ads account on a configured schedule.

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Change Types to Monitor	Types of campaign changes to detect. Leave empty to detect all change types.

Actions

Account Reports

Account Reports show the performance and metrics associated with the linked Local Services accounts of a Manager account.

Input	Comments	Default
Connection	The Google Ads connection to use.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Customer IDs	List of customer IDs to include in the report.	`["111-222-4444"]`
Page Size	Number of results to return per page. Defaults to 20.	1000
Page Token	Token for retrieving the next page of results. Returned in previous page responses.
Start Date	The start date of the date range, inclusive. Format: MM-DD-YYYY.
End Date	The end date of the date range, inclusive. Format: MM-DD-YYYY.

Confirm Client Link

Confirm a pending customer client link

Input	Comments	Default
Connection	The Google Ads connection to use.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Link ID	The unique identifier of the manager link. See Customer manager link documentation.

Create Client Link

Create an invitation to link a client account to a manager account

Input	Comments	Default
Connection	The Google Ads connection to use.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.

Detailed Lead Reports

Detailed Lead Reports show an in-depth view of leads associated with the linked Local Services accounts of a Manager account.

Input	Comments	Default
Connection	The Google Ads connection to use.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Customer IDs	List of customer IDs to include in the report.	`["111-222-4444"]`
Page Size	Number of results to return per page. Defaults to 20.	1000
Page Token	Token for retrieving the next page of results. Returned in previous page responses.
Start Date	The start date of the date range, inclusive. Format: MM-DD-YYYY.
End Date	The end date of the date range, inclusive. Format: MM-DD-YYYY.

Get Conversion Action

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Page Token	Token for retrieving the next page of results. Returned in previous page responses.

Get Customer

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Page Token	Token for retrieving the next page of results. Returned in previous page responses.

Invite User

Invite a user by email to a customer

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Email Address	The email address of the user to invite to the customer account.
Access Role	The access role to grant to the user. See Access roles documentation.

List Accessible Customers

Get a list of customers accessible to the logged in user

Input	Comments	Default
Connection	The Google Ads connection to use.

List Manager's Customers

List all customers under a manager account

Input	Comments	Default
Connection	The Google Ads connection to use.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Page Token	Token for retrieving the next page of results. Returned in previous page responses.
Fetch All	When true, all pages of results will be fetched automatically. When false, only the first page of results will be returned.	false

Mutate Campaign

Creates, updates, or removes campaigns as well as local services campaigns. Operation statuses are returned. NOTE: API v22 requires setting 'containsEuPoliticalAdvertising' field when creating campaigns or modifying location/proximity targeting on existing campaigns. See https://developers.google.com/google-ads/api/docs/release-notes#v22_0 for details.

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Operations	The list of operations to perform on individual campaigns. See Campaign operations documentation.	[ { "updateMask": "string", "create": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/Campaign", "update": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/Campaign", "remove": "string" }, { "updateMask": "string", "create": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/Campaign", "update": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/Campaign", "remove": "string" } ]
Partial Failure	When true, successful operations will be carried out and invalid operations will return errors. When false, all operations will be carried out in one transaction if and only if they are all valid. This should always be set to true. See Partial failure documentation.	false
Validate Only	When true, the request is validated but not executed. Only errors are returned, not results.	false

Mutate Campaign Criteria

Creates, updates, or removes campaign criteria as well as local services campaign criterion. Operation statuses are returned. NOTE: API v22 requires setting 'containsEuPoliticalAdvertising' field on the parent campaign before modifying location/proximity targeting criteria. See https://developers.google.com/google-ads/api/docs/release-notes#v22_0 for details.

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Operations	The list of operations to perform on individual campaigns. See Campaign operations documentation.	`[ { "updateMask": "string", "create": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/CampaignCriterion", "update": "refer to docs: https://developers.google.com/google-ads/api/rest/reference/rest/v22/CampaignCriterion", "remove": "string" } ]`
Partial Failure	When true, successful operations will be carried out and invalid operations will return errors. When false, all operations will be carried out in one transaction if and only if they are all valid. This should always be set to true. See Partial failure documentation.	false
Validate Only	When true, the request is validated but not executed. Only errors are returned, not results.	false

Raw Request

Send raw HTTP request to Google Ads

Input	Comments	Default
Connection	The Google Ads connection to use.
URL	Input the path only (/v22/customers:listAccessibleCustomers), The base URL is already included (https://googleads.googleapis.com). For example, to connect to https://googleads.googleapis.com/v22/customers:listAccessibleCustomers, only /v22/customers:listAccessibleCustomers is entered in this field. Note: If using the Raw Request action, you must specify the API version in the path (e.g., /v22/) to override the connection default.	/v22/
Method	The HTTP method to use.
Data	The HTTP body payload to send to the URL.
Form Data	The Form Data to be sent as a multipart form upload.
File Data	File Data to be sent as a multipart form upload.
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header	A list of headers to send with the request.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Timeout	The maximum time that a client will await a response to its request
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Search Ads

Returns all rows that match the search query. You can query for local services resources: https://developers.google.com/google-ads/api/docs/campaigns/local-service-campaigns#local_services_resources

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Query	Google Ads Query Language (GAQL) query string. See GAQL documentation.
Page Token	Token for retrieving the next page of results. Returned in previous page responses.
Return Total Results Count	When true, the total number of results that match the query ignoring the LIMIT clause will be included in the response. Default is false.	false
Fetch All	When true, all pages of results will be fetched automatically. When false, only the first page of results will be returned.	false

Upload Call Conversions

Upload offline call conversions into Google Ads in order to track ads that led to sales

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Conversions	The conversions that are being uploaded. See Click conversions documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Validate Only	When true, the request is validated but not executed. Only errors are returned, not results.	false

Upload Click Conversions

Upload offline click conversions into Google Ads in order to track ads that led to sales

Input	Comments	Default
Connection	The Google Ads connection to use.
Customer ID	Customer ID of the Google Ads Client account; accepts hyphenated or number forms. See Customer ID documentation.
Conversions	The conversions that are being uploaded. See Click conversions documentation.
Manager Customer ID	Customer ID of the Google Ads Manager account; accepts hyphenated or number forms. When used in conjunction with a sub account as the customer ID, this value is used as the 'login-customer-id' header for the HTTP request. See Customer ID documentation.
Validate Only	When true, the request is validated but not executed. Only errors are returned, not results.	false

Connections​

OAuth 2.0​

Prerequisites​

Developer Token​

Configure Google Cloud Project​

Configure the Connection​

Supported API Versions​

Triggers​

Account Change History​

Campaign Budget Alerts​

New and Updated Campaigns​

Actions​

Account Reports​

Confirm Client Link​

Create Client Link​

Detailed Lead Reports​

Get Conversion Action​

Get Customer​

Invite User​

List Accessible Customers​

List Manager's Customers​

Mutate Campaign​

Mutate Campaign Criteria​

Raw Request​

Search Ads​

Upload Call Conversions​

Upload Click Conversions​