Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Changelog

Choose category filter

2026

June

Changelog entries

Objective simplification features going into production

ads

Disclosing AI content in ads

ads

Dynamic CTAs

ads

Customer list improvements

ads

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?
Coming June 15, 2026
What is objective simplification?
Starting June 15 in production, we are making it easier for you to buy ads based on business goals, whether you want to drive traffic, signups or sales.
We replaced
WEB_CONVERSION
and
CATALOG_SALES
objectives (“legacy objectives”) with new ones:
LEADS
and
SALES
.
  • Use
    LEADS
    to drive non-transactional conversion events such as
    signup
    and
    lead
    .
  • Use
    SALES
    to drive transactional conversion events such as
    add_to_cart
    and
    checkout
    .
  • Use catalogs in either
    CONSIDERATION
    or
    SALES
    objectives.
You can migrate
CATALOG_SALES
campaigns that optimize for clicks to the
CONSIDERATION
objective.
You can migrate
CATALOG_SALES
campaigns that optimize for clicks to the
CONSIDERATION
objective.
Affected endpoints:
POST
Create campaigns
PATCH
Update campaigns
To signal your use of this objective type simplification, use the
intended_promotion_type
parameter (also going into production on June 15), which allows you to create ads derived from either Pins or Product Group Promotions under the
SALES
and
CONSIDERATION
objectives.
What do I need to do?
Step 1. Before June 15, 2026, follow these instructions to test these features in Sandbox.
Step 2. Update how you ingest the Pinterest API to include new campaign objectives before February 1, 2027.
Learn how to transition to objective simplification.

June 9, 2026

You can declare AI-generated content in your ad creatives, including whether a synthetic performer (AI-generated person) is featured, enabling Pinterest to display the appropriate GenAI disclosure label to users. This capability helps you meet emerging legal requirements, such as New York State's synthetic performer disclosure law.
Affected endpoints:
  • POST
    Create Pin
  • PATCH
    Update Pin
  • GET
    List Pins
  • GET
    Get Pin
We added the following parameters:
  • ai_disclosures
    : Optional object that contains declarations of AI-generated or AI-modified content in your ad creative. If omitted, Pinterest may still display a May be AI-modified label based on our own detection models.
  • values
    : Array of strings listing AI declarations. Required with the
    ai_disclosures object
    . Includes any of the following enums:
    • SYNTHETIC_PERFORMER
      : Indicates that the main subject of the creative is an AI-generated person. For Pinterest users in New York, this triggers an AI-generated person label; elsewhere it triggers an AI-modified label.
    • AI_MODIFIED
      : Indicates that the creative has been modified with AI. Generates an AI-modified label for all users.
Example:
"ai_disclosures": {
 "values": ["SYNTHETIC_PERFORMER"]
}

June 8, 2026

You can enable dynamic call-to-action (CTA) selection for your ads, allowing Pinterest's rules-based model to automatically serve the most effective CTA based on context, such as placement and device type, to improve click volume and post-click engagement.
Affected endpoints:
POST
Create ads
PATCH
Update ads
GET
List ads
GET
Get ad
POST
Create product group promotions
PATCH
Update product group promotions
GET
Get product group promotions
GET
Get a product group promotion by id
POST
Create/update ad entities in bulk
Added parameters:
  • is_dynamic_cta
    (boolean, optional): Enables or disables dynamic CTA selection.
    • true
      : Pinterest automatically selects the best CTA from the
      cta_types
      list based on contextual signals, such as placement and device. For example, a user on Android viewing a search ad may see "Take a closer look" instead of a generic CTA.
    • false
      (default): The ad displays the CTA that you set in the customizable_cta_type parameter. If you do not specify a type, we determine a default CTA based on the ad's objective and destination.
  • cta_types
    (array of strings, optional but necessary if
    is_dynamic_cta
    is set to
    true
    .): All possible CTAs that can be shown for the ad based on context. Examples:
    "GET_OFFER"
    ,
    "LEARN_MORE"
    ,
    "ORDER_NOW"
    .

June 1, 2026

We made several improvements to how you upload and manage customer lists.
Row-by-row customer list uploads
Restricted
You can upload customer lists as a structured array of rows with separate fields per row, instead of having to pack everything into one long comma-separated string.
Affected endpoints:
POST
Create customer lists
PATCH
Update customer list
Changes:
  • A
    records_v2
    field takes an array of rows. Each row can include
    email
    ,
    maid
    ,
    ip_address
    ,
    user_agent
    , and
    external_id
    .
  • You send either the old
    records
    string or the new
    records_v2
    array, but not both.
  • If any rows are incorrectly formatted, you get back per-row errors instead of the whole upload failing.
  • If you use the old
    records
    format, you do not need to change anything.

Format validation

We validate and enforce formatting, and you get clearer errors when row data is malformed.
Affected endpoints:
POST
Create customer lists
PATCH
Update customer list
Changes:
  • ip_address
    must actually look like a real IP address (IPv4 or IPv6) and be 45 characters or fewer.
  • user_agent
    is capped at 512 characters.
  • external_id
    is capped at 256 characters.
  • Any "invisible" control characters in those fields, such as tabs, new lines, and null characters, are rejected. In practice, this catches common copy/paste mistakes from spreadsheets and CSV exports.
More ways to identify a customer in each row
You can include three additional identifier types when uploading a row on the newer API.
Affected endpoints:
POST
Create customer lists
PATCH
Update customer list
Changes:
We added several user data parameters, previously only available in Ads Manager. These are visible under the
records_v2
object:
  • hashed_pinner_id
    : Pinner's unique Pinterest ID, hashed with SHA1, SHA256, or MD5 algorithm.
  • hashed_phone_number
    : Pinner's phone number, hashed with SHA1, SHA256, or MD5 algorithm.
  • liveramp_envelope
    : Encrypted identity token that LiveRamp generates from a user's hashed, personally identifiable information (PII), when sending offline, uploaded conversion data to Pinterest. We then match the user information for audience targeting without receiving raw PII directly.
Ability to mark and filter "New Customer Acquisition" lists
Restricted
You can flag a customer list as being for New Customer Acquisition (NCA) when you create it, see that flag on any list or audience the API returns to you, and filter NCA lists out of your list/audience results when you do not want them.
Affected endpoints and changes:
POST
Create customer lists
  • Set
    is_nca
    to
    true
    to mark a list as NCA. Note: You cannot change this setting when updating the list.
GET
Get customer list
GET
List audiences
GET
Get audience
  • Set
    exclude_nca
    to
    true
    to filter out any lists you marked as NCA. Although making a list "NCA" is restricted, using this boolean parameter is available to any Pinterest-registered app.