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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 22 |
| Create and change (€29) | 23 |
| Delete (€29) | 12 |
Other tools
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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)
Served with the €29 plan.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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)
Served with the €29 plan. A deletion targets one object at a time.
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
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
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
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
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
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
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
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
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
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
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
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. |