> ## 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 or PerformanceMax.                                                                               |
| `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.                         |
| `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`