---
title: "Changes to Create ad preview with pin or image"
method: POST
path: "/ad_accounts/{ad_account_id}/ad_previews"
---

# Changes to Create ad preview with pin or image

`POST /ad_accounts/{ad_account_id}/ad_previews`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a`: 1 breaking, 6 info
- **2025-10-16** (v5) `14c297539b64`: 8 breaking, 1 info
- **2025-08-12** (v5) `8fb7ab040159`: 2 info
- **2025-07-16** (v5) `43134ca41f18`: 1 info
- **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking
- **2022-09-07** (v5) `bd20b6eb152f`: 1 warning
- **2022-07-11** (v5) `0d5998752011`: 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a`: 1 breaking, 6 info
  - removed `subschema #1: AdPreviewCreateFromImage, subschema #2: AdPreviewCreateFromPin, subschema #3: AdPreviewShopping` from the request body `oneOf` list
  - added `#/components/schemas/AdPreviewSourceImage, #/components/schemas/AdPreviewSourcePinId, #/components/schemas/AdPreviewShopping` to the request body `oneOf` list
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the success response with the status `201`
- **2025-10-16** (v5) `14c297539b64`: 8 breaking, 1 info
  - added `#/components/schemas/CustomizableCTAType, subschema #2` to the `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type` request property `allOf` list
  - the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type` became not nullable
  - removed the enum value `BOOK_NOW` of the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type`
  - removed the enum value `GET_DEAL` of the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type`
  - removed the enum value `ON_SALE` of the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type`
  - removed the enum value `SHOP_NOW` of the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type`
  - removed the enum value `undefined` of the request property `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type`
  - the `oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type` request property type changed from `string` to no type
  - added the new `REGULAR` enum value to the request property `oneOf[subschema #3: AdPreviewShopping]/creative_type`
- **2025-08-12** (v5) `8fb7ab040159`: 2 info
  - added the new optional request property `oneOf[subschema #3: AdPreviewShopping]/preferred_media_type`
  - added the new optional request property `oneOf[subschema #3: AdPreviewShopping]/video_tag`
- **2025-07-16** (v5) `43134ca41f18`: 1 info
  - added `subschema #3: AdPreviewShopping` to the request body `oneOf` list
- **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking
  - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18`
- **2022-09-07** (v5) `bd20b6eb152f`: 1 warning
  - for the `path` request parameter `ad_account_id`, the maxLength was set to `19`
- **2022-07-11** (v5) `0d5998752011`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ad_previews/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/ad_previews/post)