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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "google_ads-create-customer-list",
"configured_props": {
"google_ads": { "authProvisionId": "apn_xxxxxxx" },
"accountId": "Use Google Ads As",
"customerClientId": "Managed Account"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{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()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "google_ads-create-customer-list",
arguments: {
accountId: "Use Google Ads As",
customerClientId: "Managed Account",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗