Meta Ads / API Reference
meta_ads_bulk_updater
Meta Ads tool. Bulk-apply an action to multiple Meta campaigns, ad sets, or ads with rate-limit protection. Supports status changes, budget updates, targeting updates, and duplication. Set dry_run=True first to preview operations before executing — use this for confirmation: call with dry_run=True, show the plan to the user, then call again with dry_run=False only after confirmation. Args: object_ids: Comma-separated list of IDs, e.g. "123,456,789" (required). object_type: campaign, adset, or ad (required). action: One of: pause, activate, update_budget, update_targeting, duplicate (required). params: JSON string with action-specific overrides. pause/activate → not needed update_budget → {"daily_budget": "5000"} or {"lifetime_budget": "50000"} update_targeting → any field accepted by meta_ads_update_adset_targeting, e.g. '{"targeting":"{...}","advantage_audience":true}' duplicate → {"status_override":"PAUSED","deep_copy":true} delay_ms: Milliseconds between API calls. Default 300. dry_run: If True, return the list of planned operations WITHOUT executing them. Always call with dry_run=True first, confirm with user, then run for real.
This is a read-only tool: it returns bulk updater 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:
Bulk updater in my Meta Ads account for [object ids], [object type], [action].
It takes 3 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
object_ids | string | Yes | Object Ids |
object_type | string | Yes | Object Type |
action | string | Yes | Action |
params | string | No | Params |
delay_ms | integer | No | Delay Ms |
dry_run | boolean | No | Dry Run |
Related Meta Ads tools
meta_ads_bulk_create_instagram_postmeta_ads_bulk_create_page_postmeta_ads_bulk_payment_checkmeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnostics
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: