| 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
