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

> Create a Search or Performance Max campaign in Microsoft Ads

Create a Search or Performance Max campaign in Microsoft Ads.

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

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account to create a campaign in. |
| `campaign_name` | string | Yes | - | Name for the new campaign. |
| `campaign_type` | string or SelectableOption | Yes | - | Campaign type. Supported values: Search, PerformanceMax, or Shopping. Shopping campaigns (standard shopping) also require store\_id and support shopping\_priority and sales\_country\_code. |
| `status` | string or SelectableOption | No | `{'value': 'PAUSED', 'label': 'Paused'}` | Initial campaign status. Default: PAUSED. |
| `daily_budget` | number | Yes | - | Daily budget in the account currency, for example 50 for \$50. |
| `locations` | string or array of string or integer or SelectableOption | Yes | - | Microsoft Ads location IDs to target. Pass a comma/newline-separated string or a list. Use `microsoft_ads_search_locations` to find IDs. |
| `languages` | string or array of string or SelectableOption | No | `['All']` | Campaign ad languages. Use Microsoft language names such as English, Arabic, or All. Default: All. |
| `bidding_strategy_type` | string or SelectableOption | No | `{'value': 'MaxConversionsBiddingScheme', 'label': 'Maximize Conversions'}` | Bidding strategy for the campaign. |
| `max_cpc` | number or string | No | - | Maximum CPC cap in account currency. Optional for MaxClicks, MaxConversions, MaxConversionValue, and TargetImpressionShare. |
| `target_cpa` | number or string | No | - | Optional target CPA in account currency. Used by MaxConversions. |
| `target_roas` | number or string | No | - | Optional target ROAS multiplier, for example 3.5 for 350%. Used by MaxConversionValue. |
| `target_ad_position` | string or SelectableOption | No | - | Target ad position for TargetImpressionShare. |
| `target_impression_share` | number or string | No | - | Target impression share percentage, 1 to 100. Used by TargetImpressionShare. |
| `goal_ids` | string or array of string or integer | No | - | Optional Microsoft Ads conversion goal IDs. Recommended when using MaxConversions or MaxConversionValue bidding. |
| `store_id` | integer or string | No | - | Microsoft Merchant Center store ID. Required when campaign\_type is Shopping and immutable after creation. Find it in the Microsoft Advertising UI under Tools > Microsoft Merchant Center. |
| `shopping_priority` | integer or string | No | - | Shopping campaigns only. Priority when multiple campaigns use the same store: 0 (low, default), 1 (medium), or 2 (high). |
| `sales_country_code` | string | No | - | Shopping campaigns only. Optional 2-letter country code that filters the store catalog, for example US or GB. Immutable after creation. |
| `geo_target_type` | string or SelectableOption | No | `{'value': 'PRESENCE_OR_INTEREST', 'label': 'Presence or Interest'}` | Location intent option. Default: PRESENCE\_OR\_INTEREST. |
| `start_date` | integer or string | No | - | Optional campaign start date as YYYY-MM-DD or Unix timestamp. |
| `end_date` | integer or string | No | - | Optional campaign end date as YYYY-MM-DD or Unix timestamp. |
| `final_url_expansion_opt_out` | boolean | No | `True` | If false, Microsoft can expand final URLs automatically. Default: true. |
| `auto_generated_image_opt_out` | boolean | No | `True` | If false, Microsoft can generate image assets automatically. Default: true. |
| `auto_generated_text_opt_out` | boolean | No | `True` | If false, Microsoft can generate and customize text assets automatically. Default: true. |
| `ai_search_enabled` | boolean | No | `False` | Search campaigns only. Whether to enable AI Max or not. Default: false. |
| `search_term_matching_opt_out` | boolean | No | `True` | Search campaigns only. If false, Microsoft can use AI search term matching. Default: true. |

### MicrosoftAdsAccountItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |
| `customerId` | string | No | - | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the created Microsoft Ads campaign and location targeting results.

**Fields**: `campaign_id`, `campaign_name`, `campaign_type`, `status`, `daily_budget`, `location_targets`


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