Google Ads / API Reference
gads_remove_users_from_customer_match_list
Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Remove users from a Customer Match user list. emails: list of email addresses (will be SHA-256 hashed). phone_numbers: list of phone numbers in E.164 format.
This is a write tool: it removes users from customer match list in your Google Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Remove users from customer match list in my Google Ads account for [user list id].
It takes 1 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_list_id | string | Yes | User List Id |
emails | array | No | Emails |
phone_numbers | array | No | Phone Numbers |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_remove_adgads_remove_ad_groupgads_remove_ad_group_age_rangegads_remove_ad_group_criteriongads_remove_ad_group_gendergads_remove_ad_group_income_range
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: