Changes
Publishing launches to their ad platform and controlling what is live.
Change history
The change history of one platform (platform, default meta; the same as GET /meta/changes for Meta). Other platforms' changes come from Pluto (source: pluto) or were found on the platform (source: platform, who.kind: platform), carry the platform's own IDs (object.id) and keep their values only as long as the platform's terms allow (valuesRemoved). For Meta: every change to the workspace's Meta campaigns, ad sets, ads and ad account spending limits, newest first, whoever made it: a person, the Agent, a loop, an API key or an MCP client in Pluto (source: pluto), a person in Ads Manager or Meta's apps (meta_ui), another app (other_app) or Meta itself (meta_system: review, learning, delivery). Each change has its old and new value (money as a decimal string and as integer minor units, with its currency) and who made it (who). Name one scope: objectId (a Meta ID; act_… for the account), adId, adSetId, launchId, campaignId or adAccountId; without one, every ad account over the last 30 days. fresh=true reads Meta's newest activity for one object or account first. Keyset-paged: pass nextAfter as after.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
platform | string | Optional | A platform from GET /platforms (default meta). |
objectId | string | Optional | A campaign, ad set or ad by Meta ID, or the ad account (act_…). |
adId | string | Optional | A Pluto ad (its Meta ad). |
adSetId | string | Optional | A Pluto ad set (its Meta ad set). |
launchId | string | Optional | A launch: its campaign and everything in it. |
campaignId | string | Optional | A campaign by Meta ID, with its ad sets and ads. |
adAccountId | string | Optional | Everything in one ad account. |
who | string | Optional | Comma-separated: person, agent, loop, mcp, api_key, pluto, meta_user, meta_app, meta. |
source | string | Optional | Comma-separated: pluto, meta_ui, other_app, meta_system. |
field | string | Optional | Comma-separated: budget, status, bid, targeting, creative, ... |
since | string | Optional | From this time on (RFC 3339). |
until | string | Optional | Before this time (RFC 3339). |
fresh | string | Optional | true: read Meta's newest activity for the object or account first. |
after | string | Optional | Cursor: nextAfter from the previous page. |
limit | string | Optional | Page size (1-200, default 50). |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
items- Changes, newest first.
items[].at- When it happened.
items[].currency- The amounts' currency.
items[].decision- What led to a Pluto change: the chat and model, or the loop's version, step and reason.
items[].description- Meta's words for it.
items[].eventType- Meta's event type, or what Pluto sent.
items[].field- What changed.One of
budget,spend_cap,account_spend_cap,status,delivery,bid,bid_strategy,targeting,creative,name,schedule,optimization,created,review,learning,labels,billing,other items[].from- The old value (money as a decimal string).
items[].fromMinor- The old amount in the currency's minor units (an integer).
items[].id- The change's ID.
items[].level- What it changed.One of
account,campaign,ad_set,ad items[].metrics- The object's metrics over the 7 days before a Pluto change.
items[].objectitems[].object.adAccountId- The ad account (
act_…). items[].object.adSetId- Its ad set's Meta ID.
items[].object.campaignId- Its campaign's Meta ID.
items[].object.entityId- Its ad or ad set in Pluto, if Pluto published it.
items[].object.id- The object's ID on its platform (platforms other than Meta).
items[].object.launchId- The launch that published it, if Pluto did.
items[].object.metaId- The Meta ID (Meta's history).
items[].object.name- Its name.
items[].perioddailyorlifetimefor budgets.items[].platform- The platform, on histories of platforms other than Meta.
items[].source- Where it came from (
platform: found on a platform other than Meta, in its own tool, another app or the platform itself).One ofpluto,meta_ui,other_app,meta_system,platform items[].to- The new value (money as a decimal string).
items[].toMinor- The new amount in the currency's minor units (an integer).
items[].valueKind- How to read
fromandto.creative: a live ad's creative content as JSON text (text,headline,description,cta,url,media, and for a carouselcards[{media,headline,description,url}] withbestCardsFirstandendCard, andurlTags);fromis null when the content before wasn't recorded.One ofmoney,status,text,json,creative,none items[].valuesRemoved- The platform's terms limit how long its values are kept:
from,toand the name were removed after that. items[].whoitems[].who.application- The app Meta says it came through.
items[].who.applicationId- That app's Meta ID.
items[].who.approvalId- The approval that let it run.
items[].who.id- A Pluto person, agent, key or loop ID, or Meta's user ID.
items[].who.kind- Who made it.One of
person,agent,loop,mcp,api_key,pluto,meta_user,meta_app,meta,platform items[].who.loopId- The loop.
items[].who.metaActorName- Who Meta says made it.
items[].who.name- Their name.
items[].who.onBehalfOf- The person a Pluto change was made for.
items[].who.origin- Where a Pluto change came from (app, api_key, mcp, agent_chat, loop).
items[].who.originId- The Agent chat or loop run.
items[].withheld- The platform's terms keep what is read from it inside Pluto's own app:
from,to, the description and the name of a change found on the platform are left out here. nextAfter- Pass as
afterfor the next page; null on the last. readAt- When the ad account's activity log was last read in full (one account asked).
curl "$PLUTO_API/changes" \
-H "Authorization: Bearer $PLUTO_KEY"