POST /v3/activity/query/adgroup → AdGroup.activityLogs

Overview

Here's what you need to know:

• Primary GraphQL entry point is the parent relationship field AdGroup.activityLogs

  • REST POST /v3/activity/query/adgroup is scoped by AdGroupId—the caller already holds the ad group ID.
  • Reach activity logs through adGroup(id: ...) { activityLogs { ... } }.
  • When the client has only an entity ID string and no AdGroup node in context, use the alternate root field Query.activityLogs(entityType: AD_GROUP, entityId:) with the same where, first, and after arguments.

• The mode argument on GraphQL activityLogs (ActivityLogScopeModeInput, optional)

  • Defaults to INCLUDE_RELATED: results include activity logs for the queried ad group and for related entities (for example, changes on entities tied to that ad group).
  • REST scopes results to the single ad group only.
  • To match REST's entity-only scope, pass mode: SELECTED_ENTITY_ONLY.
  • The other enum member is INCLUDE_RELATED (the default).

Request and filter field mapping

Response field mapping

Endpoint-specific nested types and enums

ActivityLogAffectedEntity

Select affectedEntities { type entityId node { ... } } on each ActivityLog node.

BidLineActivity → BidListChangeDetails

When category is BID_LIST, select details { ... on BidListChangeDetails { bidList changeCount dimensionName } }.

Code examples

REST example

POST /v3/activity/query/adgroup HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

{
  "AdGroupId": "abc123",
  "DateTimeStartUtc": "2026-01-01T00:00:00Z",
  "DateTimeEndUtc": "2026-07-28T23:59:59Z",
  "PageSize": 100,
  "PageStartIndex": 0,
  "UpdatedBy": "jane.doe@example.com"
}

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query AdGroupActivityLogs {
  adGroup(id: "abc123") {
    activityLogs(
      first: 100
      where: {
        occurredAt: {
          gte: "2026-01-01T00:00:00Z"
          lte: "2026-07-28T23:59:59Z"
        }
        actor: { in: ["jane.doe@example.com"] }
        categoryAndDetail: {
          in: [{ category: BID_LIST }]
        }
      }
    ) {
      nodes {
        id
        occurredAt
        actor
        message
        category
        affectedEntities {
          type
          entityId
        }
        details {
          ... on BidListChangeDetails {
            changeCount
            dimensionName
            bidList {
              id
            }
          }
        }
      }
      totalCount
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

query ActivityLogsByAdGroupId {
  activityLogs(
    entityType: AD_GROUP
    entityId: "abc123"
    first: 100
    where: {
      occurredAt: { gte: "2026-01-01T00:00:00Z" }
    }
  ) {
    nodes {
      id
      occurredAt
      actor
      category
      message
    }
    totalCount
  }
}