How to add user to customer list in Google Ads

Add User to Customer List in Google Ads — start free

Inputs

The fields this action accepts.

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

Field	Type	Required	Description
Customer ID customer_id	string	Required	Google Ads customer ID (no dashes)
User List ID user_list_id	string	Required	ID of the customer match user list
Hashed Email hashed_email	string	Optional	SHA-256 hashed, lowercase email
Hashed Phone hashed_phone	string	Optional	SHA-256 hashed phone in E.164 format
Manager Account ID login_customer_id	string	Optional	MCC 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.

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. TinyCommand handles Google Ads's rate limits automatically so you don't have to throttle manually.

More actions