Meta Ads / API Reference
meta_ads_account_change_history
Meta Ads tool. Retrieve the full change history across the ENTIRE Meta Ads account in one call. The fastest way to audit what changed, who changed it, and when — across all campaigns, ad sets, and ads simultaneously. No need to know specific IDs in advance. Args: account_id: Ad account ID (e.g. act_123456 or just 123456). Leave blank to use the default account from env. start_date: Start date YYYY-MM-DD. Default: 7 days ago. end_date: End date YYYY-MM-DD. Default: today. object_type: Optional filter — CAMPAIGN, ADSET, or AD. Leave blank to return ALL object types. limit: Max number of changes to return (default 500, max 2000). Returns JSON with: - period: date range queried - total_changes: total count - by_user: summary of changes per user (name → count) - by_type: summary of changes per event type (Hebrew label → count) - changes: full list sorted newest-first, each entry has: date, user, action, event_type, from, to, object_name, object_id
This is a read-only tool: it returns account change history 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:
Account change history in my Meta Ads account.
It takes 0 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | No | Account Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
object_type | string | No | Object Type |
limit | integer | No | Limit |
Related Meta Ads tools
meta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ab_test_resultsmeta_ads_admeta_ads_ad_accountmeta_ads_ad_account_users
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: