View as Markdown
Google Ads icon

Google Ads ACTION

Create Customer List

Create a new customer list in Google Ads. Use List User Lists to check existing lists or find seed list IDs for a Lookalike list. Set List Type, then fill in the props marked for that type; props marked for other types are ignored. Returns the new list ID and resource name. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Google Ads account once, then configure and run Create Customer List from your backend or agent.

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-create-customer-list",
  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",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Customer List inputs
Property Type Description
accountId Use Google Ads As string
The ID of an account of a customer directly accessible by the authenticated user. This is usually a Manager Account, used as login-customer-id (e.g., 1234567890). Use the List Account ID Options action to get the list of accessible accounts.
Required Dynamic
customerClientId Managed Account string
The ID of a customer client from the list of customers linked to the selected account (e.g., 1234567890). Use the List Customer Clients action to get the list of customer clients.
Optional Dynamic
name Name string
The name of the customer list.
Required
description Description string
Description of the customer list.
Optional
listType List Type string
The type of customer list to create.
Required
uploadKeyType Upload Key Type string
Matching key type of the list. Mixed data types are not allowed on the same list. Example: CONTACT_INFO (CRM-based only, required)
Optional
dataSourceType Data Source Type string
Data source of the list. Only customers on the allow-list can create third-party sourced CRM lists. Example: FIRST_PARTY (CRM-based only)
Optional
appId App ID string
A string that uniquely identifies a mobile application from which the data was collected. Example: com.example.app. See the documentation for more details. (CRM-based only)
Optional
prepopulationStatus Request Prepopulation boolean
If true, past site visitors or app users who match the list definition will be included in the list. This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. Example: true (Rule-based only)
Optional
flexibleRuleUserList Flexible Rule Customer List object
Flexible rule representation of visitors with one or multiple actions. See the documentation on how to build this object. Values will be parsed as JSON where applicable. Example: { "inclusiveRuleOperator": "AND", "inclusiveOperands": [...] } (Rule-based only)
Optional
rules Rules string[]
Logical list rules that define this customer list. See the documentation on how to build each rule. Each item is one JSON-encoded rule. Example: { "operator": "ALL", "ruleOperands": [{ "userList": "customers/1234567890/userLists/111" }] } (Logical only, required)
Optional
conversionActions Conversion action(s) string[]
One or more conversion actions to build the list with. Example: customers/1234567890/conversionActions/222 (Basic only)
Optional Dynamic
remarketingActions Remarketing action(s) string[]
One or more remarketing actions. Example: customers/1234567890/remarketingActions/333 (Basic only)
Optional Dynamic
seedUserListIds Seed User List(s) string[]
One or more customer lists from which this list is derived. Use List User Lists to find list IDs. Example: 111 (Lookalike only, required)
Optional Dynamic
expansionLevel Expansion Level string
Expansion level, reflecting the size of the lookalike audience. Example: NARROW (Lookalike only, required)
Optional
countryCodes Country Codes string[]
Countries targeted by the Lookalike. Example: ["US"] (Lookalike only, required)
Optional
additionalFields Additional Fields object
Additional UserList fields to set. Values will be parsed as JSON where applicable. Example: { "membershipLifeSpan": 30 }
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
google_ads-create-customer-list
Version
0.1.0
App
Google Ads
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes