Portfolio Events

Portfolio events are annotations tied to a portfolio that describe external factors (campaigns, promotions, market events, etc.) that may influence performance data. Events have a start/end date, a category, and an impact classification. You can find all information about how events work in the events documentation.

List portfolio events

The query uses cursor-based pagination. Omit $first and $after to fetch the most recent events, or supply them to page through a large event list.

Apollo Studio

query PortfolioEvents($teamId: Int!, $portfolioId: Int!, $first: Int, $after: String) {
  portfolioV2(teamId: $teamId, portfolioId: $portfolioId) {
    portfolioEvents(first: $first, after: $after) {
      edges {
        cursor
        node {
          portfolioEventId
          name
          description
          start
          end
          assetUrl
          category
          impact
          created
          includesAllContents
        }
      }
    }
  }
}

Variables

{
  "teamId": 123,
  "portfolioId": 456,
  "first": 50
}

Pagination

Pass the cursor value of the last edge as $after in the next request to fetch the next page.

Event fields

Field	Description
portfolioEventId	Unique identifier for the event
name	Short display name of the event
description	Optional longer description
start	Event start date/time
end	Event end date/time
assetUrl	Optional URL to a related asset (e.g. a creative)
category	Event category (e.g. CAMPAIGN, MARKET)
impact	Expected impact level (e.g. LOW, MEDIUM, HIGH)
created	Timestamp when the event was created
includesAllContents	Whether the event applies to all portfolio contents or only selected ones