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.
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).
Labels are assigned automatically. Check the vendor's note before planning work around an entry.
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.
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.
Affects one of your integrations? We take over the migration, at a fixed priceNew 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.
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.
Affects one of your integrations? We take over the migration, at a fixed pricePinterest 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.
Updates to developer terms and guidelines documentation affecting API usage policies.
Objective simplification features have moved from beta to production, affecting ad campaign creation and management endpoints.
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.
New visibility for age bucket and gender targeting data in analytics and reports.
New capability for advertisers to define custom conversion events.
Enhanced support for custom conversion event definitions in ads.
Marketing mix modeling reports have been expanded with additional data or capabilities.
New features or parameters added for targeting new customer acquisition in campaigns.
Timezone reporting parameter generally available in analytics endpoints.
Documentation now compatible with AI tools for improved developer experience.
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.
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.
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.
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.
Improvements to customer list management functionality.
Three new identifier types added to customer lists: hashed_pinner_id, hashed_phone_number, and liveramp_envelope for improved user matching without raw PII.
New is_nca parameter allows marking customer lists as New Customer Acquisition, with exclude_nca filter available to exclude NCA lists from results.
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.
New capability to disclose AI-generated content in ads.
New dynamic call-to-action capabilities for ads.
New dynamic product title capabilities for shopping.
New lower-funnel objectives added to Media Planner capabilities.
Campaign objective simplification features moving to production after initial phase rollout.
Marketing mix modeling report capabilities expanded with additional features.
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.
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.
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.
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.
New asynchronous upload capability for large customer lists to improve performance.
New capability to generate shareable links for ad previews.
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.
Enhanced promotion functionality supporting item-level and multiple ad group promotions.
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.
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.
New functionality to apply organizational labels to campaigns for better management and filtering.
Initial phase of campaign objective type simplification changes.
New endpoint or parameter for estimating campaign spend.
New conversion event types added for app usage, trials, and other actions.
GTIN integer support marked for deprecation in shopping API.
User interests endpoint marked for deprecation in the analytics API.
Automatic image resizing capability added to product group promotion endpoints.
New capability to manage local store inventory through catalog APIs.
New feature for premium ad placement in search results.
New capability to remove user data from conversion tracking.
Bulk request support added for scheduled campaign budget adjustments.
Simplified API for managing Pinterest Performance+ ad entities.
Fields that are optional and nullable have been standardized across ads endpoints for consistency.
New capability to add where-to-buy links to ads.
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.
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.
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.