Pinterest API API changelog - seamless.engineering https://seamless.engineering/api-changelog/pinterest/ Every Pinterest API API change our daily monitoring detects: breaking changes, deprecations and additions. en Sat, 10 Oct 2026 00:10:15 GMT 720 Pinner data access denial error https://seamless.engineering/api-changelog/pinterest/#028cfb84bb81 pinterest-028cfb84bb81 Thu, 24 Sep 2026 12:00:00 GMT Breaking Breaking (2026-09-14). 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. Update reporting for objective simplification https://seamless.engineering/api-changelog/pinterest/#ed99eff7b586 pinterest-ed99eff7b586 Thu, 24 Sep 2026 12:00:00 GMT Deprecation Deprecation (2026-09-01). 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. Automatic UTM parameters for ads https://seamless.engineering/api-changelog/pinterest/#cd770545e45f pinterest-cd770545e45f Tue, 15 Sep 2026 12:00:00 GMT Breaking Breaking (2026-09-15). 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. Age bucket and gender targeting visibility in reports https://seamless.engineering/api-changelog/pinterest/#0b96a9b5c0b9 pinterest-0b96a9b5c0b9 Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-07-01). New visibility for age bucket and gender targeting data in analytics and reports. Agency owned ad accounts https://seamless.engineering/api-changelog/pinterest/#977962db065c pinterest-977962db065c Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-09-02). 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. Developer terms and guidelines updated https://seamless.engineering/api-changelog/pinterest/#ddb4b0a37779 pinterest-ddb4b0a37779 Fri, 04 Sep 2026 12:00:00 GMT Other Other (2026-08-01). Updates to developer terms and guidelines documentation affecting API usage policies. Disclosing AI content in ads https://seamless.engineering/api-changelog/pinterest/#52ce5125f8f6 pinterest-52ce5125f8f6 Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-06-01). New capability to disclose AI-generated content in ads. Dynamic CTAs https://seamless.engineering/api-changelog/pinterest/#e01069acb8fd pinterest-e01069acb8fd Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-06-01). New dynamic call-to-action capabilities for ads. Lower-funnel objectives for Media Planner https://seamless.engineering/api-changelog/pinterest/#a1f429b5ed45 pinterest-a1f429b5ed45 Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-06-01). New lower-funnel objectives added to Media Planner capabilities. Objective simplification features in production https://seamless.engineering/api-changelog/pinterest/#4b919a44a77c pinterest-4b919a44a77c Fri, 04 Sep 2026 12:00:00 GMT New feature New feature (2026-06-01). Campaign objective simplification features moving to production after initial phase rollout. Developer terms and guidelines updated https://seamless.engineering/api-changelog/pinterest/#ba37dc85c002 pinterest-ba37dc85c002 Sat, 22 Aug 2026 12:00:00 GMT Other Other (2026-08-18). 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. Objective simplification features in production https://seamless.engineering/api-changelog/pinterest/#cf6ba3ed86f3 pinterest-cf6ba3ed86f3 Sat, 25 Jul 2026 12:00:00 GMT New feature New feature. Objective simplification features have moved from beta to production, affecting ad campaign creation and management endpoints. Age bucket and gender targeting visibility in reports https://seamless.engineering/api-changelog/pinterest/#29029770cddf pinterest-29029770cddf Wed, 22 Jul 2026 12:00:00 GMT New feature New feature (2026-07-06). 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. Dynamic product titles https://seamless.engineering/api-changelog/pinterest/#3fee1f59c87a pinterest-3fee1f59c87a Thu, 25 Jun 2026 12:00:00 GMT New feature New feature (2026-06-01). New dynamic product title capabilities for shopping. Advertiser-defined events https://seamless.engineering/api-changelog/pinterest/#83296e8240b3 pinterest-83296e8240b3 Wed, 17 Jun 2026 12:00:00 GMT New feature New feature. New capability for advertisers to define custom conversion events. Custom conversion events https://seamless.engineering/api-changelog/pinterest/#93d3ffc86ec8 pinterest-93d3ffc86ec8 Wed, 17 Jun 2026 12:00:00 GMT New feature New feature. Enhanced support for custom conversion event definitions in ads. Expanded marketing mix modeling report https://seamless.engineering/api-changelog/pinterest/#6db841d66493 pinterest-6db841d66493 Wed, 17 Jun 2026 12:00:00 GMT New feature New feature. Marketing mix modeling reports have been expanded with additional data or capabilities. Lower-funnel objectives for Media Planner https://seamless.engineering/api-changelog/pinterest/#ce6f269d929b pinterest-ce6f269d929b Wed, 17 Jun 2026 12:00:00 GMT Deprecation Deprecation (2026-06-15). 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. New customer acquisition https://seamless.engineering/api-changelog/pinterest/#55ee060d6a29 pinterest-55ee060d6a29 Wed, 17 Jun 2026 12:00:00 GMT New feature New feature. New features or parameters added for targeting new customer acquisition in campaigns. Reporting timezone GA for analytics endpoints https://seamless.engineering/api-changelog/pinterest/#98f4e9ec74c0 pinterest-98f4e9ec74c0 Wed, 17 Jun 2026 12:00:00 GMT New feature New feature. Timezone reporting parameter generally available in analytics endpoints. Using Pinterest docs with AI tools https://seamless.engineering/api-changelog/pinterest/#ec86fed6b70e pinterest-ec86fed6b70e Wed, 17 Jun 2026 12:00:00 GMT Other Other. Documentation now compatible with AI tools for improved developer experience. Customer list improvements https://seamless.engineering/api-changelog/pinterest/#dbf89c46a887 pinterest-dbf89c46a887 Wed, 10 Jun 2026 12:00:00 GMT New feature New feature (2026-06-01). Improvements to customer list management functionality. Customer list improvements - Additional identifier types https://seamless.engineering/api-changelog/pinterest/#9a5b66429cf4 pinterest-9a5b66429cf4 Wed, 10 Jun 2026 12:00:00 GMT New feature New feature (2026-06-01). Three new identifier types added to customer lists: hashed_pinner_id, hashed_phone_number, and liveramp_envelope for improved user matching without raw PII. Dynamic CTAs https://seamless.engineering/api-changelog/pinterest/#e4ae4ea2d6e4 pinterest-e4ae4ea2d6e4 Wed, 10 Jun 2026 12:00:00 GMT New feature New feature (2026-06-08). 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 Customer Acquisition marking https://seamless.engineering/api-changelog/pinterest/#04c0e7f42240 pinterest-04c0e7f42240 Mon, 01 Jun 2026 12:00:00 GMT New feature New feature (2026-06-01). 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 https://seamless.engineering/api-changelog/pinterest/#209983fbefa1 pinterest-209983fbefa1 Mon, 01 Jun 2026 12:00:00 GMT New feature New feature (2026-06-01). 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 https://seamless.engineering/api-changelog/pinterest/#936cac47494f pinterest-936cac47494f Mon, 01 Jun 2026 12:00:00 GMT New feature New feature (2026-06-09). 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. Expanded marketing mix modeling report https://seamless.engineering/api-changelog/pinterest/#387fd6687a0b pinterest-387fd6687a0b Fri, 22 May 2026 12:00:00 GMT New feature New feature (2026-05-01). Marketing mix modeling report capabilities expanded with additional features. Objective simplification features in production https://seamless.engineering/api-changelog/pinterest/#75a2ee56eff3 pinterest-75a2ee56eff3 Fri, 22 May 2026 12:00:00 GMT Breaking Breaking (2026-06-15). 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. Collage ad capabilities https://seamless.engineering/api-changelog/pinterest/#2ae2feb464d5 pinterest-2ae2feb464d5 Tue, 12 May 2026 12:00:00 GMT New feature New feature (2026-04-27). 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 https://seamless.engineering/api-changelog/pinterest/#3ec3cadd6e3b pinterest-3ec3cadd6e3b Mon, 04 May 2026 12:00:00 GMT Other Other (2026-04-23). 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 https://seamless.engineering/api-changelog/pinterest/#28908b6e9095 pinterest-28908b6e9095 Fri, 01 May 2026 12:00:00 GMT New feature New feature (2026-04-17). 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 https://seamless.engineering/api-changelog/pinterest/#fe4c06c99690 pinterest-fe4c06c99690 Wed, 15 Apr 2026 12:00:00 GMT New feature New feature (2026-04-13). 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 customer acquisition targeting https://seamless.engineering/api-changelog/pinterest/#6f5cf2619139 pinterest-6f5cf2619139 Fri, 10 Apr 2026 12:00:00 GMT New feature New feature (2026-04-06). 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. Asynchronous upload jobs for large customer lists https://seamless.engineering/api-changelog/pinterest/#a82c212eeb1f pinterest-a82c212eeb1f Thu, 09 Apr 2026 12:00:00 GMT New feature New feature. New asynchronous upload capability for large customer lists to improve performance. Custom conversion events https://seamless.engineering/api-changelog/pinterest/#aaebc0d2b644 pinterest-aaebc0d2b644 Thu, 09 Apr 2026 12:00:00 GMT New feature New feature (2026-04-02). 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. Shareable ad preview links https://seamless.engineering/api-changelog/pinterest/#d197b5a3a560 pinterest-d197b5a3a560 Thu, 09 Apr 2026 12:00:00 GMT New feature New feature. New capability to generate shareable links for ad previews. Item-level promotions and multiple ad group promotions https://seamless.engineering/api-changelog/pinterest/#3a68d0be7707 pinterest-3a68d0be7707 Sat, 04 Apr 2026 12:00:00 GMT New feature New feature. Enhanced promotion functionality supporting item-level and multiple ad group promotions. Shareable ad preview links https://seamless.engineering/api-changelog/pinterest/#8ea56b2207c5 pinterest-8ea56b2207c5 Wed, 01 Apr 2026 12:00:00 GMT New feature New feature (2026-03-30). 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. Asynchronous upload jobs for large customer lists https://seamless.engineering/api-changelog/pinterest/#de5183765ca0 pinterest-de5183765ca0 Tue, 31 Mar 2026 12:00:00 GMT New feature New feature (2026-03-13). 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. Applying labels to campaigns https://seamless.engineering/api-changelog/pinterest/#aaf33289eaaa pinterest-aaf33289eaaa Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New functionality to apply organizational labels to campaigns for better management and filtering. Campaign objective type simplification initial phase https://seamless.engineering/api-changelog/pinterest/#8036a794236b pinterest-8036a794236b Sun, 29 Mar 2026 12:00:00 GMT Breaking Breaking. Initial phase of campaign objective type simplification changes. Campaign spend estimation https://seamless.engineering/api-changelog/pinterest/#00e1d3c35bda pinterest-00e1d3c35bda Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New endpoint or parameter for estimating campaign spend. Conversion events added for app use, trials, and more https://seamless.engineering/api-changelog/pinterest/#23c0408f5898 pinterest-23c0408f5898 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New conversion event types added for app usage, trials, and other actions. Deprecation of gtin integer support https://seamless.engineering/api-changelog/pinterest/#3a0b29b895fa pinterest-3a0b29b895fa Sun, 29 Mar 2026 12:00:00 GMT Deprecation Deprecation. GTIN integer support marked for deprecation in shopping API. Deprecation of user interests endpoint https://seamless.engineering/api-changelog/pinterest/#3cc8cd08580e pinterest-3cc8cd08580e Sun, 29 Mar 2026 12:00:00 GMT Deprecation Deprecation. User interests endpoint marked for deprecation in the analytics API. Image auto-resizing in product group promotions https://seamless.engineering/api-changelog/pinterest/#6fcaa10aed0f pinterest-6fcaa10aed0f Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. Automatic image resizing capability added to product group promotion endpoints. Item-level promotions and multiple ad group promotions https://seamless.engineering/api-changelog/pinterest/#690d3a6e1846 pinterest-690d3a6e1846 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature (2026-03-16). 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. Management of local store inventory in catalogs https://seamless.engineering/api-changelog/pinterest/#4e3885f8b172 pinterest-4e3885f8b172 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New capability to manage local store inventory through catalog APIs. Premium placement in search results https://seamless.engineering/api-changelog/pinterest/#ce3e2ea96a8c pinterest-ce3e2ea96a8c Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New feature for premium ad placement in search results. Removal of users from conversion data https://seamless.engineering/api-changelog/pinterest/#63928ff7bc09 pinterest-63928ff7bc09 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New capability to remove user data from conversion tracking. Scheduled campaign budget adjustments in bulk requests https://seamless.engineering/api-changelog/pinterest/#936545896bd2 pinterest-936545896bd2 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. Bulk request support added for scheduled campaign budget adjustments. Simplified management of Pinterest Performance+ entities https://seamless.engineering/api-changelog/pinterest/#be1ae1f6e5c7 pinterest-be1ae1f6e5c7 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. Simplified API for managing Pinterest Performance+ ad entities. Standardization of optional nullable fields https://seamless.engineering/api-changelog/pinterest/#7d6e8e158191 pinterest-7d6e8e158191 Sun, 29 Mar 2026 12:00:00 GMT Other Other. Fields that are optional and nullable have been standardized across ads endpoints for consistency. Where-to-buy links in ads https://seamless.engineering/api-changelog/pinterest/#78014741c36d pinterest-78014741c36d Sun, 29 Mar 2026 12:00:00 GMT New feature New feature. New capability to add where-to-buy links to ads.