Inputs
Output
Type:List[Dict]
Returns a list of raw audit-log records, including resource and actor IDs, timestamps, and before/after changes, up to the requested limit.
Fields: dynamic (depend on the inputs)Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retrieve OpenAI Ads account change history, including changed resources, actors, timestamps, and before/after details
| App | OpenAI Ads |
| Operation ID | openai_ads_get_account_history |
| Type | Action |
| Connection | openai_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
time_range | enum (last_30_days, last_14_days, last_7_days, today, yesterday) | No | last_30_days | UTC date preset. Defaults to last_30_days, including today. today/yesterday use UTC calendar-day boundaries. |
campaign_id | string | No | - | Include changes to this campaign and its ad groups and ads. |
ad_group_id | string | No | - | Include changes to this ad group and its ads. |
ad_id | string | No | - | Include changes to this ad. |
actor_id | string | No | - | Include changes made by this actor, not changes affecting the actor. Resource/actor filters are combined with AND. |
order | enum (asc, desc) | No | - | Chronological order: desc (default, newest first) or asc. |
limit | integer | No | 100 | Maximum audit records to return. Default 100; requests are paginated with up to 100 rows per API page. |
List[Dict]
Returns a list of raw audit-log records, including resource and actor IDs, timestamps, and before/after changes, up to the requested limit.
Fields: dynamic (depend on the inputs)