> ## 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**   | 2                          |
| **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, 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`