Update
Pinterest Ads joins, with a scope list validated against Pinterest's own spec
TL;DR
Pinterest Ads is a full platform here: reading and building campaigns, ad groups and ads, plus catalogs, boards, pins, audiences and organic analytics. Two design decisions are worth knowing, because both change what a plan can quietly do.
What shipped
- 26 reads, 32 writes. Campaigns, ad groups, ads, keywords, audiences, catalogs, boards, pins, conversion tags and both the sync and async report paths.
- Micro-currency values carry a major-unit twin. Pinterest returns
*_in_micro_currency; every one of those gets an*_in_account_currencysibling in major units, so a figure is read correctly whichever field somebody reaches for. - A daily-to-lifetime budget flip is refused unless it is confirmed. The two are not interchangeable and the difference does not look like much in an argument list — so it is a person's decision, not an inference.
- Creating a public pin is fenced to a person on every lane, because publishing to a board is publishing.
Scopes are validated against the nineteen the Pinterest v5 spec defines, so a typo in an operator's override is dropped and named rather than sent to an authorize page that would fail with something unhelpful.
The quota that shapes how it is used
Pinterest's Trial tier allows 1,000 API calls a day for the whole app — not per account. That is a real constraint rather than a footnote, and it is why broad exploratory questions are worth scoping before running them across many accounts.
Frequently asked questions
- Can the agent change a Pinterest budget from daily to lifetime?
- Only with an explicit confirmation. The two budget types are not interchangeable and the difference is easy to miss in an argument list, so the flip is refused unless it is confirmed rather than inferred.
- Will it publish a Pin?
- Creating a public pin is person-class on every lane. Publishing to a board is publishing, so it is proposed and waits rather than happening in a run.
- Are Pinterest amounts in micro-currency?
- Pinterest returns micro-currency fields, and every one of them gets a major-unit twin named *_in_account_currency, so the figure is right whichever field is read.
- How many Pinterest API calls are available?
- The Trial tier is 1,000 calls a day for the whole app rather than per account, which is worth scoping broad questions around.