> ## 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 Post

> Creates TikTok ads from existing posts using Spark post item IDs

Creates TikTok ads from existing posts using Spark post item IDs. supports all campaign types: manual, smart+, search, etc.

|                       |                                  |
| --------------------- | -------------------------------- |
| **App**               | TikTok Ads                       |
| **Operation ID**      | `tiktok_ads_create_ad_from_post` |
| **Type**              | Action                           |
| **Connection**        | `tiktok_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 TikTok Ads account (advertiser) to create ads in                                                                                                                                                                                                                                                                                                                              |
| `update_type`                   | string or SelectableOption                    | Yes      | -       | Choose whether to create a single ad or multiple ads at once. Options: 'single' or 'bulk'                                                                                                                                                                                                                                                                                            |
| `ad_group_id`                   | string or SelectItem                          | No       | -       | Select the TikTok ad group for this ad. Required for single ad creation.                                                                                                                                                                                                                                                                                                             |
| `identity_id`                   | string or SelectItem                          | Yes      | -       | TikTok identity ID to use for the ads. Required for single and bulk ad creation. For this post ad operation, use a TikTok account identity (TT\_USER) or a Business Center authorized TikTok identity (BC\_AUTH\_TT). Only provide the id, Markifact resolves the type automatically. Use the `tiktok_ads_list_identities` operation to find identity IDs user has access to.        |
| `ad_name`                       | string                                        | No       | -       | Name of the ad                                                                                                                                                                                                                                                                                                                                                                       |
| `post_ids`                      | string or array of string                     | No       | -       | Existing TikTok post IDs to use for this ad. Manual ad groups support 1 post; Smart+ ad groups support up to 50 post creatives.                                                                                                                                                                                                                                                      |
| `call_to_action`                | string or SelectableOption                    | No       | -       | Optional TikTok call to action, for example LEARN\_MORE, SHOP\_NOW, SIGN\_UP, CONTACT\_US, DOWNLOAD.                                                                                                                                                                                                                                                                                 |
| `landing_page_url`              | string                                        | No       | -       | Landing page URL people open after clicking the ad. You can include UTM parameters, for example ?utm\_source=tiktok\&utm\_id=**CAMPAIGN\_ID**\&utm\_campaign=**CAMPAIGN\_NAME**\&utm\_medium=paid. For app download campaigns, provide the app store URL. Optional when page\_id is provided.                                                                                        |
| `page_id`                       | string                                        | No       | -       | Optional TikTok page ID, such as an instant page, lead form, or other TikTok-hosted page. When provided, landing\_page\_url is optional and will not be sent to TikTok. Use the `tiktok_ads_list_pages` operation to find page IDs of any account.                                                                                                                                   |
| `tracking_pixel_id`             | integer or string                             | No       | -       | Optional TikTok tracking pixel ID. Usually inherited from the ad group for supported objectives; provide it manually if needed.                                                                                                                                                                                                                                                      |
| `tracking_app_id`               | string                                        | No       | -       | Optional TikTok tracking app ID. Usually inherited from the ad group for supported objectives; provide it manually if needed.                                                                                                                                                                                                                                                        |
| `disable_creative_enhancements` | boolean                                       | No       | `True`  | Single mode only. Disable TikTok automatic creative enhancements. Default: true.                                                                                                                                                                                                                                                                                                     |
| `ad_status`                     | string or SelectableOption                    | No       | -       | Status when the ad is created. Options: ENABLE, DISABLE. Default: DISABLE.                                                                                                                                                                                                                                                                                                           |
| `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: ad\_group\_id, ad\_name, landing\_page\_url or page\_id, and posts. Posts can be provided as post\_ids lists or numbered columns like post\_1\_id, post\_2\_id. Optional row columns: page\_id, call\_to\_action, tracking\_pixel\_id, tracking\_app\_id, disable\_creative\_enhancements, ad\_status, or operation\_status. |

### 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 TikTok ad IDs, source post IDs, created count, and per-row results in detailed bulk mode.

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