Get Meta Ad Set Activity Log
meta_ads_get_activities_by_adsetRetrieve change history for a specific Meta ad set, including budget updates, targeting changes, and status modifications, with details on who made each change and when.
Instructions
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"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adset_id | Yes | Ad set ID, e.g., '23843211234567' | |
| 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 |