Nexoya API

Appearance

May 15, 2026 ​

Added ​

  • MCP integration guide — Nexoya now exposes a Model Context Protocol (MCP) server. Connect it to Claude or any other MCP-compatible AI client to query your portfolios, performance data, and optimizations directly in chat. See the MCP guide.

  • Portfolio contents query — New example showing how to fetch the marketing campaigns and ad sets inside a portfolio, including the connected provider (channel) for each content item. See Get portfolio contents.

  • Portfolio labels query — New example for fetching the labels defined on a portfolio, used to categorize and group contents. See Get portfolio labels.

  • Portfolio funnel steps query — Standalone example for fetching only the funnel steps of a portfolio without retrieving the full portfolio object. See Get portfolio funnel steps.

  • Portfolio Optimization query — New example for activeOptimization, which returns the current budget proposal with baseline vs. predicted metrics per funnel step. See Portfolio Optimization.

  • Portfolio Events query — New example for portfolioEvents, the cursor-paginated list of performance annotations (promotions, market events, etc.) attached to a portfolio. See Portfolio Events.

  • Daily metrics: all funnel steps variant — New example in Portfolio Performance showing how to fetch time-series daily data for all funnel steps in a single request, without needing a specific funnelStepId.

  • Tutorial: Reading an optimization proposal — New step-by-step tutorial explaining how to fetch the active optimization, map the funnelSteps array to portfolio funnel steps by index, and interpret baseline vs. predicted metrics. See Reading an optimization proposal.

Updated ​

  • Portfolio list query — Updated to use the portfolios query with cursor-based pagination (edges / node / pageInfo), replacing the previous portfoliosV2 flat-list example. See Portfolio List.

  • User query — Updated example to include firstname, lastname, and the additional team fields logo, currency, and number_format. See User.