Google Ads / API Reference
google_ads_upload_customer_match
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Upload a customer match audience (email/phone list) to Google Ads. Emails and phones are hashed with SHA-256 before upload (Google requirement). Creates a new CRM-based user list or uploads to an existing one with the same name. Args: user_list_name: Name for the customer match audience (e.g. 'Newsletter Subscribers'). emails: List of plain-text email addresses. They will be normalized and hashed. phones: Optional list of phone numbers (E.164 format preferred, e.g. '+12025551234'). membership_days: How many days members stay in the list (default 30, max 540). customer_id: Google Ads customer ID. Leave blank to use default.
This is a write tool: it uploads customer match 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:
Upload customer match in my Google Ads account for [user list name], [emails].
It takes 2 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_list_name | string | Yes | User List Name |
emails | array | Yes | Emails |
phones | array | No | Phones |
membership_days | integer | No | Membership Days |
customer_id | string | No | Customer Id |
Related Google Ads tools
google_ads_upload_image_assetgoogle_ads_upload_offline_conversionsgoogle_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywords
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: