API Reference

Meta Ads / API Reference

meta_ads_update_adset_targeting

Meta Ads tool. Update targeting, scheduling, and delivery settings for an existing ad set. All parameters are optional — only provided fields are updated, and that holds inside the targeting spec too. Meta's `targeting` field is replace-not-merge, so this reads the ad set's current targeting and lays the supplied keys over it; anything not mentioned is preserved. Supplying a top-level key replaces that key outright, so narrowing still works (passing geo_locations with fewer cities does remove the others). Args: adset_id: The ad set ID to update (required). targeting: JSON targeting spec, merged over the current one. Only the top-level keys you pass are changed. Example: '{"geo_locations":{"countries":["IL"]}}' frequency_control_specs: JSON array to cap frequency. Example: '[{"event":"IMPRESSIONS","interval_days":7,"max_frequency":3}]' attribution_spec: JSON array for attribution windows. Example: '[{"event_type":"CLICK_THROUGH","window_days":7}]' pacing_type: standard or no_pacing (for dayparting use day_parting). destination_type: WEBSITE, MESSENGER, WHATSAPP, INSTAGRAM_DIRECT, ON_AD. adset_schedule: JSON dayparting schedule (requires lifetime_budget on the adset). Example: '[{"start_minute":480,"end_minute":1200,"days":[1,2,3,4,5],"timezone_type":"USER"}]' daily_min_spend_target: Soft spend floor in cents for CBO campaigns. daily_spend_cap: Hard spend ceiling in cents for CBO campaigns. advantage_audience: True enables Advantage+ AI audience automation, False disables it. Leave unset to keep the ad set's current setting — passing False on an unrelated edit would turn it off. status: ACTIVE, PAUSED, DELETED, or ARCHIVED. name: New name for the ad set.

This is a write tool: it updates adset targeting 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:

Update adset targeting in my Meta Ads account for [adset id].

It takes 1 required and 11 optional parameters.

Parameters

ParameterTypeRequiredDescription
adset_idstringYesAdset Id
targetingstringNoTargeting
frequency_control_specsstringNoFrequency Control Specs
attribution_specstringNoAttribution Spec
pacing_typestringNoPacing Type
destination_typestringNoDestination Type
adset_schedulestringNoAdset Schedule
daily_min_spend_targetstringNoDaily Min Spend Target
daily_spend_capstringNoDaily Spend Cap
advantage_audienceanyNoAdvantage Audience
statusstringNoStatus
namestringNoName

Related Meta Ads tools

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:

Start free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.