Pinterest API deprecates creating Pin notes

AnnouncedSept 2025

EffectiveNot stated

PlatformPinterest

What changed

Pinterest's changelog lists Deprecation of Pin notes creation under pins and boards in September 2025. Pinterest's public OpenAPI spec matches it: the optional note field (Private note for this Pin) is in the Pin, PinCreate and PinUpdate schemas in v5.18.0 and gone from all three in v5.20.0, published October 16, 2025. The changelog entry text was not readable, so the exact switch-off day and what happens to a request that still sends note are not stated.

What it means

Apps can no longer count on setting a private note when they create or update a Pin: the note field is gone from the Pin create, update and response schemas in the API spec.

Who is affected

Scheduling and publishing tools that send a note with pins/create or pins/update, and tools that read the note back from Pins.

What to do

Stop sending note on pins/create and pins/update, and don't depend on a note value coming back. Move any internal reminders you stored in Pin notes into your own app.

What this means for you

On Pinterest you could add a private note to a Pin, a reminder only you can see. Apps that create Pins for you used to be able to fill in that note too. Pinterest has switched that off for apps. If your scheduling app had a box for Pin notes, it may disappear or stop saving anything. Your Pins still publish as before.

The details

Changelog: "Deprecation of Pin notes creation", category pins/boards, September 2025. The entry's text loads only by JavaScript, so it was not read.
Spec before: in OpenAPI v5.18.0 (August 14, 2025), Pin, PinCreate and PinUpdate each have an optional, nullable note string described as "Private note for this Pin."
Spec after: in v5.20.0 (October 16, 2025) the note property is gone from all three schemas, and it is still absent in v5.28.0 (June 4, 2026).
Endpoints affected: POST /v5/pins (pins/create) and PATCH /v5/pins/{pin_id} (pins/update) for writing; Pin read endpoints such as pins/get for reading.
Not confirmed: whether a request that still sends note is rejected or the field is silently ignored, and whether notes already on a Pin are still returned. The "Create boards and Pins" guide's ad-only Pin response example still shows "note": "".

What to do next

Business owners: Nothing. Keep private reminders somewhere other than Pin notes.
Marketers and agencies: If your workflow relied on notes added by a scheduler, ask the vendor where those notes go now.
Developers: Remove note from pins/create and pins/update payloads, drop it from your Pin models and test that your create calls still succeed.

Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.