> ## 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. Only SearchStandard is supported in this operation.                                                          |
| `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`