Meta Ads / API Reference
meta_ads_upload_customer_list_to_audience
Meta Ads tool. Upload hashed customer data (email/phone) to an existing Meta Custom Audience. Emails and phone numbers are automatically SHA-256 hashed before sending. Args: audience_id: Custom audience ID to upload to (required). users: JSON array of user objects. Each object may include: email, phone, first_name, last_name. Example: '[{"email":"user@example.com","phone":"+972501234567"}]' (required). operation: ADD to add users, REMOVE to remove them. Default ADD. account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env.
This is a write tool: it uploads customer list to audience in your Meta 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 list to audience in my Meta Ads account for [audience id], [users].
It takes 2 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
audience_id | string | Yes | Audience Id |
users | string | Yes | Users |
operation | string | No | Operation |
account_id | string | No | Account Id |
Related Meta Ads tools
meta_ads_upload_ad_videometa_ads_upload_enhanced_conversionsmeta_ads_upload_image_file_bytes_to_metameta_ads_upload_image_to_metameta_ads_upload_product_feedmeta_ads_upload_video_file_bytes_to_meta
Before you can call it
This tool needs a connected Meta Ads account. The Meta 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: