Skip to content
GActionGoogle AdsUpdated May 2026

How do I add a user to a Google Ads customer list?

Short answer: Drop the "Google AdsAdd User to Customer List" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Customer ID
customer_id
stringRequiredGoogle Ads customer ID (no dashes)
User List ID
user_list_id
stringRequiredID of the customer match user list
Hashed Email
hashed_email
stringOptionalSHA-256 hashed, lowercase email
Hashed Phone
hashed_phone
stringOptionalSHA-256 hashed phone in E.164 format
Manager Account ID
login_customer_id
stringOptionalMCC manager account ID (optional)
Sample request
{
"customer_id": "{{trigger.customer_id}}",
"user_list_id": "{{trigger.user_list_id}}",
"hashed_email": "{{trigger.hashed_email}}",
"hashed_phone": "{{trigger.hashed_phone}}",
"login_customer_id": "{{trigger.login_customer_id}}"
}
Returns
{
"resourceName": "customers/1234567890/offlineUserDataJobs/444"
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Add User to Customer List.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Add User to Customer List.

What does the Add User to Customer List action do in Google Ads?
Adds an email (hashed for matching) to a Customer Match list — Google Ads uses these for retargeting, lookalike audiences, and exclusions. For "high-LTV customers → add to lookalike-seed list" or "churned customers → exclude from acquisition campaigns" workflows.
What inputs does Add User to Customer List require?
Required: Customer ID, User List ID. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Google Ads returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Add User to Customer List support batch operations?
Yes. Run Add User to Customer List inside a Loop node to process arrays. Tiny Command handles Google Ads's rate limits automatically so you don't have to throttle manually.
More actions

Other Google Ads actions.

Send add user to customer list from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.