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

> Create callout ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

Create callout ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

|                       |                                 |
| --------------------- | ------------------------------- |
| **App**               | Microsoft Ads                   |
| **Operation ID**      | `microsoft_ads_create_callouts` |
| **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, ask user for it if not provided                          |
| `level`         | string or SelectableOption                                                | Yes      | -       | Choose where to attach the callouts. Available options: 'ACCOUNT', 'CAMPAIGN', 'AD\_GROUP' |
| `campaign_ids`  | array of string or SelectItem                                             | No       | -       | Select one or more campaigns to attach the callouts (required if level is CAMPAIGN)        |
| `ad_group_ids`  | array of string or SelectItem                                             | No       | -       | Select one or more ad groups to attach the callouts (required if level is AD\_GROUP)       |
| `callout_texts` | array of string                                                           | Yes      | -       | List of callout texts. Each callout must be max 25 characters.                             |
| `start_date`    | integer or string                                                         | No       | -       | Start date for when the callouts can begin serving (Unix timestamp or YYYY-MM-DD format)   |
| `end_date`      | integer or string                                                         | No       | -       | End date for when the callouts stop serving (Unix timestamp or YYYY-MM-DD format)          |

### 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 created callouts details.

**Fields**: `callout_ids`, `callouts_created`