> ## 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 Single Image Ad > Creates new Meta ads using single image creative assets Creates new Meta ads using single image creative assets. By default it creates the full ad. It can also run in creative-only mode, which returns a creative\_id without attaching it to an ad; that creative\_id can then be used with meta\_ads\_replace\_ad\_creative. It also supports detailed-results mode: by default the response returns only IDs, while return\_detailed\_results=true returns per-row success and failure details. Detailed results are recommended for AI agents. | | | | --------------------- | --------------------------------- | | **App** | Meta Ads | | **Operation ID** | `meta_ads_create_single_image_ad` | | **Type** | Action | | **Connection** | `meta_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 the Meta Ads account, ask the user for it if not provided | | `update_type` | string or SelectableOption | Yes | - | Choose how to create ads. Available options: 'single' (one ad with one image, one headline, one primary text), 'bulk' (one or many ads from structured\_data). Bulk unlocks features the single form does not have: multiple headlines and primary texts (headline\_1-5, primary\_text\_1-5), placement-specific images (story, right column), lead forms (form\_id), pixel\_id, ad scheduling (ad\_start\_time/ad\_end\_time), and sitelinks. Use bulk when an ad needs any of these. | | `page` | string or SelectItem | Yes | - | Select Facebook page, ask the user for it if not provided | | `instagram_user_id` | string or SelectItem | No | - | Optional Instagram account override. Leave empty in nearly all cases — the Instagram account linked to the selected Page is used automatically. Only set this when the user wants to advertise with a different Instagram account they have access to. Value is the numeric IG user/business account id. | | `adset_id` | string or SelectItem | No | - | Select the ad set for this ad, ask the user for it if not provided | | `ad_name` | string | No | - | Name of the ad | | `ad_status` | string or SelectableOption | No | - | Select the new status for the ad. Available options: 'ACTIVE', 'PAUSED' | | `image_url` | string | No | - | Image to use for the ad. Accepts a direct image URL or a Google Drive share link. If a Drive link is provided, Markifact automatically converts it to a direct image URL. The only requirement is that the file sharing is set to 'Anyone with the link'. For placement-specific images (story, right column), use bulk mode. | | `primary_text` | string | No | - | The main body text of the ad. For multiple text variations, use bulk mode (primary\_text\_1-5 columns). | | `headline` | string | No | - | The headline of the ad. For multiple headline variations, use bulk mode (headline\_1-5 columns). | | `description` | string | No | - | Additional text that appears below the headline | | `website_url` | string | No | - | The URL where people will go when they click your ad (e.g., `https://example.com`) | | `call_to_action` | string or SelectableOption | No | - | Select a call to action button for the ad: Some Options: 'LEARN\_MORE', 'SHOP\_NOW', 'BOOK\_TRAVEL', 'DOWNLOAD', 'GET\_QUOTE', 'CONTACT\_US', 'APPLY\_NOW', 'SIGN\_UP' | | `url_parameters` | string | No | - | Add UTM or other tracking parameters to your URL (e.g., utm\_source=facebook\&utm\_medium=cpc) | | `disable_creative_enhancements` | boolean | No | - | Set to True to disable Meta's automatic creative enhancements (image templates, touchups, text optimizations, dynamic media etc.). | | `disable_multi_advertiser_ads` | boolean | No | - | Set to True to opt out of Meta's multi-advertiser ads feature, which shows your ad alongside other ads. By default, Meta enables this feature. | | `display_url` | string | No | - | A custom display URL shown on the ad instead of the actual website URL (e.g., 'example.com'). This is cosmetic only and does not affect the landing page. | | `creative_only` | boolean | No | `False` | Set to true to create only the Meta ad creative without creating an ad. Useful when editing an existing ad: create a new creative with the updated text, URL, image, video, or carousel payload, then attach it using replace\_ad\_creative. When true, adset\_id is not required since you're not creating a new ad, just an ad creative. Returns creative IDs instead of ad IDs. Default is false. | | `return_detailed_results` | boolean | No | `False` | Bulk mode only. If true, returns per-row results (success\_count, failed\_count, total\_count, results\[]) and does NOT raise an error on partial failures so the workflow can continue. If false (default), returns a simple summary and raises an error if any row fails. | | `structured_data` | array (also accepts a comma-separated string) | No | - | Use only when update\_type is 'bulk'. Supports multiple images with clear naming: 'image\_url' or 'default\_image\_url' (all placements), 'story\_image\_url' (story placements), 'right\_column\_image\_url' (right column placements). Also supports multiple text variations (headline\_1-5, primary\_text\_1-5) and single 'description' field. For lead form ads, include 'form\_id' field. Optional: 'disable\_creative\_enhancements' (set to True to disable Meta's automatic creative optimizations), 'disable\_multi\_advertiser\_ads' (set to True to opt out of showing your ad alongside other ads), 'pixel\_id' (optional, leave empty to inherit from adset and account), 'display\_url' (optional, a custom display URL shown on the ad instead of the actual website URL, e.g. 'example.com'), 'ad\_start\_time' and 'ad\_end\_time' (schedule individual ads, format: YYYY-MM-DD HH:MM or YYYY-MM-DD, uses ad account timezone; only works for sales and app promotion campaigns). Optional sitelinks (bulk only): leave all 'sitelink\_\*' columns blank to skip the feature. To use sitelinks, Meta requires between 4 and 20 per ad. For each one, fill in 'sitelink\_N\_title' and 'sitelink\_N\_url' (N = 1..20); 'sitelink\_N\_image\_url' is optional and accepts a direct URL or Google Drive share link. If 'sitelink\_1\_title' starts with the word 'Optional' (i.e. the template's instruction text was not cleared), all sitelinks are skipped for that row. Suggest this template for user: `https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=0#gid=0` | ### 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 ad details, a list of ad IDs and count. **Fields**: `ad_ids`, `created_count`