Meta Ads / API Reference
meta_ads_adset_matrix_builder
Meta Ads tool. Create one ad set + one ad per entry in a structured adsets list (matrix / multi-audience structure). Every adset and ad is created as PAUSED. All ads share the same creative. Set dry_run=True first to preview the full plan before creating anything. Args: campaign_id: Campaign ID to create ad sets under (required). creative_id: Ad creative ID to use for all ads (required). adsets: JSON array of ad set definitions (required). Each entry: name – ad set name (required) targeting – full targeting JSON string (required) daily_budget – optional per-adset budget override (agoras/cents) frequency_cap – optional int: max impressions per user per 7 days Example: '[{"name":"Ages 25-34 IL","targeting":"{"age_min":25,"age_max":34,"geo_locations":{"countries":["IL"]}}","daily_budget":8000}, {"name":"Retargeting Website","targeting":"{"custom_audiences":[{"id":"123"}]}","frequency_cap":3}]' daily_budget_per_adset: Default daily budget in smallest currency unit (e.g. 5000 = ₪50). Per-adset daily_budget overrides this. optimization_goal: Optimization goal. Default OFFSITE_CONVERSIONS. billing_event: Billing event. Default IMPRESSIONS. ad_name_prefix: Prefix for ad names. Default 'Ad'. account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env. dry_run: If True, return the full creation plan WITHOUT executing. Use for confirmation.
This is a read-only tool: it returns adset matrix builder for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Adset matrix builder in my Meta Ads account for [campaign id], [creative id], [adsets].
It takes 3 required and 6 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign Id |
creative_id | string | Yes | Creative Id |
adsets | string | Yes | Adsets |
daily_budget_per_adset | integer | No | Daily Budget Per Adset |
optimization_goal | string | No | Optimization Goal |
billing_event | string | No | Billing Event |
ad_name_prefix | string | No | Ad Name Prefix |
account_id | string | No | Account Id |
dry_run | boolean | No | Dry Run |
Related Meta Ads tools
meta_ads_adset_change_historymeta_ads_adset_performancemeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limit
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: