Get Meta Ad Account Activity Log
meta_ads_get_activities_by_adaccountRetrieve the change history for a Meta ad account to see who made changes, what was changed, and when. Filter by date range or specific fields.
Instructions
Retrieve the change history (activity log) for a Meta ad account.
Returns key updates to the account and associated ad objects, including status changes, budget updates, targeting changes, and more. By default returns one week of data.
Args:
act_id (string): Ad account ID prefixed with 'act_', e.g., 'act_1234567890'
fields (string[]): Fields to retrieve. Available: actor_id, actor_name, application_id, application_name, changed_data, date_time_in_timezone, event_time, event_type, extra_data, object_id, object_name, object_type, translated_event_type
limit (number): Maximum activities per page
after / before (string): Pagination cursors
time_range (object): Custom range {'since':'YYYY-MM-DD','until':'YYYY-MM-DD'}. Overrides since/until
since (string): Start date in YYYY-MM-DD format (ignored if time_range is set)
until (string): End date in YYYY-MM-DD format (ignored if time_range is set)
Returns: Object with data (activity array) and paging. Each activity record contains who made the change, what was changed, when, and the specific details.
actor_name (string): Name of the user who made the change
object_type (string): Type of object: AD, ADSET, CAMPAIGN, ACCOUNT, IMAGE, REPORT, etc.
translated_event_type (string): Human-readable description, e.g., 'ad created', 'campaign budget updated'
event_time (string): Timestamp of the event
changed_data (string): JSON detailing what changed
Use meta_ads_fetch_pagination_url with paging.next to retrieve additional pages.
Examples:
Use when: "Show me all changes made to my ad account in the last week"
Use when: "Who changed the budget on this account in January 2024?"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| act_id | Yes | Ad account ID prefixed with 'act_', e.g., 'act_1234567890' | |
| fields | No | Fields to retrieve. Available: actor_id, actor_name, application_id, application_name, changed_data, date_time_in_timezone, event_time, event_type, extra_data, object_id, object_name, object_type, translated_event_type | |
| time_range | No | Custom time range {'since':'YYYY-MM-DD','until':'YYYY-MM-DD'}. Overrides since/until | |
| since | No | Start date in YYYY-MM-DD format. Ignored if time_range is set | |
| until | No | End date in YYYY-MM-DD format. Ignored if time_range is set | |
| limit | No | Maximum number of results to return per page (1-100, default: 25) | |
| after | No | Cursor for the next page of results, from response.paging.cursors.after | |
| before | No | Cursor for the previous page of results, from response.paging.cursors.before | |
| offset | No | Alternative pagination: number of results to skip |