> ## 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 From Pin

> Promotes an existing Pinterest Pin as an ad in an ad group

Promotes an existing Pinterest Pin as an ad in an ad group. Detects the right creative type from the Pin's media unless one is provided. This operation does not upload media or create Pins; to create an ad from new media use pinterest\_ads\_create\_single\_image\_ad, pinterest\_ads\_create\_video\_ad, or pinterest\_ads\_create\_carousel\_ad instead.

|                       |                                    |
| --------------------- | ---------------------------------- |
| **App**               | Pinterest Ads                      |
| **Operation ID**      | `pinterest_ads_create_ad_from_pin` |
| **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.                                                                                                                                                                                                                          |
| `update_type`             | string or SelectableOption                    | Yes      | -                                        | Choose whether to promote a single Pin or multiple Pins at once. Options: single or bulk.                                                                                                                                                                                  |
| `ad_group_id`             | string or SelectItem                          | No       | -                                        | Pinterest ad group ID to create the ad under.                                                                                                                                                                                                                              |
| `pin_id`                  | string                                        | No       | -                                        | ID of the existing Pin to promote.                                                                                                                                                                                                                                         |
| `ad_name`                 | string                                        | No       | -                                        | Name of the Pinterest ad.                                                                                                                                                                                                                                                  |
| `ad_status`               | string or SelectableOption                    | No       | `{'value': 'PAUSED', 'label': 'Paused'}` | Status when the ad is created. Options: ACTIVE or PAUSED. Default: PAUSED.                                                                                                                                                                                                 |
| `creative_type`           | string or SelectableOption                    | No       | -                                        | Optional ad creative type. Omit to let Markifact detect it from the Pin's media (image Pin: REGULAR, video Pin: VIDEO, carousel Pin: CAROUSEL). Set it explicitly only for special formats such as MAX\_VIDEO, COLLECTION, or IDEA.                                        |
| `destination_url`         | string                                        | No       | -                                        | Optional landing page URL override for the ad click-through. Defaults to the Pin's link.                                                                                                                                                                                   |
| `call_to_action`          | string or SelectableOption                    | No       | -                                        | Optional Pinterest customizable CTA type, for example LEARN\_MORE, SHOP\_NOW, SIGN\_UP.                                                                                                                                                                                    |
| `lead_form_id`            | string                                        | No       | -                                        | Optional Pinterest lead form ID to create a lead ad.                                                                                                                                                                                                                       |
| `click_tracking_url`      | string                                        | No       | -                                        | Optional third-party click tracking URL.                                                                                                                                                                                                                                   |
| `view_tracking_url`       | string                                        | No       | -                                        | Optional third-party impression tracking URL.                                                                                                                                                                                                                              |
| `android_deep_link`       | string                                        | No       | -                                        | Optional Android deep link URL.                                                                                                                                                                                                                                            |
| `ios_deep_link`           | string                                        | No       | -                                        | Optional iOS deep link URL.                                                                                                                                                                                                                                                |
| `return_detailed_results` | boolean                                       | No       | `False`                                  | Bulk mode only. If true, returns per-row results and does not raise on partial failures.                                                                                                                                                                                   |
| `structured_data`         | array (also accepts a comma-separated string) | No       | -                                        | Use only when update\_type is bulk. Required columns: pin\_id, ad\_group\_id, ad\_name. Optional columns: ad\_status, creative\_type, destination\_url, call\_to\_action, lead\_form\_id, click\_tracking\_url, view\_tracking\_url, android\_deep\_link, ios\_deep\_link. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns created Pinterest ad IDs.

**Fields**: `ad_ids`, `created_count`