Get Meta Ad Account Activity Log

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?"