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

# Create Ad

> Advanced: creates a Pinterest ad from a raw ad payload sent to Pinterest as-is

Advanced: creates a Pinterest ad from a raw ad payload sent to Pinterest as-is. Use the dedicated operations first (pinterest\_ads\_create\_single\_image\_ad, pinterest\_ads\_create\_video\_ad, pinterest\_ads\_create\_carousel\_ad, pinterest\_ads\_create\_ad\_from\_pin); use this only for ad formats or fields they do not support, such as MAX\_VIDEO, COLLECTION, QUIZ, or grid\_click\_type. To get a pin\_id for new media, run a dedicated create operation with pin\_only=true first.

| | |
| - | - |
| **App** | Pinterest Ads |
| **Operation ID** | `pinterest_ads_create_ad` |
| **Type** | Action |
| **Connection** | `pinterest_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | DynamicAccount | Yes | - | Select Pinterest Ads account to create the ad in. |
| `ad_payload` | object or string | Yes | - | Advanced: raw Pinterest ad payload as a JSON object, sent to Pinterest as-is (POST /ad\_accounts/\{id}/ads). Required keys: ad\_group\_id, pin\_id, and creative\_type (REGULAR, VIDEO, MAX\_VIDEO, CAROUSEL, COLLECTION, SHOWCASE, QUIZ, COLLAGE, IDEA, SHOPPING). To get a pin\_id for new media, run pinterest\_ads\_create\_single\_image\_ad, pinterest\_ads\_create\_video\_ad, or pinterest\_ads\_create\_carousel\_ad with pin\_only=true. Common optional keys: name, status (ACTIVE/PAUSED, Pinterest defaults to ACTIVE), destination\_url, customizable\_cta\_type, is\_removable, lead\_form\_id, grid\_click\_type, is\_dynamic\_cta (bool) with cta\_types (array of at least two from ADD\_TO\_CART, BUY\_NOW, CONTACT\_US, EXPLORE\_MORE, GET\_OFFER, LEARN\_MORE, ORDER\_NOW, SHOP\_NOW, TAKE\_A\_PEEK, VISIT\_SITE, and it must include the objective's default CTA, VISIT\_SITE for CONSIDERATION) to let Pinterest pick the CTA per placement and device instead of customizable\_cta\_type, carousel\_destination\_urls / carousel\_android\_deep\_links / carousel\_ios\_deep\_links (arrays, one entry per card), android\_deep\_link, ios\_deep\_link, click\_tracking\_url, view\_tracking\_url, disclosure\_type and disclosure\_url (pharma), is\_carting, quiz\_pin\_data (for QUIZ ads). Example: \{"ad\_group\_id": "2680059592705", "pin\_id": "813744226420795884", "creative\_type": "MAX\_VIDEO", "name": "Max width video", "status": "PAUSED"} |

## Output

**Type**: `Dict`

Returns the created Pinterest ad ID and payload identifiers.

**Fields**: `ad_id`, `ad_group_id`, `pin_id`, `creative_type`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.