Pinterest Ads compatibility

This page compares the Pinterest Ads capabilities represented in the Interchange adapter with what Interchange currently makes available to buyers. It answers a practical question: what can I do through Interchange today, and what would still require another path?

Last reviewed 2026-08-28. This is Interchange’s description of its own adapter, based on the implementation and the linked provider documentation. Pinterest Ads has not reviewed or endorsed this page. Availability can still vary by account permissions, market, and provider access.

At a glance

Area	🟢 Available	🟡 Partial	🔵 Testing	⚪ Planned
Campaign products	7	0	0	2
Creative formats	3	0	1	9
Adapter capabilities	10	3	0	3

How to read availability

🟢 Available — Offered through Interchange now, subject to your ad account’s permissions and eligibility with the provider.
🟡 Partial — Some of the workflow is available; the Comments column explains the boundary.
🔵 Testing — Interchange is validating the workflow before offering it broadly.
⚪ Planned — Not offered through Interchange yet. The provider may still support it directly; Comments explains why and links a roadmap reference.

Roadmap

The adapter roadmap is tracked in AI-1941 (a plain-text reference — Interchange’s internal issue tracker is not public). This roadmap tracks Pinterest adapter product completeness, provider feedback, and live readiness. Every row that is not currently available shows that reference or a more specific one in its References column, so customers and partners can quote a stable identifier when asking about a capability.

Connection, accounts, and identity

Pinterest Ads connects to Interchange through an OAuth grant. Connecting authorizes Interchange to reach your Ad account, which you then map to your advertisers. The mapped account decides which Pinterest Ads tenant a buy runs on: a media buy for an unmapped advertiser fails closed with account_mapping_required rather than silently using another account. Connection, account-discovery, and revocation behavior is the same across ad platforms — see Platform accounts and advertiser mapping for the full model and the Pinterest Ads section of the connecting guide for Pinterest Ads-specific permissions.

Interchange concept	Pinterest Ads concept	What it represents
Account (`account`)	ad account	Explicit Pinterest ad account selected after OAuth.
Media Buy (`media_buy`)	campaign	Objective, intended promotion type, lifecycle, and budget cap.
Package (`package`)	ad group	Budget, bid, optimization, targeting, placement group, frequency, and flight.
Creative (`creative`)	Pin	Existing or adapter-published image/video Pin.
Creative Assignment (`creative_assignment`)	ad	Ad binds a Pin to an ad group.
Signal (`signal`)	audience or interest node	Account-owned audiences and provider taxonomy IDs.

Campaign products

Feature	Availability	References	Comments
Awareness	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Consideration	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Video Views	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Conversions	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Leads	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Traffic	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Performance Plus	🟢 Available	Pinterest campaigns and ad groups	Available through Interchange.
Catalog Sales	⚪ Planned	Pinterest campaigns and ad groups · AI-3795	Interchange has not completed the end-to-end catalog sales workflow. Current boundary: Interchange implementation/testing.
Idea Pins	⚪ Planned	Pinterest campaigns and ad groups · AI-3797	Interchange does not yet support creating and reading Idea Pin creative end to end. Current boundary: Interchange implementation/testing.

Creative formats

These rows describe Interchange availability, not a claim that the ad platform itself prohibits an unavailable format.

Feature	Availability	References	Comments
Existing Post	🔵 Testing	Pinterest Ads API overview · AI-4032	Interchange is validating the authorization and promotion lifecycle for advertiser-owned Pins before making it generally available. Current boundary: Interchange implementation/testing.
Standard Pin	🟢 Available	Pinterest Ads API overview	Available through Interchange.
Video Pin	🟢 Available	Pinterest Ads API overview	Available through Interchange.
Max Width Video	🟢 Available	Pinterest Ads API overview	Available through Interchange.
Carousel	⚪ Planned	Pinterest Ads API overview · AI-4032	Interchange has not completed multi-image card publication, ad assignment, and Carousel readback. Current boundary: Interchange implementation/testing.
Collection	⚪ Planned	Pinterest Ads API overview · AI-4032	Interchange has not completed the hero, product-tile, catalog-linkage, assignment, and Collection readback workflow. Current boundary: Interchange implementation/testing.
Idea Pin	⚪ Planned	Pinterest Ads API overview · AI-4032	Interchange has not completed multi-page image and video publication, assignment, and Idea Pin readback. Current boundary: Interchange implementation/testing.
Showcase	⚪ Planned	Pinterest Ads API overview · AI-4032	Interchange has not completed Showcase card and feature publication, assignment, eligibility checks, and readback. Current boundary: Interchange implementation/testing.
Quiz	⚪ Planned	Pinterest Ads API overview · AI-4032	Interchange has not completed question, answer, result-card publication, account eligibility checks, assignment, and Quiz readback. Current boundary: Interchange implementation/testing.
Promoted Offerings	⚪ Planned	Pinterest Ads API overview · AI-4032	This is an Interchange orchestration format. The per-offering Pin selection, ad-group expansion, assignment, and readback workflow is not complete. Current boundary: Interchange implementation/testing.
Generated Image 2x3	⚪ Planned	Pinterest Ads API overview · AI-4032	This is an Interchange-generated format, not a separate Pinterest ad type. Interchange has not completed generation or generated-asset intake, faithful preview, Pin publication, ad assignment, replacement, exact readback and reporting, and cleanup as one workflow. The ordinary 2:3 Standard Pin remains available. Current boundary: Interchange implementation/testing.
Generated Video	⚪ Planned	Pinterest Ads API overview · AI-4032	This is an Interchange-generated format, not a separate Pinterest ad type. Interchange has not completed video generation, Pin publication, ad assignment, and readback. Current boundary: Interchange implementation/testing.
Generated Offerings	⚪ Planned	Pinterest Ads API overview · AI-4032	This is an Interchange-generated format, not a separate Pinterest ad type. Interchange has not completed per-offering generation, Pin publication, ad-group assignment, and readback. Current boundary: Interchange implementation/testing.

What the adapter can do

Feature	Availability	References	Comments
List Accounts	🟢 Available	Pinterest Ads API overview	Authorized ad-account discovery
Sync Accounts	⚪ Planned	Pinterest Ads API overview · AI-1941	Account synchronization is not implemented. Current boundary: Interchange implementation/testing.
Get Products	🟢 Available	Pinterest Ads API overview	Lists seven available campaign products and two products Interchange does not currently offer.
Sync Creatives	🟢 Available	Pinterest Ads API overview	Reserves durable Pin and assignment ownership before Pinterest writes, verifies the exact created Pin, selected-account owner, image or video class, and authored fields, and preserves the original creative identity and format. An accepted video media ID is journaled before upload/readiness polling, so a timeout or downstream source/upload rejection retries that exact media object instead of registering or uploading a duplicate; only terminal Pinterest processing failure permits replacement. The complete media operation has a four-minute deadline below a ten-minute durable lease; recovery renews and later compares the exact lease token, so stale callers cannot finish over a newer owner. Returned timeouts release it immediately, while crashes become recoverable after expiry. Replays join account inventory to an exact Pin point read, so omitted bulk-inventory fields do not create false drift and a field actually removed from the Pin still fails closed. Pinterest does not echo the input image URL or uploaded media ID, so transient rendition URLs and dimensions are not treated as durable identity; the exact requested assets remain bound separately. A missing completed ad is preserved for a durable 15-minute reconciliation window and requires another exact absence before replacement. Reconciliation failures attempt verified removal only when mutation ownership is proven; uncertain durable handoffs preserve the exact provider objects, fail visibly, and alert operators. Changed assets still require a new creative ID.
List Creatives	🟢 Available	Pinterest Ads API overview	Full selected-account Pin inventory; feed-version-bound, account-bound cursor pages of at most 100 creatives; filters and sort applied before the bounded page; exact point reads only for materialized identities on that page—including an inventory-omitted identity when its deterministic page is reached—with four concurrent reads under one 30-second deadline; and ad-assignment projection
Preview Creative	🟢 Available	Pinterest Ads API overview	Previews a saved Pinterest creative only when it resolves to one completed assignment in the selected ad account and Pinterest readback confirms the same ad group, Pin, ad, and placement group. Interchange returns Pinterest’s credential-free HTTPS preview link with Pinterest’s expiry and never returns executable embed code. Creating the preview record does not create or change the campaign, ad group, ad, or Pin. Batches accept at most four creatives so every accepted item starts within the bounded 30-second execution window. Unsynchronized or transient creatives, ambiguous assignments, unsupported formats, and identity or placement mismatches fail closed; no reference-renderer fallback is advertised.
Create Media Buy	🟢 Available	Pinterest Ads API overview	Campaign → ad group → ad
Get Media Buys	🟢 Available	Pinterest Ads API overview	Campaign hierarchy and targeting provenance
Update Media Buy	🟢 Available	Pinterest Ads API overview	Lifecycle, budget, bid, geography, audiences, and creative assignment updates with readback
Get Media Buy Delivery	🟢 Available	Pinterest Ads API overview	Campaign and ad-group analytics
Get Signals	🟢 Available	Pinterest Ads API overview	Audience and interest discovery
Sync Audiences	⚪ Planned	Pinterest Ads API overview · AI-1941	Interchange has not made customer-list audience syncing publicly available while it completes the account-bound lifecycle and deletion safeguards. Current boundary: Interchange implementation/testing.
Sync Event Sources	🟡 Partial	Pinterest Ads API overview · AI-1941	Interchange discovers the selected account’s Pinterest Conversion Tags and returns Pinterest-issued installation code when available. It does not create, change, or delete Tags, and server-side event delivery is not publicly available. Current boundary: Interchange implementation/testing.
Log Event	⚪ Planned	Pinterest Ads API overview · AI-1941	Interchange has not made server-side event ingestion publicly available. It is still validating end-to-end delivery against a Pinterest account set aside for testing. Nothing to change on your side. Current boundary: Interchange implementation/testing.
Sync Catalogs	🟡 Partial	Pinterest Ads API overview · AI-1941	Registers a Pinterest catalog feed URL through POST /catalogs/feeds and the local store; inline item push is not implemented. Current boundary: Interchange implementation/testing.
Get Account Financials	🟡 Partial	Pinterest Ads API overview · AI-1941	Campaign spend totals are available; the newer account-financials path is not yet connected. Current boundary: Interchange implementation/testing.

Placement choices

Feature	Availability	References	Comments
Pinterest Feed	🟡 Partial	Pinterest Ads API overview · AI-1941	Interchange sends all eligible Pinterest placements together; it does not expose a per-placement selector. Current boundary: Interchange implementation/testing.

Targeting

Feature	Availability	References	Comments
Geo Countries	🟢 Available	Pinterest targeting	Available through Interchange.
Geo Regions	🟢 Available	Pinterest targeting	Available through Interchange.
Audience Include	⚪ Planned	Pinterest targeting · AI-1941	Interchange does not yet offer customer-list audience inclusion for Pinterest campaigns. Current boundary: Interchange implementation/testing.
Audience Exclude	⚪ Planned	Pinterest targeting · AI-1941	Interchange does not yet offer customer-list audience exclusion for Pinterest campaigns. Current boundary: Interchange implementation/testing.
Signals	🟢 Available	Pinterest targeting	Available through Interchange.
Frequency Cap	🟢 Available	Pinterest targeting	Available through Interchange.
Placement Refs	🟡 Partial	Pinterest targeting · AI-1941	Interchange does not expose individual Pinterest placement selection; campaigns use all eligible placements. Current boundary: Interchange implementation/testing.

Reporting

Interchange reports Pinterest Ads delivery day by day (there is no hourly delivery breakdown), aggregated nightly from adapter-reported delivery, in the advertiser’s home currency using the booked or historical exchange rate — any cross-currency rollup is always labeled an estimate and is never used for billing. See Reporting overview for the full model. Interchange does not currently publish an attribution-finality window for Pinterest Ads; the table below lists every metric the adapter surfaces today.

Feature	Availability	References	Comments
Impressions	🟢 Available	Pinterest analytics	Campaign and ad-group totals
Clicks	🟢 Available	Pinterest analytics	Campaign and ad-group totals
Spend	🟢 Available	Pinterest analytics	Provider micro-currency converted exactly
Ctr	🟢 Available	Pinterest analytics	Calculated from raw provider values
Views	🟢 Available	Pinterest analytics	Video-view campaigns
By Package	🟢 Available	Pinterest analytics	AdCP package projection
By Catalog Item	🟢 Available	Pinterest analytics	Returned when the package has catalog-item identity

Webhooks and async lifecycle

Pinterest Ads does not push status, delivery, or reporting events into Interchange — every campaign product declares supports_webhooks: false.

Status. Interchange does not currently poll Pinterest Ads in the background for creative or media-buy status changes; status reflects what the adapter returned on your last call.
Delivery. Interchange fetches delivery numbers (spend, impressions, clicks) live from Pinterest Ads on demand, only when you call get_media_buy_delivery directly. The /reporting/metrics endpoints never call the adapter either way — they read from a separately-populated store (see Reporting below), so a reporting request does not itself refresh provider delivery.

This is separate from Interchange’s own buyer webhook subscriptions — an unrelated account-level event feed (currently discovery.revision only), documented in Buyer webhooks.

Market and account availability

Interchange does not promise that every feature is enabled for every account or market. Availability is checked against your selected ad account rather than a global market list on this page.

Important limitations

Interchange implementation/testing. Catalog Sales and Idea Pins are not available through Interchange because their end-to-end creation workflows are incomplete.
Interchange implementation/testing. Promoting an existing Pin is still being tested and is not generally available.
Interchange implementation/testing. Pinterest preview is available only for a saved creative with one verified assignment in the selected ad account. Unsynchronized or transient creatives do not use an approximate fallback.
Interchange implementation/testing. Generated and other rich Pin formats remain planned until asset intake, faithful preview, materialization, assignment, replacement, reverse readback and reporting, and cleanup are complete. Ordinary 2:3 Standard Pins are available.
Interchange implementation/testing. Interchange sends all eligible Pinterest placements together instead of exposing individual placement selection.
the ad platform’s API. Pinterest analytics can take up to 72 hours to stabilize, and Pinterest constrains the available attribution windows.
Interchange implementation/testing. Catalog sync accepts feed URLs but does not push inline catalog items.
Interchange implementation/testing. Customer-list audiences and server-side event ingestion are not yet publicly available.

Technical mapping

Engineering-level detail — raw provider objectives, billing enums, optimization codes, and object-field mappings. Not required reading to understand what Interchange can do with Pinterest Ads; see the tables above for that.

Campaign product configuration

Product	Provider objective	Optimization	Billing
Awareness (`pinterest_awareness`)	`AWARENESS`	`AUTOMATIC_BID`	`IMPRESSION`
Consideration (`pinterest_consideration`)	`CONSIDERATION`	`clicks`	`CLICKTHROUGH`
Video Views (`pinterest_video_views`)	`VIDEO_VIEW`	`AUTOMATIC_BID`	`VIDEO_V_50_MRC`
Conversions (`pinterest_conversions`)	`SALES / STANDARD_AD`	`CHECKOUT`	`IMPRESSION`
Leads (`pinterest_leads`)	`LEADS / STANDARD_AD`	`LEAD`	`IMPRESSION`
Traffic (`pinterest_traffic`)	`WEB_SESSIONS`	`clicks`	`CLICKTHROUGH`
Performance Plus (`pinterest_performance_plus`)	`SALES / STANDARD_AD`	`CHECKOUT + auto targeting`	`IMPRESSION`
Catalog Sales (`pinterest_catalog_sales`)	`SALES / CATALOG`	`CHECKOUT`	`IMPRESSION`
Idea Pins (`pinterest_idea_pins`)	`AWARENESS`	`AUTOMATIC_BID`	`IMPRESSION`

Creative format shapes

Format	Pinterest Ads shape
Existing Post (`pinterest_existing_post`)	authorized existing Pin
Standard Pin (`pinterest_standard_pin`)	REGULAR image Pin
Video Pin (`pinterest_video_pin`)	VIDEO Pin
Max Width Video (`pinterest_max_width_video`)	MAX_VIDEO Pin
Carousel (`pinterest_carousel`)	CAROUSEL Pin
Collection (`pinterest_collection`)	COLLECTION Pin
Idea Pin (`pinterest_idea_pin`)	IDEA Pin
Showcase (`pinterest_showcase`)	SHOWCASE Pin
Quiz (`pinterest_quiz`)	QUIZ Pin
Promoted Offerings (`pinterest_promoted_offerings`)	one ad group and Pin per offering
Generated Image 2x3 (`pinterest_generated_image_2x3`)	generated 2:3 Pin image
Generated Video (`pinterest_generated_video`)	generated vertical Pin video
Generated Offerings (`pinterest_generated_offerings`)	generated Pin per offering

Targeting field mapping

Targeting choice	Provider field
Geo Countries (`geo_countries`)	`targeting_spec.LOCATION`
Geo Regions (`geo_regions`)	`ISO subdivision → targeting_spec.GEO with provenance`
Audience Include (`audience_include`)	`Not publicly activated while the governed audience lifecycle and targeting authority remain pending`
Audience Exclude (`audience_exclude`)	`Not publicly activated while the governed audience lifecycle and targeting authority remain pending`
Signals (`signals`)	`targeting_spec.INTEREST after taxonomy resolution`
Frequency Cap (`frequency_cap`)	`lifetime_frequency_cap`
Placement Refs (`placement_refs`)	`No per-placement AdCP selection; ad groups currently use placement_group ALL`

Reporting field mapping

Interchange output	Pinterest Ads source
Impressions (`impressions`)	`TOTAL_IMPRESSION`
Clicks (`clicks`)	`TOTAL_CLICKTHROUGH`
Spend (`spend`)	`SPEND_IN_MICRO_DOLLAR`
Ctr (`ctr`)	`TOTAL_CLICKTHROUGH / TOTAL_IMPRESSION`
Views (`views`)	`TOTAL_VIDEO_MRC_VIEWS`
By Package (`by_package`)	`ad-group analytics`
By Catalog Item (`by_catalog_item`)	`durable entity mapping`

Start here

Buy media

Sell media

Help and updates

Pinterest Ads compatibility

At a glance

How to read availability

Roadmap

Connection, accounts, and identity

Campaign products

Creative formats

What the adapter can do

Placement choices

Targeting

Reporting

Webhooks and async lifecycle

Market and account availability

Important limitations

Technical mapping

Provider documentation

​At a glance

​How to read availability

​Roadmap

​Connection, accounts, and identity

​Campaign products

​Creative formats

​What the adapter can do

​Placement choices

​Targeting

​Reporting

​Webhooks and async lifecycle

​Market and account availability

​Important limitations

​Technical mapping

​Provider documentation

At a glance

How to read availability

Roadmap

Connection, accounts, and identity

Campaign products

Creative formats

What the adapter can do

Placement choices

Targeting

Reporting

Webhooks and async lifecycle

Market and account availability

Important limitations

Technical mapping

Provider documentation