List the change history of a plan's campaigns
media_planner.changes.list
Lists the change history of a media plan's rows, newest first, paginated by cursor: who changed what and when, field by field with the value before and after (budget, status, dates, platform, currency, labels, link, Auto-Budget, carryover), plus creations, deletions and imports. source says where it came from (user, ai, autobudget, carryover, system). Pass campaign_id for the history of one row (it survives the row's deletion). Reordering and the daily cost sync are not history. Requires view access to the Media Planner. With Google Ads, LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).
- Alcance
media_planner:read- Permiso
- Ver el módulo
- Tool del MCP
media_planner_changes_listEn la superficie completa; en la compacta,mb_execute_operationconid: "media_planner.changes.list".
Costo declarado: hasta 203 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
Parámetros
plan_idstringrutaMedia plan id (from media_planner.plans.list).
limitintegerqueryopcionalHow many items this page brings at most (see the maximum and the default in the schema).
Por defecto: 50
cursorstringqueryopcionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
campaign_idstringqueryopcionalOnly the history of this row (it survives the row's deletion).
Respuesta
dataarray<object>has_morebooleannext_cursorstringErrores
Ejemplo
curl "https://api.mb-suite.com/v1/media-planner/plans/{plan_id}/changes" \
-H "Authorization: Bearer $MB_API_KEY"Probar con tu API key de prueba
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.
curl "https://api.mb-suite.com/v1/media-planner/plans/{plan_id}/changes" \
-H "Authorization: Bearer $MB_TEST_KEY"