Meta Ads / API Reference
meta_ads_async_batch
Meta Ads tool. Submit up to 1000 ad operations in a single async batch request. Much faster than calling tools in a loop for bulk creation. Meta processes operations in parallel and returns a request_set_id to poll for results. Args: account_id: Ad account ID (required). operations: JSON array of operations. Each operation needs 'method' (POST/DELETE), 'relative_url', and optionally 'body'. Example: '[{"method":"POST","relative_url":"act_123/campaigns", "body":"name=Test&objective=OUTCOME_SALES&special_ad_categories=[]&status=PAUSED"}]' notification_uri: Optional webhook URL to call when batch completes.
This is a read-only tool: it returns async batch 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:
Async batch in my Meta Ads account for [operations].
It takes 2 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account Id |
operations | string | Yes | Operations |
notification_uri | string | No | Notification Uri |
Related Meta Ads tools
meta_ads_async_batch_statusmeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
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: