Skip to content

Developer Platform

Search docs & API
/
Log in
Sign up

Changelog

Update reporting for objective simplification
If you filter reports by
campaign_objective_types
, update your API calls so
SALES
and
LEADS
campaigns appear.
  • Support
    SALES
    and
    LEADS
    as new campaign objectives.
  • Treat
    CATALOG_SALES
    and
    WEB_CONVERSION
    as legacy.
  • For
    CONSIDERATION
    and
    SALES
    , map creative source to
    intended_promotion_type
    using
    STANDARD_AD
    instead of
    CATALOG
    .
Migrate all ad campaigns to objective simplification by February 1, 2027.
Learn how to use objective simplification.
Update reporting for objective simplification
If you filter reports by
campaign_objective_types
, update your API calls so
SALES
and
LEADS
campaigns appear.
  • Support
    SALES
    and
    LEADS
    as new campaign objectives.
  • Treat
    CATALOG_SALES
    and
    WEB_CONVERSION
    as legacy.
  • For
    CONSIDERATION
    and
    SALES
    , map creative source to
    intended_promotion_type
    using
    STANDARD_AD
    instead of
    CATALOG
    .
Migrate all ad campaigns to objective simplification by February 1, 2027.
Learn how to use objective simplification.
Choose category filter

2026

October

Changelog entries

Media library asset management

ads

Background selection for product group promotions

ads

Expanded conversion reporting metrics

ads

September

Changelog entries

Objective simplification support in Media Planner

ads

Automatic UTM parameters for ads

ads

Pinner data access denial error

pins/boards

Agency owned ad accounts

ads

August

Changelog entries

Media networks for sharing assets with brands

ads

Developer terms and guidelines updated

docs/api reference

July

Changelog entries

Age bucket and gender targeting visibility in reports

analytics

June

Changelog entries

Objective simplification features in production

ads

Lower-funnel objectives for Media Planner

ads

Disclosing AI content in ads

ads

Dynamic CTAs

ads

Customer list improvements

ads

Dynamic product titles

shopping

May

Changelog entries

Expanded marketing mix modeling report

ads

April

Changelog entries

Collage ad capabilities

ads

Using Pinterest docs with AI tools

docs/api reference

Advertiser-defined events

conversion tracking

Reporting timezone GA for analytics endpoints

analytics

New customer acquisition

ads

Custom conversion events

ads

March

Changelog entries

Shareable ad preview links

ads

Item-level promotions and multiple ad group promotions

ads

Asynchronous upload jobs for large customer lists

ads

February

Changelog entries

Standardization of optional nullable fields

ads

Image auto-resizing in product group promotions

ads

Campaign spend estimation

ads

Improved descriptions for campaign endpoints

docs/api reference

Campaign objective type simplification initial phase

ads

Where-to-buy links in ads

ads

Scheduled campaign budget adjustments in bulk requests

ads

Documentation updates

docs/api reference

January

Changelog entries

Simplified management of Pinterest Performance+ entities

ads

Management of local store inventory in catalogs

shopping

Applying labels to campaigns

ads

Conversion events added for app use, trials, and more

conversion tracking

Removal of users from conversion data

conversion tracking

Premium placement in search results

ads

2025

December

Changelog entries

Medical disclosure links in ads

ads

November

Changelog entries

Minimum set for campaign daily budget increases

ads

Deprecation of user interests endpoint

analytics

October

Changelog entries

Event quality score

conversion tracking

Minimum and maximum ages for targeting

ads

Improved developer docs navigation

docs/api reference

Deprecation of custom audience endpoint

ads

Multiple images in ads and PGPs

ads
shopping

September

Changelog entries

Audience creation guide

docs/api reference

Increased record limit for certain endpoints

analytics

Deprecation of legacy refresh token

authentication

Event for app activation

conversion tracking

Deprecation of gtin integer support

shopping

Deprecation of Pin notes creation

pins/boards

August

Changelog entries

Demographic and prediction keyword data

analytics

July

Changelog entries

Sandbox guide for batch operations

docs/api reference

Deprecated glitch OAuth tutorial

docs/api reference

June

Changelog entries

Earlier data available in MMM reports

ads

Product tagging

pins/boards

Campaign labeling

ads

Ad credit spend in API reports

ads

Ad-only board creation

ads

Pinterest Performance+ name change

ads

Multiple creative asset catalog support

ads

May

Changelog entries

Permissions updates for business access

ads

Deprecation of video view objective

ads

Campaign and ad group budget columns added to reports

ads
analytics

Improved catalog batch guide

docs/api reference

April

Changelog entries

Parameter for creating ad-only Pins

ads

Improved business access guide

docs/api reference

GEO or LOCATION value required for targeting

ads

Campaign bid multipliers

ads

Improved conversion tracking guide

docs/api reference

Conversion events added

ads

March

Changelog entries

Changes to conversion reporting metrics

ads
analytics

Image proxy guide

docs/api reference

Columns for paid outbound clicks and impressions

ads
analytics

Schema update for product group promotion

ads

Changelog restructured with categories

docs/api reference

February

Changelog entries

Ad scheduling for CBO campaign ad groups

ads

Ramp-up for deprecating legacy refresh token

authentication

Bid multiplier for ad groups

ads

January

Changelog entries

Impression metrics for video Pin information

pins/boards

More consistent Pin and board metrics

pins/boards

DE IA NE NH added for Limited Data Processing

conversion tracking

2024

December

Changelog entries

Third-Party Measurement conversion events

conversion tracking

November

Changelog entries

Developer docs search

docs/api reference

Promotions functionality

ads

API Explorer enhancements

docs/api reference

October

Changelog entries

Pinterest Performance+ Creative background generation

ads

PROMO added in v5

ads
analytics

Pinterest Performance+ endpoints

ads

Pinterest Performance+ Creative Optimizations

ads

Pinterest Performance+ ROAS Bidding optimization

ads

September

Changelog entries

Client Credentials authorization grant

authentication

GA lead ads subscription endpoints

ads

Token Debugger

dev tools

August

Changelog entries

Premiere spotlight metric for analytics

ads
analytics

July

Changelog entries

Shopping catalog diagnostics

shopping

API Explorer for trying out endpoints

dev tools

Improved scaling for shopping

shopping

Asset group management

business access

TX OR added for Limited Data Processing

conversion tracking

May

Changelog entries

Targeting analytics for quiz ads

ads

Item-level bidding

ads

Video completion objective

ads

Lead ads management

ads

Audience sharing endpoints

ads
targeting

Sorting parameter for ad account analytics

ads
analytics

April

Changelog entries

GET catalog items deprecated

shopping

More scopes required for catalog items

shopping

Business access management endpoints

business access

Use case organization for API reference

docs/api reference

Enablement of targeting templates

ads
targeting

March

Changelog entries

Ads grid click type change to read-only

ads

Parameter change for ad creation and update

ads

Change of REST method for audience sizing

ads

Multiple Pin analytics

pins/boards

Keyword filtering

ads
targeting

February

Changelog entries

Shopping API endpoints in Sandbox

shopping
Was this page helpful?

October 15, 2026

You can manage your business' assets in the media library programmatically. List and inspect the assets you uploaded, rename and retag them, and delete the ones you no longer need.
Media library assets are reusable image and video creatives that belong to your business. They are not Pins. A Pin is published content saved to a board, while an asset is business-scoped source creative that you reuse across your Pins and ads.

Added endpoints

POST
Create asset(s)
PATCH
Edit asset(s)
GET
Get all assets
GET
Get an asset
DELETE
Remove asset(s)
Learn how to use this feature.

October 8, 2026

You can choose what kind of backgrounds appear on your product images, so catalog ads stay on brand while still inspiring shoppers and driving engagement.
We added support for selecting background styles allowed on a product group promotion when background generation is enabled.

Affected endpoints

POST
Create product group promotions
PATCH
Update product group promotions

Added parameter

generated_background_styles
: The type of background to appear with product images when
is_generate_background
is set to
true
:
  • Select
    BASIC
    for solid or gradient backgrounds.
  • Select
    LIFESTYLE
    and
    BASIC
    together for AI-generated lifestyle images. Do not select
    LIFESTYLE
    alone.

October 1, 2026

You can measure additional new standard events—including adding payment information, adding products to a wishlist, initiating checkout, subscribing, and viewing content—through synchronous and asynchronous reporting APIs. This gives you more complete attribution, value, ROAS, CPA, and conversion-rate reporting for commerce and subscription campaigns.
We added metrics for five additional conversion event types. Select the new values through each endpoint's existing columns parameter.

Affected endpoints

Asynchronous reporting:
POST
Create async request for an account analytics report
Synchronous reporting:
GET
Get ad account analytics
GET
Get ad group analytics
GET
Get ad analytics
GET
Get campaign analytics
GET
Get pins analytics
GET
Get product group analytics
GET
Get targeting analytics for an ad account
GET
Get targeting analytics for ad groups
GET
Get targeting analytics for ads
GET
Get targeting analytics for campaigns

Added column families

A column family is a set of related metrics for the same conversion event, such as total conversions, attributed conversions, conversion value, CPA, ROAS, and conversion rate. New column families are available for:
  • Add payment information (
    TOTAL_ADD_PAYMENT_INFO
    ,
    TOTAL_CLICK_ADD_PAYMENT_INFO
    ,
    WEB_ADD_PAYMENT_INFO_ROAS
    )
  • Add to wishlist (
    TOTAL_CLICK_ADD_TO_WISHLIST
    ,
    TOTAL_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
    )
  • Initiate checkout (
    TOTAL_INITIATE_CHECKOUT
    ,
    TOTAL_INITIATE_CHECKOUT_CONVERSION_RATE
    )
  • Subscribe (
    TOTAL_SUBSCRIBE
    ,
    WEB_SUBSCRIBE_COST_PER_ACTION
    )
  • View content (
    TOTAL_VIEW_CONTENT
    ,
    TOTAL_VIEW_CONTENT_CONVERSION_RATE
    )
Depending on the reporting endpoint, each family may include:
  • Total conversions
  • Click-, engagement-, and view-attributed conversions
  • Conversion value and quantity
  • Conversion rate
  • Cost per action
  • ROAS
  • Web, in-app, and offline attribution breakdowns
The exact metrics available vary by endpoint. Asynchronous reports provide the broadest set of value, quantity, CPA, ROAS, and attribution breakdowns, while synchronous endpoints support a smaller subset. See the linked API reference pages for each endpoint's complete list.
Pass the desired values through the
columns
parameter.
Learn more about ads reporting.