---
title: "Create ad preview with pin or image"
method: POST
path: "/ad_accounts/{ad_account_id}/ad_previews"
tags: ["ads"]
---

# Create ad preview with pin or image

`POST /ad_accounts/{ad_account_id}/ad_previews`

Create an ad preview given an ad account ID and either an existing organic pin ID or the URL for an image to be used to create the Pin and the ad.

If you are creating a preview from an existing Pin, that Pin must be promotable: that is, it must have a clickthrough link and meet other requirements. (See [Ads Overview](https://help.pinterest.com/en/business/article/promoted-pins-overview).)

You can view the returned preview URL on a webpage or iframe for 7 days, after which the URL expires. Collection ads are not currently supported ad preview.

## Path parameters

- `ad_account_id` string, required

## Request body

- union
  - AdPreviewSourceImage — Ad preview source from an image URL.
    - `image_url` string, required — Image URL.
    - `promotion_id` string — Promotion id for the ad to preview, optional and only applicable when creating ad preview for an existing promotion.
    - `title` string, required — Title displayed below ad.
  - AdPreviewSourcePinId — Ad preview source from an existing Pin.
    - `creative_type` 'SHOPPING' | 'COLLECTION' | 'MAX_VIDEO' | 'MAX_WIDTH_VIDEO_COLLECTION' | 'MAX_WIDTH_REGULAR_COLLECTION'
    - `pin_id` string, required — Pin ID.
  - AdPreviewShopping — Ad preview from a catalog product group (shopping).
    - `catalog_product_group_id` string, required — Catalog Product Group Id.
    - `creative_type` 'SHOPPING' | 'COLLECTION' | 'CAROUSEL' | 'MAX_WIDTH_COLLECTION', required
    - `customizable_cta_type` 'GET_OFFER' | 'LEARN_MORE' | 'ORDER_NOW' | 'SHOP_NOW' | 'SIGN_UP' | 'SUBSCRIBE' | 'BUY_NOW' | 'CONTACT_US' | 'GET_QUOTE' | 'VISIT_SITE' | 'APPLY_NOW' | 'BOOK_NOW' | 'REQUEST_DEMO' | 'REGISTER_NOW' | 'FIND_A_DEALER' | 'ADD_TO_CART' | 'WATCH_NOW' | 'READ_MORE' | 'BUY_TICKETS' | 'DONATE_NOW' | 'DOWNLOAD' | 'EXPLORE_MORE' | 'FIND_A_LOCATION' | 'FIND_RETAILERS' | 'GET_DEAL' | 'GET_RECIPE' | 'GET_SHOWTIMES' | 'ON_SALE' | 'PLAY_GAME' | 'TRY_IT' | 'TAKE_A_PEEK' | 'null', nullable — Select a call to action (CTA) to display below your ad. Available only for ads with direct links enabled. CTA options for consideration and conversion campaigns are LEARN_MORE, SHOP_NOW, BOOK_NOW, SIGN_UP, VISIT_SITE, BUY_NOW, GET_OFFER, ORDER_NOW, ADD_TO_CART (for conversion campaigns with add to cart conversion events only)
    - `hero_image_title` string — Title displayed below ad.
    - `hero_image_url` string — Hero image URL.
    - `hero_pin_id` string — Pin id for the hero image. When creative type is COLLECTION, either hero_pin_id or (hero_image_url, hero_image_title) is required.
    - `image_tag` string — Multi image template tag.
    - `item_id` string — Item id for product to preview standard shopping ads, optional and only applicable when creative type is SHOPPING.
    - `preferred_media_type` 'VIDEO' | 'IMAGE'
    - `show_promotion` boolean — Include promotion data in preview when available on catalog item. Defaults to false.
    - `video_tag` string — Multi video template tag, image_tag and video_tag are mutual exclusive.

## Response `200`

The request has succeeded.

- AdPreviewURLResponse
  - `url` string — Preview URL, expires in 7 days. Can be used in an iframe. For example: https://ads.pinterest.com/ad-preview/74667c814dd2b19/ The preview object ID/key is the last param - 74667c814dd2b19

## Other responses

- `201` — Resource create operation completed successfully.
- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)