> ## 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 Structured Snippets

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

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

|                       |                                            |
| --------------------- | ------------------------------------------ |
| **App**               | Microsoft Ads                              |
| **Operation ID**      | `microsoft_ads_create_structured_snippets` |
| **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 structured snippet. Available options: 'ACCOUNT', 'CAMPAIGN', 'AD\_GROUP'                                                                                                                                             |
| `campaign_ids` | array of string or SelectItem                                             | No       | -       | Select one or more campaigns to attach the structured snippet (required if level is CAMPAIGN)                                                                                                                                                    |
| `ad_group_ids` | array of string or SelectItem                                             | No       | -       | Select one or more ad groups to attach the structured snippet (required if level is AD\_GROUP)                                                                                                                                                   |
| `header`       | string or SelectableOption                                                | Yes      | -       | The header for the structured snippet. Available options: 'Amenities', 'Brands', 'Courses', 'Degree programs', 'Destinations', 'Featured hotels', 'Insurance coverage', 'Models', 'Neighborhoods', 'Service catalog', 'Shows', 'Styles', 'Types' |
| `values`       | array of string                                                           | Yes      | -       | List of snippet values. Must have 3-10 values, each max 25 characters.                                                                                                                                                                           |
| `start_date`   | integer or string                                                         | No       | -       | Start date for when the structured snippet can begin serving (Unix timestamp or YYYY-MM-DD format)                                                                                                                                               |
| `end_date`     | integer or string                                                         | No       | -       | End date for when the structured snippet stops 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 structured snippet details.

**Fields**: `structured_snippet_id`, `links_created`