Get Meta Ad Set Activity Log

Retrieve the change history (activity log) for a specific Meta ad set.

Returns updates to the ad set including status changes, budget updates, targeting changes, and more. By default returns one week of data.

Args:

• adset_id (string): Ad set ID, e.g., '23843211234567'

• 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: "What changes were made to ad set 23843211234567 this month?"

• Use when: "Show me the targeting change history for this ad set"