Meta Ads / API Reference
meta_ads_ad_change_history
Meta Ads tool. Retrieve the full change history of a specific Meta Ads ad (creative level). Shows who changed what and when — creative, status, tracking, bids, and more. Uses the account-level /activities endpoint filtered by ad ID and object_type=AD. Args: ad_id: The ad ID to inspect (required). 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: 30 days ago. end_date: End date YYYY-MM-DD. Default: today. Returns JSON with ad_name and changes list sorted newest-first. Each change: date, user, action, event_type, from, to, object_name, object_id.
This is a read-only tool: it returns ad 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:
Ad change history in my Meta Ads account for [ad id].
It takes 1 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_id | string | Yes | Ad Id |
account_id | string | No | Account Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
Related Meta Ads tools
meta_ads_admeta_ads_ad_accountmeta_ads_ad_account_usersmeta_ads_ad_creativemeta_ads_ad_creativesmeta_ads_ad_performance
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: