# Bing Ads

Source: https://pilot.braike.com/en/docs/regies/bing-ads

The 57 tools Pilot MCP serves for Bing Ads: 22 read-only, and 35 that write with the €29 plan, taken from the server.

Pilot MCP serves **22 read-only tools** for Bing Ads, on every plan. With the €29 plan, it also serves **23** that create or change and **12** that delete. Their names start with `bing_ads_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 22 |
| [Create and change (€29)](#modification) | 23 |
| [Delete (€29)](#suppression) | 12 |

## Other tools [#autres]

### `bing_ads_get_account_info` [#bing_ads_get_account_info]

**Microsoft Ads: Get Account Info** · read-only · idempotent

Get detailed information about a specific Microsoft Advertising account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID to retrieve details for. |

### `bing_ads_get_ad_accounts` [#bing_ads_get_ad_accounts]

**Microsoft Ads: Get Ad Accounts** · read-only · idempotent

Search and list Microsoft Advertising accounts accessible by the authenticated user

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | no | Bing Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `bing_ads_get_ad_by_id` [#bing_ads_get_ad_by_id]

**Microsoft Ads: Get Ad by ID** · read-only · idempotent

Get one Microsoft Advertising ad by its ID (ad\_id) and its ad group (ad\_group\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the ad (required by Microsoft). |
| `ad_id` | `string` | yes | The ad ID. |

### `bing_ads_get_ad_group_by_id` [#bing_ads_get_ad_group_by_id]

**Microsoft Ads: Get Ad Group by ID** · read-only · idempotent

Get one Microsoft Advertising ad group by its ID (ad\_group\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID of the ad group (required by Microsoft). |
| `ad_group_id` | `string` | yes | The ad group ID. |

### `bing_ads_get_ad_group_performance` [#bing_ads_get_ad_group_performance]

**Microsoft Ads: Get Ad Group Performance** · read-only · idempotent

Get ad group performance report for a campaign

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID. |
| `date_range` | `string` | yes | Date range: LastSevenDays, LastThirtyDays, LastMonth, ThisMonth, Yesterday, Today. |

### `bing_ads_get_audience` [#bing_ads_get_audience]

**Microsoft Ads: Get Audience** · read-only · idempotent

Get one Microsoft Advertising audience (remarketing list) by its ID (audience\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `audience_id` | `string` | yes | The audience ID. |

### `bing_ads_get_campaign_by_id` [#bing_ads_get_campaign_by_id]

**Microsoft Ads: Get Campaign by ID** · read-only · idempotent

Get one Microsoft Advertising campaign by its ID (campaign\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID to retrieve. |

### `bing_ads_get_campaign_performance` [#bing_ads_get_campaign_performance]

**Microsoft Ads: Get Campaign Performance** · read-only · idempotent

Get campaign performance report (impressions, clicks, cost, conversions)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `date_range` | `string` | yes | Date range: LastSevenDays, LastThirtyDays, LastMonth, ThisMonth, Yesterday, Today. |
| `campaign_id` | `string` | no | Optional campaign ID to filter by. |

### `bing_ads_get_keyword_by_id` [#bing_ads_get_keyword_by_id]

**Microsoft Ads: Get Keyword by ID** · read-only · idempotent

Get one Microsoft Advertising keyword by its ID (keyword\_id) and its ad group (ad\_group\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the keyword (required by Microsoft). |
| `keyword_id` | `string` | yes | The keyword ID. |

### `bing_ads_list_ad_group_audiences` [#bing_ads_list_ad_group_audiences]

**Microsoft Ads: List Ad Group Audiences** · read-only · idempotent

List the audiences targeted in one ad group (ad\_group\_id), of one audience type, or some of them by criterion ID.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | Ad group ID. |
| `audience_type` | `string` | no | Audience type (default RemarketingList, the type list\_audiences returns). Values: `"RemarketingList"`, `"CustomAudience"`, `"InMarketAudience"`, `"ProductAudience"`, `"SimilarRemarketingList"`, `"CombinedList"`, `"CustomerList"`, `"ImpressionBasedRemarketingList"`. Default: `"RemarketingList"`. |
| `criterion_ids` | `string[]` | no | Ad group criterion IDs (omit for all). |

### `bing_ads_list_ad_groups` [#bing_ads_list_ad_groups]

**Microsoft Ads: List Ad Groups** · read-only · idempotent

List all the ad groups of a Microsoft Advertising campaign (campaign\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID. |

### `bing_ads_list_ads` [#bing_ads_list_ads]

**Microsoft Ads: List Ads** · read-only · idempotent

List all the ads of a Microsoft Advertising ad group (ad\_group\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID. |

### `bing_ads_list_audiences` [#bing_ads_list_audiences]

**Microsoft Ads: List Audiences** · read-only · idempotent

List all the audiences (remarketing lists) of a Microsoft Advertising account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |

### `bing_ads_list_budgets` [#bing_ads_list_budgets]

**Microsoft Ads: List Budgets** · read-only · idempotent

List the shared budgets of a Microsoft Advertising account, or some of them by ID (budget\_ids).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `budget_ids` | `string[]` | no | Budget IDs (omit for all). |

### `bing_ads_list_campaigns` [#bing_ads_list_campaigns]

**Microsoft Ads: List Campaigns** · read-only · idempotent

List all campaigns in a Microsoft Advertising account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID to list campaigns for. |

### `bing_ads_list_conversion_goals` [#bing_ads_list_conversion_goals]

**Microsoft Ads: List Conversion Goals** · read-only · idempotent

List the conversion goals of the account (all types), or some of them by ID

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `conversion_goal_ids` | `string[]` | no | Goal IDs (omit for all). |

### `bing_ads_list_extension_associations` [#bing_ads_list_extension_associations]

**Microsoft Ads: List Extension Associations** · read-only · idempotent

List the ad extensions attached to the account, to some campaigns or to some ad groups (entity\_ids).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `association_type` | `string` | yes | What the extensions are attached to. Values: `"Account"`, `"Campaign"`, `"AdGroup"`. |
| `entity_ids` | `string[]` | yes | Account, campaign or ad group IDs. |
| `extension_types` | `string[]` | no | Extension types to filter: Sitelink, Callout, StructuredSnippet, Call (default: these four). |

### `bing_ads_list_extensions` [#bing_ads_list_extensions]

**Microsoft Ads: List Extensions** · read-only · idempotent

List the ad extensions of a Microsoft Advertising account, optionally filtered by extension type.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_types` | `string[]` | no | Extension types to filter: Sitelink, Callout, StructuredSnippet, Call, Location, Price, Action. |
| `extension_ids` | `string[]` | no | Extension IDs to read (omit for all of the given types). |

### `bing_ads_list_keywords` [#bing_ads_list_keywords]

**Microsoft Ads: List Keywords** · read-only · idempotent

List all the keywords of a Microsoft Advertising ad group (ad\_group\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID. |

### `bing_ads_list_label_associations` [#bing_ads_list_label_associations]

**Microsoft Ads: List Label Associations** · read-only · idempotent

List the labels applied to some campaigns, ad groups, ads or keywords (entity\_ids)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | What carries the label. Values: `"Campaign"`, `"AdGroup"`, `"Ad"`, `"Keyword"`. |
| `entity_ids` | `string[]` | yes | Entity IDs. |

### `bing_ads_list_labels` [#bing_ads_list_labels]

**Microsoft Ads: List Labels** · read-only · idempotent

List the labels of the account, or some of them by ID

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `label_ids` | `string[]` | no | Label IDs (omit for all active labels). |

### `bing_ads_list_negative_keywords` [#bing_ads_list_negative_keywords]

**Microsoft Ads: List Negative Keywords** · read-only · idempotent

List the negative keywords of one campaign or one ad group (for an ad group, give its campaign\_id)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | Campaign or AdGroup. Values: `"Campaign"`, `"AdGroup"`. |
| `entity_id` | `string` | yes | Campaign or ad group ID. |
| `campaign_id` | `string` | no | Campaign ID of the ad group (required when entity\_type=AdGroup). |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `bing_ads_add_audience_to_ad_group` [#bing_ads_add_audience_to_ad_group]

**Microsoft Ads: Add Audience to Ad Group** · create or change, €29 plan · creates an object on each call

Target an audience (remarketing list, in-market, custom...) in an ad group, with an optional bid adjustment in percent. Change the adjustment with update\_ad\_group\_audience, stop targeting with remove\_audience\_from\_ad\_group.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | Ad group ID. |
| `audience_id` | `string` | yes | Audience ID (see list\_audiences). |
| `audience_type` | `string` | no | Audience type (default RemarketingList, the type list\_audiences returns). Values: `"RemarketingList"`, `"CustomAudience"`, `"InMarketAudience"`, `"ProductAudience"`, `"SimilarRemarketingList"`, `"CombinedList"`, `"CustomerList"`, `"ImpressionBasedRemarketingList"`. Default: `"RemarketingList"`. |
| `bid_multiplier` | `number` | no | Bid adjustment in percent, -90 to 900 (default 0). |

### `bing_ads_add_negative_keywords` [#bing_ads_add_negative_keywords]

**Microsoft Ads: Add Negative Keywords** · create or change, €29 plan · creates an object on each call

Add negative keywords (Exact or Phrase) to one campaign or one ad group. Microsoft has no operation to change a negative keyword: delete it with delete\_negative\_keyword and add the new text.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | Campaign or AdGroup. Values: `"Campaign"`, `"AdGroup"`. |
| `entity_id` | `string` | yes | Campaign or ad group ID. |
| `campaign_id` | `string` | no | Campaign ID of the ad group (lets Pilot re-read the list; ignored by Microsoft). |
| `keywords` | `object[]` | yes | Negative keywords, 1 to 100. |

### `bing_ads_apply_label` [#bing_ads_apply_label]

**Microsoft Ads: Apply Label** · create or change, €29 plan · creates an object on each call

Apply a label to one campaign, ad group, ad or keyword

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | What carries the label. Values: `"Campaign"`, `"AdGroup"`, `"Ad"`, `"Keyword"`. |
| `entity_id` | `string` | yes | Campaign, ad group, ad or keyword ID. |
| `label_id` | `string` | yes | Label ID. |

### `bing_ads_create_ad` [#bing_ads_create_ad]

**Microsoft Ads: Create Ad** · create or change, €29 plan · creates an object on each call

Create a new Responsive Search Ad in an ad group

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID. |
| `headlines` | `string[]` | yes | Array of headline strings (3-15 headlines). |
| `descriptions` | `string[]` | yes | Array of description strings (2-4 descriptions). |
| `final_urls` | `string[]` | yes | Array of final URL strings. |
| `path1` | `string` | no | Display URL path 1 (optional). |
| `path2` | `string` | no | Display URL path 2 (optional). |
| `status` | `string` | no | Initial status: Paused (default) or Active. Values: `"Active"`, `"Paused"`. Default: `"Paused"`. |

### `bing_ads_create_ad_group` [#bing_ads_create_ad_group]

**Microsoft Ads: Create Ad Group** · create or change, €29 plan · creates an object on each call

Create a new Microsoft Advertising ad group in a campaign, with a name, a CPC bid and an optional status (Active or Paused).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID. |
| `name` | `string` | yes | Ad group name. |
| `cpc_bid` | `number` | yes | CPC bid amount. |
| `status` | `string` | no | Status: Active or Paused. |
| `language` | `string` | no | Ad group language, for example French or English. Required by Microsoft when the campaign has no language. |

### `bing_ads_create_budget` [#bing_ads_create_budget]

**Microsoft Ads: Create Budget** · create or change, €29 plan · creates an object on each call

Create a new Microsoft Advertising shared budget, with a name, an amount and a budget type. It spends nothing until a campaign uses it; delete it with delete\_budget.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `name` | `string` | yes | Budget name. |
| `amount` | `number` | yes | Budget amount. |
| `budget_type` | `string` | yes | Budget type: DailyBudgetAccelerated or DailyBudgetStandard. |

### `bing_ads_create_callout_extension` [#bing_ads_create_callout_extension]

**Microsoft Ads: Create Callout Extension** · create or change, €29 plan · creates an object on each call

Create a callout extension in the account (then attach it with set\_extension\_association). Change it with update\_callout\_extension, delete it with delete\_extension.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `text` | `string` | yes | Callout text, at most 25 characters. |

### `bing_ads_create_campaign` [#bing_ads_create_campaign]

**Microsoft Ads: Create Campaign** · create or change, €29 plan · creates an object on each call

Create a new campaign in a Microsoft Advertising account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `name` | `string` | yes | Campaign name. |
| `budget_type` | `string` | yes | Budget type: DailyBudgetAccelerated or DailyBudgetStandard. |
| `daily_budget` | `number` | yes | Daily budget amount. |
| `campaign_type` | `string` | yes | Campaign type: Search, Shopping, Audience, DynamicSearchAds, Performance Max. |
| `status` | `string` | no | Campaign status: Active or Paused. |
| `time_zone` | `string` | no | Time zone (e.g. EasternTimeUSCanada, PacificTimeUSCanadaTijuana). |
| `languages` | `string[]` | no | Campaign languages, for example \["French"\]. Without them, each ad group must carry its own language. |

### `bing_ads_create_conversion_goal` [#bing_ads_create_conversion_goal]

**Microsoft Ads: Create Conversion Goal** · create or change, €29 plan · creates an object on each call

Create a conversion goal: a destination URL goal (type=Url) or a custom event goal (type=Event), on a UET tag (get its ID from an existing goal with list\_conversion\_goals). Starts Paused unless status=Active.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `type` | `string` | yes | Url (destination URL) or Event (custom event). Values: `"Url"`, `"Event"`. |
| `name` | `string` | yes | Goal name. |
| `tag_id` | `string` | yes | UET tag ID. |
| `goal_category` | `string` | yes | Goal category. Values: `"AddToCart"`, `"BeginCheckout"`, `"BookAppointment"`, `"Contact"`, `"Download"`, `"GetDirections"`, `"None"`, `"Other"`, `"OutboundClick"`, `"PageView"`, `"Purchase"`, `"RequestQuote"`, `"Signup"`, `"SubmitLeadForm"`, `"Subscribe"`. |
| `status` | `string` | no | Initial status. Values: `"Active"`, `"Paused"`. Default: `"Paused"`. |
| `url_expression` | `string` | no | type=Url: the URL or part of it. |
| `url_operator` | `string` | no | type=Url: how to match (default Equals). Values: `"Equals"`, `"BeginsWith"`, `"Contains"`, `"RegularExpression"`. |
| `event_action` | `string` | no | type=Event: event action to match (Equals). |
| `event_category` | `string` | no | type=Event: event category to match (Equals). |
| `revenue_value` | `number` | no | Fixed revenue per conversion (omit for no value). |
| `currency_code` | `string` | no | Currency of the revenue, e.g. EUR. |
| `conversion_window_minutes` | `integer` | no | Conversion window in minutes. |

### `bing_ads_create_keyword` [#bing_ads_create_keyword]

**Microsoft Ads: Create Keyword** · create or change, €29 plan · creates an object on each call

Create a new keyword in a Microsoft Advertising ad group, with its text, match type (Broad, Phrase or Exact) and bid.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID. |
| `text` | `string` | yes | Keyword text. |
| `match_type` | `string` | yes | Match type: Broad, Phrase, or Exact. |
| `bid` | `number` | yes | Keyword bid amount. |
| `status` | `string` | no | Initial status: Paused (default) or Active. Values: `"Active"`, `"Paused"`. Default: `"Paused"`. |

### `bing_ads_create_label` [#bing_ads_create_label]

**Microsoft Ads: Create Label** · create or change, €29 plan · creates an object on each call

Create a label in the Microsoft Advertising account, with a unique name, an optional description and color.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `name` | `string` | yes | Label name, unique in the account (case-sensitive). |
| `description` | `string` | no | Description. |
| `color_code` | `string` | no | Color, e.g. #1A73E8. |

### `bing_ads_create_sitelink_extension` [#bing_ads_create_sitelink_extension]

**Microsoft Ads: Create Sitelink Extension** · create or change, €29 plan · creates an object on each call

Create a sitelink extension in the account (then attach it with set\_extension\_association). Change it with update\_sitelink\_extension, delete it with delete\_extension.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `display_text` | `string` | yes | Link text, at most 35 characters (25 with descriptions). |
| `final_urls` | `string[]` | yes | Final URLs. |
| `description1` | `string` | no | Description line 1 (give both lines or none). |
| `description2` | `string` | no | Description line 2. |

### `bing_ads_set_extension_association` [#bing_ads_set_extension_association]

**Microsoft Ads: Set Extension Association** · create or change, €29 plan · creates an object on each call

Attach an ad extension to the account, a campaign or an ad group

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_id` | `string` | yes | Ad extension ID (see list\_extensions). |
| `association_type` | `string` | yes | What the extension is attached to. Values: `"Account"`, `"Campaign"`, `"AdGroup"`. |
| `entity_id` | `string` | yes | Account, campaign or ad group ID. |

### `bing_ads_update_ad` [#bing_ads_update_ad]

**Microsoft Ads: Update Ad** · create or change, €29 plan · creates an object on each call

Update an existing ad (headlines, descriptions, or status)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the ad (required by Microsoft). |
| `ad_id` | `string` | yes | The ad ID to update. |
| `headlines` | `string[]` | no | New headlines array. |
| `descriptions` | `string[]` | no | New descriptions array. |
| `status` | `string` | no | New status: Active or Paused. |

### `bing_ads_update_ad_group` [#bing_ads_update_ad_group]

**Microsoft Ads: Update Ad Group** · create or change, €29 plan · creates an object on each call

Update an existing ad group (name, bid, status)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | no | The campaign ID. |
| `ad_group_id` | `string` | yes | The ad group ID to update. |
| `name` | `string` | no | New ad group name. |
| `cpc_bid` | `number` | no | New CPC bid amount. |
| `status` | `string` | no | New status: Active or Paused. |

### `bing_ads_update_ad_group_audience` [#bing_ads_update_ad_group_audience]

**Microsoft Ads: Update Ad Group Audience** · create or change, €29 plan · creates an object on each call

Change the bid adjustment (percent) of one audience targeted in an ad group (criterion\_id, see list\_ad\_group\_audiences).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | Ad group ID. |
| `criterion_id` | `string` | yes | Ad group criterion ID of the audience association. |
| `bid_multiplier` | `number` | yes | New bid adjustment in percent, -90 to 900. |
| `audience_type` | `string` | no | Audience type (default RemarketingList, the type list\_audiences returns). Values: `"RemarketingList"`, `"CustomAudience"`, `"InMarketAudience"`, `"ProductAudience"`, `"SimilarRemarketingList"`, `"CombinedList"`, `"CustomerList"`, `"ImpressionBasedRemarketingList"`. Default: `"RemarketingList"`. |

### `bing_ads_update_budget` [#bing_ads_update_budget]

**Microsoft Ads: Update Budget** · create or change, €29 plan · creates an object on each call

Update an existing shared budget (name or amount)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `budget_id` | `string` | yes | The budget ID to update. |
| `name` | `string` | no | New budget name. |
| `amount` | `number` | no | New budget amount. |

### `bing_ads_update_callout_extension` [#bing_ads_update_callout_extension]

**Microsoft Ads: Update Callout Extension** · create or change, €29 plan · creates an object on each call

Change the text of one callout extension (extension\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_id` | `string` | yes | Callout extension ID (see list\_extensions). |
| `text` | `string` | yes | New callout text, at most 25 characters. |

### `bing_ads_update_campaign` [#bing_ads_update_campaign]

**Microsoft Ads: Update Campaign** · create or change, €29 plan · creates an object on each call

Update an existing campaign (name, status, budget)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID to update. |
| `name` | `string` | no | New campaign name. |
| `status` | `string` | no | New status: Active or Paused. |
| `daily_budget` | `number` | no | New daily budget amount. |

### `bing_ads_update_conversion_goal` [#bing_ads_update_conversion_goal]

**Microsoft Ads: Update Conversion Goal** · create or change, €29 plan · creates an object on each call

Update a conversion goal: name, status (Active, Paused), category, or its revenue. Give its type (Url or Event). Deleting a goal is a separate, admin-only tool (delete\_conversion\_goal).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `conversion_goal_id` | `string` | yes | Conversion goal ID. |
| `type` | `string` | yes | The goal type (see list\_conversion\_goals). Values: `"Url"`, `"Event"`. |
| `name` | `string` | no | New name. |
| `status` | `string` | no | New status. Values: `"Active"`, `"Paused"`. |
| `goal_category` | `string` | no | New category. Values: `"AddToCart"`, `"BeginCheckout"`, `"BookAppointment"`, `"Contact"`, `"Download"`, `"GetDirections"`, `"None"`, `"Other"`, `"OutboundClick"`, `"PageView"`, `"Purchase"`, `"RequestQuote"`, `"Signup"`, `"SubmitLeadForm"`, `"Subscribe"`. |
| `revenue_value` | `number` | no | New fixed revenue per conversion. |

### `bing_ads_update_keyword` [#bing_ads_update_keyword]

**Microsoft Ads: Update Keyword** · create or change, €29 plan · creates an object on each call

Update an existing keyword (bid or status)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the keyword (required by Microsoft). |
| `keyword_id` | `string` | yes | The keyword ID to update. |
| `bid` | `number` | no | New bid amount. |
| `status` | `string` | no | New status: Active or Paused. |

### `bing_ads_update_label` [#bing_ads_update_label]

**Microsoft Ads: Update Label** · create or change, €29 plan · creates an object on each call

Update a label (name, description or color)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `label_id` | `string` | yes | Label ID. |
| `name` | `string` | no | New name. |
| `description` | `string` | no | New description. |
| `color_code` | `string` | no | New color. |

### `bing_ads_update_sitelink_extension` [#bing_ads_update_sitelink_extension]

**Microsoft Ads: Update Sitelink Extension** · create or change, €29 plan · creates an object on each call

Replace one sitelink extension (extension\_id): give its link text and final URLs; description lines not given are removed by Microsoft.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_id` | `string` | yes | Sitelink extension ID (see list\_extensions). |
| `display_text` | `string` | yes | Link text, at most 35 characters (25 with descriptions). |
| `final_urls` | `string[]` | yes | Final URLs. |
| `description1` | `string` | no | Description line 1 (give both lines or none). |
| `description2` | `string` | no | Description line 2. |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `bing_ads_delete_ad` [#bing_ads_delete_ad]

**Microsoft Ads: Delete Ad** · delete, €29 plan, one object at a time · creates an object on each call

Delete one Microsoft Advertising ad by ad\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the ad (required by Microsoft). |
| `ad_id` | `string` | yes | The ad ID to delete. |

### `bing_ads_delete_ad_group` [#bing_ads_delete_ad_group]

**Microsoft Ads: Delete Ad Group** · delete, €29 plan, one object at a time · creates an object on each call

Delete one Microsoft Advertising ad group by ad\_group\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | no | The campaign ID. |
| `ad_group_id` | `string` | yes | The ad group ID to delete. |

### `bing_ads_delete_budget` [#bing_ads_delete_budget]

**Microsoft Ads: Delete Budget** · delete, €29 plan, one object at a time · creates an object on each call

Delete one shared budget from the account (budget\_id).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `budget_id` | `string` | yes | The budget ID to delete. |

### `bing_ads_delete_campaign` [#bing_ads_delete_campaign]

**Microsoft Ads: Delete Campaign** · delete, €29 plan, one object at a time · creates an object on each call

Delete a campaign from a Microsoft Advertising account

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `campaign_id` | `string` | yes | The campaign ID to delete. |

### `bing_ads_delete_conversion_goal` [#bing_ads_delete_conversion_goal]

**Microsoft Ads: Delete Conversion Goal** · delete, €29 plan, one object at a time · creates an object on each call

Delete one conversion goal (its status becomes Deleted; Microsoft has no other way to remove a goal)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `conversion_goal_id` | `string` | yes | Conversion goal ID. |
| `type` | `string` | yes | The goal type. Values: `"Url"`, `"Event"`. |

### `bing_ads_delete_extension` [#bing_ads_delete_extension]

**Microsoft Ads: Delete Extension** · delete, €29 plan, one object at a time · creates an object on each call

Delete one ad extension from the account (extension\_id); it is detached from every campaign and ad group.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_id` | `string` | yes | Ad extension ID (see list\_extensions). |

### `bing_ads_delete_keyword` [#bing_ads_delete_keyword]

**Microsoft Ads: Delete Keyword** · delete, €29 plan, one object at a time · creates an object on each call

Delete one Microsoft Advertising keyword by keyword\_id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | The ad group ID of the keyword (required by Microsoft). |
| `keyword_id` | `string` | yes | The keyword ID to delete. |

### `bing_ads_delete_label` [#bing_ads_delete_label]

**Microsoft Ads: Delete Label** · delete, €29 plan, one object at a time · creates an object on each call

Delete one label from the account (it is removed from every campaign, ad group, ad and keyword)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `label_id` | `string` | yes | Label ID. |

### `bing_ads_delete_negative_keyword` [#bing_ads_delete_negative_keyword]

**Microsoft Ads: Delete Negative Keyword** · delete, €29 plan, one object at a time · creates an object on each call

Delete one negative keyword from a campaign or an ad group (use list\_negative\_keywords for its ID)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | Campaign or AdGroup. Values: `"Campaign"`, `"AdGroup"`. |
| `entity_id` | `string` | yes | Campaign or ad group ID. |
| `campaign_id` | `string` | no | Campaign ID of the ad group (lets Pilot re-read the list; ignored by Microsoft). |
| `negative_keyword_id` | `string` | yes | Negative keyword ID. |

### `bing_ads_remove_audience_from_ad_group` [#bing_ads_remove_audience_from_ad_group]

**Microsoft Ads: Remove Audience from Ad Group** · delete, €29 plan, one object at a time · creates an object on each call

Stop targeting an audience in an ad group (the audience itself is kept)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `ad_group_id` | `string` | yes | Ad group ID. |
| `criterion_id` | `string` | yes | Ad group criterion ID of the audience association. |
| `audience_type` | `string` | no | Audience type (default RemarketingList, the type list\_audiences returns). Values: `"RemarketingList"`, `"CustomAudience"`, `"InMarketAudience"`, `"ProductAudience"`, `"SimilarRemarketingList"`, `"CombinedList"`, `"CustomerList"`, `"ImpressionBasedRemarketingList"`. Default: `"RemarketingList"`. |

### `bing_ads_remove_extension_association` [#bing_ads_remove_extension_association]

**Microsoft Ads: Remove Extension Association** · delete, €29 plan, one object at a time · creates an object on each call

Detach an ad extension from the account, a campaign or an ad group (the extension itself is kept)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `extension_id` | `string` | yes | Ad extension ID (see list\_extensions). |
| `association_type` | `string` | yes | What the extension is attached to. Values: `"Account"`, `"Campaign"`, `"AdGroup"`. |
| `entity_id` | `string` | yes | Account, campaign or ad group ID. |

### `bing_ads_remove_label` [#bing_ads_remove_label]

**Microsoft Ads: Remove Label** · delete, €29 plan, one object at a time · creates an object on each call

Remove a label from one campaign, ad group, ad or keyword (the label itself is kept)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `target_account_id` | `string` | yes | The account ID. |
| `entity_type` | `string` | yes | What carries the label. Values: `"Campaign"`, `"AdGroup"`, `"Ad"`, `"Keyword"`. |
| `entity_id` | `string` | yes | Campaign, ad group, ad or keyword ID. |
| `label_id` | `string` | yes | Label ID. |
