> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest Ads compatibility

> What you can and cannot do with Pinterest Ads through Apostra.

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

<Note>
  **Last reviewed 2026-08-28.** This is Apostra'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.
</Note>

## 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 Apostra 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** — Apostra is validating the workflow before offering it broadly.
* ⚪ **Planned** — Not offered through Apostra 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 — Apostra'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 Apostra through an OAuth grant. Connecting authorizes Apostra 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](/v2/concepts/ad-platform-accounts) for the full model and the [Pinterest Ads section of the connecting guide](/v2/guides/connecting-ad-platforms#pinterest) for Pinterest Ads-specific permissions.

| Apostra 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](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Consideration    | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Video Views      | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Conversions      | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Leads            | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Traffic          | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Performance Plus | 🟢 Available | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)           | Available through Apostra.                                                                                                        |
| Catalog Sales    | ⚪ Planned    | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/) · AI-3795 | Apostra has not completed the end-to-end catalog sales workflow. Current boundary: Apostra implementation/testing.                |
| Idea Pins        | ⚪ Planned    | [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/) · AI-3797 | Apostra does not yet support creating and reading Idea Pin creative end to end. Current boundary: Apostra implementation/testing. |

## Creative formats

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

| Feature             | Availability | References                                                                            | Comments                                                                                                                                                                                                                                                                                                                                                            |
| ------------------- | ------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Existing Post       | 🔵 Testing   | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra is validating the authorization and promotion lifecycle for advertiser-owned Pins before making it generally available. Current boundary: Apostra implementation/testing.                                                                                                                                                                                   |
| Standard Pin        | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Available through Apostra.                                                                                                                                                                                                                                                                                                                                          |
| Video Pin           | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Available through Apostra.                                                                                                                                                                                                                                                                                                                                          |
| Max Width Video     | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Available through Apostra.                                                                                                                                                                                                                                                                                                                                          |
| Carousel            | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra has not completed multi-image card publication, ad assignment, and Carousel readback. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                                     |
| Collection          | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra has not completed the hero, product-tile, catalog-linkage, assignment, and Collection readback workflow. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                  |
| Idea Pin            | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra has not completed multi-page image and video publication, assignment, and Idea Pin readback. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                              |
| Showcase            | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra has not completed Showcase card and feature publication, assignment, eligibility checks, and readback. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                    |
| Quiz                | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | Apostra has not completed question, answer, result-card publication, account eligibility checks, assignment, and Quiz readback. Current boundary: Apostra implementation/testing.                                                                                                                                                                                   |
| Promoted Offerings  | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | This is an Apostra orchestration format. The per-offering Pin selection, ad-group expansion, assignment, and readback workflow is not complete. Current boundary: Apostra implementation/testing.                                                                                                                                                                   |
| Generated Image 2x3 | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | This is an Apostra-generated format, not a separate Pinterest ad type. Apostra 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: Apostra implementation/testing. |
| Generated Video     | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | This is an Apostra-generated format, not a separate Pinterest ad type. Apostra has not completed video generation, Pin publication, ad assignment, and readback. Current boundary: Apostra implementation/testing.                                                                                                                                                  |
| Generated Offerings | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-4032 | This is an Apostra-generated format, not a separate Pinterest ad type. Apostra has not completed per-offering generation, Pin publication, ad-group assignment, and readback. Current boundary: Apostra implementation/testing.                                                                                                                                     |

## What the adapter can do

| Feature                | Availability | References                                                                            | Comments                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------- | ------------ | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List Accounts          | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Authorized ad-account discovery                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Sync Accounts          | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Account synchronization is not implemented. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Get Products           | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Lists seven available campaign products and two products Apostra does not currently offer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Sync Creatives         | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | 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](https://developers.pinterest.com/docs/api/v5/)           | 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](https://developers.pinterest.com/docs/api/v5/)           | 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. Apostra 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](https://developers.pinterest.com/docs/api/v5/)           | Campaign → ad group → ad                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Get Media Buys         | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Campaign hierarchy and targeting provenance                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Update Media Buy       | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Lifecycle, budget, bid, geography, audiences, and creative assignment updates with readback                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Get Media Buy Delivery | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Campaign and ad-group analytics                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Get Signals            | 🟢 Available | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)           | Audience and interest discovery                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Sync Audiences         | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Apostra has not made customer-list audience syncing publicly available while it completes the account-bound lifecycle and deletion safeguards. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Sync Event Sources     | 🟡 Partial   | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Apostra 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: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Log Event              | ⚪ Planned    | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Apostra 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: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Sync Catalogs          | 🟡 Partial   | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Registers a Pinterest catalog feed URL through POST /catalogs/feeds and the local store; inline item push is not implemented. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Get Account Financials | 🟡 Partial   | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Campaign spend totals are available; the newer account-financials path is not yet connected. Current boundary: Apostra implementation/testing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

## Placement choices

| Feature        | Availability | References                                                                            | Comments                                                                                                                                                 |
| -------------- | ------------ | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pinterest Feed | 🟡 Partial   | [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/) · AI-1941 | Apostra sends all eligible Pinterest placements together; it does not expose a per-placement selector. Current boundary: Apostra implementation/testing. |

## Targeting

| Feature          | Availability | References                                                                                                                          | Comments                                                                                                                                                   |
| ---------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Geo Countries    | 🟢 Available | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)           | Available through Apostra.                                                                                                                                 |
| Geo Regions      | 🟢 Available | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)           | Available through Apostra.                                                                                                                                 |
| Audience Include | ⚪ Planned    | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/) · AI-1941 | Apostra does not yet offer customer-list audience inclusion for Pinterest campaigns. Current boundary: Apostra implementation/testing.                     |
| Audience Exclude | ⚪ Planned    | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/) · AI-1941 | Apostra does not yet offer customer-list audience exclusion for Pinterest campaigns. Current boundary: Apostra implementation/testing.                     |
| Signals          | 🟢 Available | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)           | Available through Apostra.                                                                                                                                 |
| Frequency Cap    | 🟢 Available | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)           | Available through Apostra.                                                                                                                                 |
| Placement Refs   | 🟡 Partial   | [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/) · AI-1941 | Apostra does not expose individual Pinterest placement selection; campaigns use all eligible placements. Current boundary: Apostra implementation/testing. |

## Reporting

Apostra 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](/v2/guides/reporting-overview) for the full model. Apostra 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](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Campaign and ad-group totals                        |
| Clicks          | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Campaign and ad-group totals                        |
| Spend           | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Provider micro-currency converted exactly           |
| Ctr             | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Calculated from raw provider values                 |
| Views           | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Video-view campaigns                                |
| By Package      | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | AdCP package projection                             |
| By Catalog Item | 🟢 Available | [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/) | Returned when the package has catalog-item identity |

## Webhooks and async lifecycle

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

* **Status.** Apostra 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.** Apostra 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 Apostra's own buyer webhook subscriptions — an unrelated account-level event feed (currently `discovery.revision` only), documented in [Buyer webhooks](/v2/buyer/webhooks).

## Market and account availability

Apostra 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

* **Apostra implementation/testing.** Catalog Sales and Idea Pins are not available through Apostra because their end-to-end creation workflows are incomplete.
* **Apostra implementation/testing.** Promoting an existing Pin is still being tested and is not generally available.
* **Apostra 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.
* **Apostra 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.
* **Apostra implementation/testing.** Apostra 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.
* **Apostra implementation/testing.** Catalog sync accepts feed URLs but does not push inline catalog items.
* **Apostra 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
Apostra can do with Pinterest Ads; see the tables above for that.

<AccordionGroup>
  <Accordion title="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`     |
  </Accordion>

  <Accordion title="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        |
  </Accordion>

  <Accordion title="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`                        |
  </Accordion>

  <Accordion title="Reporting field mapping">
    | Apostra 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`                |
  </Accordion>
</AccordionGroup>

## Provider documentation

* [Pinterest Ads API overview](https://developers.pinterest.com/docs/api/v5/)
* [Pinterest campaigns and ad groups](https://developers.pinterest.com/docs/work-with-ads/create-campaigns-and-ad-groups/)
* [Pinterest ads](https://developers.pinterest.com/docs/work-with-ads/create-ads/)
* [Pinterest shareable ad previews](https://developers.pinterest.com/docs/work-with-ads/generate-shareable-ad-previews/)
* [Pinterest targeting](https://developers.pinterest.com/docs/work-with-targets-and-audiences/set-up-targets-for-your-ads/)
* [Pinterest analytics](https://developers.pinterest.com/docs/work-with-analytics/overview/)
