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

> Create a SearchStandard Microsoft Ads ad group inside an existing campaign

Create a SearchStandard Microsoft Ads ad group inside an existing campaign. Supports initial status, network, language, and optional CPC bid.

|                       |                                 |
| --------------------- | ------------------------------- |
| **App**               | Microsoft Ads                   |
| **Operation ID**      | `microsoft_ads_create_ad_group` |
| **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 an ad group in.                                                                                                                                                                                                             |
| `campaign_id`   | string or SelectItem                                                      | Yes      | -                                     | Select the campaign to create the ad group in.                                                                                                                                                                                                                         |
| `ad_group_name` | string                                                                    | Yes      | -                                     | Name for the new ad group.                                                                                                                                                                                                                                             |
| `status`        | string or SelectableOption                                                | No       | `PAUSED`                              | Initial ad group status. Default: PAUSED.                                                                                                                                                                                                                              |
| `ad_group_type` | string or SelectableOption                                                | No       | `SearchStandard`                      | Ad group type. Use SearchStandard (default) for ad groups in Search campaigns, or Shopping for ad groups in Shopping campaigns. Microsoft does not accept an explicit type for Shopping ad groups, so choosing Shopping omits the type and the campaign determines it. |
| `cpc_bid`       | number or string                                                          | No       | -                                     | Optional max CPC bid in the account currency, for example 2.5.                                                                                                                                                                                                         |
| `language`      | string or SelectableOption                                                | No       | -                                     | Optional ad group language. If omitted, Microsoft uses campaign-level languages when available. Example: English or Arabic.                                                                                                                                            |
| `network`       | string or SelectableOption                                                | No       | `OwnedAndOperatedAndSyndicatedSearch` | Optional search network. Default: OwnedAndOperatedAndSyndicatedSearch.                                                                                                                                                                                                 |

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

### 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 the created Microsoft Ads ad group.

**Fields**: `ad_group_id`, `ad_group_name`, `campaign_id`, `status`, `ad_group_type`, `network`, `language`