# Pinterest API API changelog

We check Pinterest API's changelog and OpenAPI spec every day, because we run production integrations on the Pinterest API API. This page lists the 55 changes we have recorded since monitoring started on 29 March 2026, newest first.

**In short:** 2 breaking changes and 1 deprecation in the Pinterest API API in the last 90 days. The latest: “Automatic UTM parameters for ads” (15 September 2026).

- [Official Pinterest API changelog](https://developers.pinterest.com/docs/changelog/changelog/)
- [Pinterest API OpenAPI spec](https://raw.githubusercontent.com/pinterest/api-description/main/v5/openapi.yaml)
- [RSS feed: Pinterest API API changes](https://seamless.engineering/api-changelog/pinterest/rss.xml)

## Pinterest API API changes

Labels are assigned automatically. Check the vendor's note before planning work around an entry.

### September 2026

- **Automatic UTM parameters for ads** (Breaking, 15 Sept 2026): Pinterest now automatically adds UTM parameters to ad destination URLs unless opted out, which may affect integrations that rely on exact URL strings or query parameter validation.
- **Pinner data access denial error** (Breaking, 14 Sept 2026): New HTTP 403 PINNER_DATA_DENIED error for apps registered after September 14, 2026 when requesting boards or Pins without explicit authorization, requiring approval before requests can succeed.
- **Agency owned ad accounts** (New feature, 2 Sept 2026): New endpoints added to allow agencies to create and manage agency-owned ad accounts on behalf of advertisers with new POST, PATCH, and GET request endpoints.
- **Update reporting for objective simplification** (Deprecation, 1 Sept 2026): Required migration of all ad campaigns to support new SALES and LEADS campaign objectives while treating CATALOG_SALES and WEB_CONVERSION as legacy, with mandatory migration deadline of February 1, 2027.

### August 2026

- **Developer terms and guidelines updated** (Other, 18 Aug 2026): Pinterest updated Developer and API Terms of Service and Developer Guidelines to clarify how developers may use Pinterest Data made available through APIs and authorized tools.
- **Developer terms and guidelines updated** (Other, 1 Aug 2026): Updates to developer terms and guidelines documentation affecting API usage policies.

### July 2026

- **Objective simplification features in production** (New feature, 25 Jul 2026): Objective simplification features have moved from beta to production, affecting ad campaign creation and management endpoints.
- **Age bucket and gender targeting visibility in reports** (New feature, 6 Jul 2026): New demographic targeting columns (AGE_BUCKET and GENDER) added to the reporting API's targeting_types array for segmenting product item performance by age and gender.
- **Age bucket and gender targeting visibility in reports** (New feature, 1 Jul 2026): New visibility for age bucket and gender targeting data in analytics and reports.

### June 2026

- **Advertiser-defined events** (New feature, 17 Jun 2026): New capability for advertisers to define custom conversion events.
- **Custom conversion events** (New feature, 17 Jun 2026): Enhanced support for custom conversion event definitions in ads.
- **Expanded marketing mix modeling report** (New feature, 17 Jun 2026): Marketing mix modeling reports have been expanded with additional data or capabilities.
- **New customer acquisition** (New feature, 17 Jun 2026): New features or parameters added for targeting new customer acquisition in campaigns.
- **Reporting timezone GA for analytics endpoints** (New feature, 17 Jun 2026): Timezone reporting parameter generally available in analytics endpoints.
- **Using Pinterest docs with AI tools** (Other, 17 Jun 2026): Documentation now compatible with AI tools for improved developer experience.
- **Lower-funnel objectives for Media Planner** (Deprecation, 15 Jun 2026): WEB_CONVERSION and CATALOG_SALES objectives can now be used with Media Planner API for forecasted audience sizing and outcomes, as part of objective simplification deprecation.
- **Objective simplification features in production** (Breaking, 15 Jun 2026): Campaign objective simplification with new LEADS and SALES objectives replacing WEB_CONVERSION and CATALOG_SALES is now in production with a February 1, 2027 migration deadline.
- **Disclosing AI content in ads** (New feature, 9 Jun 2026): New ai_disclosures parameter added to Pin endpoints allowing declaration of AI-generated content (synthetic performers, AI-modified) to meet legal requirements like New York's synthetic performer disclosure law.
- **Dynamic CTAs** (New feature, 8 Jun 2026): New is_dynamic_cta and cta_types parameters added to ad and product group promotion endpoints enabling Pinterest's automatic CTA selection based on context for improved engagement.
- **Customer list improvements** (New feature, 1 Jun 2026): Improvements to customer list management functionality.
- **Customer list improvements - Additional identifier types** (New feature, 1 Jun 2026): Three new identifier types added to customer lists: hashed_pinner_id, hashed_phone_number, and liveramp_envelope for improved user matching without raw PII.
- **Customer list improvements - New Customer Acquisition marking** (New feature, 1 Jun 2026): New is_nca parameter allows marking customer lists as New Customer Acquisition, with exclude_nca filter available to exclude NCA lists from results.
- **Customer list improvements - Row-by-row uploads** (New feature, 1 Jun 2026): New records_v2 field supports structured array-based customer list uploads with per-row fields instead of comma-separated strings, with per-row error reporting.
- **Disclosing AI content in ads** (New feature, 1 Jun 2026): New capability to disclose AI-generated content in ads.
- **Dynamic CTAs** (New feature, 1 Jun 2026): New dynamic call-to-action capabilities for ads.
- **Dynamic product titles** (New feature, 1 Jun 2026): New dynamic product title capabilities for shopping.
- **Lower-funnel objectives for Media Planner** (New feature, 1 Jun 2026): New lower-funnel objectives added to Media Planner capabilities.
- **Objective simplification features in production** (New feature, 1 Jun 2026): Campaign objective simplification features moving to production after initial phase rollout.

### May 2026

- **Expanded marketing mix modeling report** (New feature, 1 May 2026): Marketing mix modeling report capabilities expanded with additional features.

### April 2026

- **Collage ad capabilities** (New feature, 27 Apr 2026): Added two new parameters (is_collage_accepted_terms and is_collage_single_destination) to programmatically manage collage Pins promotion across Create, Update, and Get ads endpoints in closed beta.
- **Using Pinterest docs with AI tools** (Other, 23 Apr 2026): Documentation now supports AI-friendly formats (Markdown, llms.txt index) and includes a 'Use with AI' button for integration with LLMs like ChatGPT and Claude.
- **Advertiser-defined events** (New feature, 17 Apr 2026): Added four new endpoints to define custom conversion event types (max 15 per advertiser), map them to Pinterest standard events, and use them for tracking and campaign optimization.
- **Reporting timezone GA for analytics endpoints** (New feature, 13 Apr 2026): Analytics endpoints now support reporting_timezone field for general availability, allowing control over how time-based data is sliced with two timezone options: PINTEREST_TIME_ZONE (UTC) and AD_ACCOUNT_TIME_ZONE.
- **Asynchronous upload jobs for large customer lists** (New feature, 9 Apr 2026): New asynchronous upload capability for large customer lists to improve performance.
- **Shareable ad preview links** (New feature, 9 Apr 2026): New capability to generate shareable links for ad previews.
- **New customer acquisition targeting** (New feature, 6 Apr 2026): Added performance_plus_campaign_settings, boost_prospecting_ad_group_bid, pinner_list_exclusions, and feed_profile_id parameters to campaigns and ad groups to enable NCA focus with bid multipliers and audience exclusions.
- **Item-level promotions and multiple ad group promotions** (New feature, 4 Apr 2026): Enhanced promotion functionality supporting item-level and multiple ad group promotions.
- **Custom conversion events** (New feature, 2 Apr 2026): Conversion tracking now supports custom-named events (up to 100 characters, alphanumeric with underscores/hyphens, case insensitive) defined by advertisers, with a limit of 15 custom events per advertiser ID, usable across Conversions API, Pinterest Tag, and partner integrations.

### March 2026

- **Shareable ad preview links** (New feature, 30 Mar 2026): New endpoints added to generate and manage shareable preview URLs for ads and product group promotions, allowing stakeholders to view creatives without Ads Manager access.
- **Applying labels to campaigns** (New feature, 29 Mar 2026): New functionality to apply organizational labels to campaigns for better management and filtering.
- **Campaign objective type simplification initial phase** (Breaking, 29 Mar 2026): Initial phase of campaign objective type simplification changes.
- **Campaign spend estimation** (New feature, 29 Mar 2026): New endpoint or parameter for estimating campaign spend.
- **Conversion events added for app use, trials, and more** (New feature, 29 Mar 2026): New conversion event types added for app usage, trials, and other actions.
- **Deprecation of gtin integer support** (Deprecation, 29 Mar 2026): GTIN integer support marked for deprecation in shopping API.
- **Deprecation of user interests endpoint** (Deprecation, 29 Mar 2026): User interests endpoint marked for deprecation in the analytics API.
- **Image auto-resizing in product group promotions** (New feature, 29 Mar 2026): Automatic image resizing capability added to product group promotion endpoints.
- **Management of local store inventory in catalogs** (New feature, 29 Mar 2026): New capability to manage local store inventory through catalog APIs.
- **Premium placement in search results** (New feature, 29 Mar 2026): New feature for premium ad placement in search results.
- **Removal of users from conversion data** (New feature, 29 Mar 2026): New capability to remove user data from conversion tracking.
- **Scheduled campaign budget adjustments in bulk requests** (New feature, 29 Mar 2026): Bulk request support added for scheduled campaign budget adjustments.
- **Simplified management of Pinterest Performance+ entities** (New feature, 29 Mar 2026): Simplified API for managing Pinterest Performance+ ad entities.
- **Standardization of optional nullable fields** (Other, 29 Mar 2026): Fields that are optional and nullable have been standardized across ads endpoints for consistency.
- **Where-to-buy links in ads** (New feature, 29 Mar 2026): New capability to add where-to-buy links to ads.
- **Item-level promotions and multiple ad group promotions** (New feature, 16 Mar 2026): Added support for creating promotions for individual catalog items and including up to five promotions per ad group, with new promotion_ids and promotion_application_level parameters for ad groups and promotion_id for catalog batch updates.
- **Asynchronous upload jobs for large customer lists** (New feature, 13 Mar 2026): New asynchronous API endpoints for uploading large CRM lists (up to 10 million identifiers) using AWS S3 storage to avoid rate limits and improve throughput for ad targeting.

## Other APIs we monitor

- [Airtable](https://seamless.engineering/api-changelog/airtable/)
- [Brevo](https://seamless.engineering/api-changelog/brevo/)
- [DATEV](https://seamless.engineering/api-changelog/datev/)
- [Discord](https://seamless.engineering/api-changelog/discord/)
- [Google Sheets](https://seamless.engineering/api-changelog/google-sheets/)
- [HubSpot](https://seamless.engineering/api-changelog/hubspot/)
- [Jira Cloud](https://seamless.engineering/api-changelog/jira/)
- [lexoffice](https://seamless.engineering/api-changelog/lexoffice/)
- [Linear](https://seamless.engineering/api-changelog/linear/)
- [Monday.com](https://seamless.engineering/api-changelog/monday/)
- [Notion](https://seamless.engineering/api-changelog/notion/)
- [Personio](https://seamless.engineering/api-changelog/personio/)
- [Pipedrive](https://seamless.engineering/api-changelog/pipedrive/)
- [Salesforce](https://seamless.engineering/api-changelog/salesforce/)
- [Shopify](https://seamless.engineering/api-changelog/shopify/)
- [Slack](https://seamless.engineering/api-changelog/slack/)
- [Stripe](https://seamless.engineering/api-changelog/stripe/)
- [Xentral](https://seamless.engineering/api-changelog/xentral/)
- [Zendesk](https://seamless.engineering/api-changelog/zendesk/)

## Frequently asked questions

### Has the Pinterest API API had breaking changes recently?

Yes: 2 breaking changes and 1 deprecation in the last 90 days. The most recent is “Automatic UTM parameters for ads” from 15 September 2026.

### How often does the Pinterest API API change?

Over the period on record, Pinterest API published about 8 changelog entries a month. Most are additions; the breaking changes and deprecations are the ones to plan for.

### Where is the official Pinterest API API changelog?

Pinterest API publishes it at https://developers.pinterest.com/docs/changelog/changelog/. This page follows it daily and dates each entry.

### How do I get notified about Pinterest API API changes?

Subscribe to this page's RSS feed (https://seamless.engineering/api-changelog/pinterest/rss.xml). If you would rather have someone act on them, we operate Pinterest API integrations and handle changes like these before they reach production.

## Request a scoping call

We watch Pinterest API because we run integrations on it. If one of yours depends on Pinterest API, we can take it over: build it properly, operate it, and fix it when Pinterest API changes, before your data is affected. Fixed-price scoping quote within 48 hours.

- Email: hello@seamless.engineering
- Contact form: https://seamless.engineering/#contact