reddit_ads_get_activities

Get Reddit Ads Change History

Reddit

Description

What changed in a Reddit ad account, and when: status, budgets, bids, targeting, schedules, names and creative links of campaigns, ad groups, ads and audiences, with before/after values and who made the change.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reddit_ads_get_activities",
    "arguments": {}
  }
}

Parameters

NameTypeRequiredDescription
account_id string Required Reddit ad account ID (e.g. a2_abc123 or t2_abc123).minLength: 1, maxLength: 64
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (8)
NameTypeRequiredDescription
start_date string Optional Start of the window, YYYY-MM-DD (UTC). Defaults to 7 days ago.pattern: ^\d{4}-\d{2}-\d{2}$
end_date string Optional End of the window, YYYY-MM-DD (UTC), inclusive. Defaults to today.pattern: ^\d{4}-\d{2}-\d{2}$
entity_type string Optional Only changes to this kind of entity.
AD_ACCOUNT CAMPAIGN AD_GROUP AD AUDIENCE
entity_ids array Optional Only changes to these campaign / ad group / ad / audience IDs.
limit integer Optional Changes per page (1-200, default 50).min: 1, max: 200
cursor string Optional nextCursor from the previous response. Pass it with otherwise identical parameters for the next page.
refresh boolean Optional Fetch the latest changes from Reddit now before answering. Normally not needed: the account is re-synced when the last sync is over 15 minutes old.
connection_id string Optional Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.