Documentation / Tool Reference

Microsoft Advertising tools

Tools for the Microsoft Advertising (Bing Ads) API: campaign/ad group/RSA management, keyword & bid strategy, location/demographic/device targeting, UET tag, conversion goal, and remarketing audiences.

Connection & Account · 2

connect_microsoft_adsfree

Generates a one-time authorization link to connect a Microsoft Advertising (Bing Ads) ad account.

list_microsoft_accounts1 credits

Lists the user's connected Microsoft Advertising ad account(s).

all_accessible

Reading & Reports · 8

list_microsoft_ad_groups1 credits

Lists the ad groups in a Microsoft Advertising campaign.

account_idcampaign_idcustomer_id
list_microsoft_ads1 credits

Lists the ads in a Microsoft ad group.

account_idad_group_idcustomer_id
list_microsoft_audiences1 credits

Lists the account's audiences (remarketing / similar / combined) — for audience targeting.

account_idcustomer_id
list_microsoft_campaigns1 credits

Lists the campaigns in a Microsoft Advertising ad account (account_id).

account_idcustomer_id
list_microsoft_conversion_goals1 credits

Lists the conversion goals in the account — required for conversion-based bidding strategies (MaxConversions/TargetCpa).

account_idcustomer_id
list_microsoft_keywords1 credits

Lists the keywords in a Microsoft ad group.

account_idad_group_idcustomer_id
list_microsoft_uet_tags1 credits

Lists the account's UET (conversion tracking) tags — required for conversion goals + remarketing.

account_idcustomer_id
microsoft_performance_report2 credits

Microsoft Advertising campaign performance report (spend/impressions/clicks/CTR/conversions).

account_idstart_dateend_datecustomer_id

Campaign · 5

create_microsoft_campaign8 credits

Creates a campaign in Microsoft Advertising (starts PAUSED).

account_idnamedaily_budgetcampaign_typecustomer_idconfirm
delete_microsoft_campaign5 credits

Deletes a Microsoft campaign (irreversible).

account_idcampaign_idcustomer_idconfirm
set_microsoft_bid_strategy5 credits

Sets a campaign's bid strategy.

account_idcampaign_idstrategytarget_cpatarget_roasmax_cpccustomer_idconfirm
update_microsoft_campaign_budget5 credits

Updates a campaign's daily budget.

account_idcampaign_iddaily_budgetcustomer_idconfirm
update_microsoft_campaign_status5 credits

Changes campaign status.

account_idcampaign_idstatuscustomer_idconfirm

Ad group & Ad · 4

create_microsoft_ad_group8 credits

Creates an ad group in a campaign (starts PAUSED by default).

account_idcampaign_idnamecpc_bidlanguagecustomer_idconfirm
create_microsoft_responsive_search_ad8 credits

Creates a Responsive Search Ad (RSA).

account_idad_group_idheadlinesdescriptionsfinal_urlpath1path2customer_idconfirm
update_microsoft_ad_group_status5 credits

Changes an ad group's status.

account_idcampaign_idad_group_idstatuscustomer_idconfirm
update_microsoft_ad_status5 credits

Changes ad status.

account_idad_group_idad_idstatusad_typecustomer_idconfirm

Keywords · 3

add_microsoft_keywords4 credits

Adds keywords to an ad group.

account_idad_group_idkeywordsmatch_typecustomer_idconfirm
add_microsoft_negative_keywords3 credits

Adds negative keywords to a campaign or ad group.

account_identity_identity_typekeywordsmatch_typecustomer_idconfirm
update_microsoft_keyword3 credits

Updates a keyword's bid (bid>0) and/or status (Active|Paused).

account_idad_group_idkeyword_idbidstatuscustomer_idconfirm

Targeting · 3

add_microsoft_demographic_target4 credits

Adds a demographic bid adjustment.

account_idcampaign_idcriterion_typevaluebid_multipliercustomer_idconfirm
add_microsoft_device_target4 credits

Adds device bid adjustments (all THREE TOGETHER — required by Microsoft).

account_idcampaign_idcomputerssmartphonestabletscustomer_idconfirm
add_microsoft_location_target4 credits

Adds a geographic location target to a campaign using Bing LocationIds.

account_idcampaign_idlocation_idsbid_multipliercustomer_idconfirm

Conversion & Audience · 4

create_microsoft_conversion_goal6 credits

Creates a URL-based conversion goal.

account_idnameuet_tag_idurl_expressionoperatorgoal_categoryrevenue_valuecustomer_idconfirm
create_microsoft_remarketing_list6 credits

Creates a remarketing audience — visitors of a specific page (URL).

account_idnameuet_tag_idurl_containsmembership_durationoperatorcustomer_idconfirm
create_microsoft_uet_tag5 credits

Creates a UET (conversion tracking) tag.

account_idnamedescriptioncustomer_idconfirm
delete_microsoft_audience5 credits

Deletes a Microsoft audience (remarketing list, etc.).

account_idaudience_idcustomer_idconfirm

Other

add_microsoft_ad_extensionsfree

Adds SITELINK and/or CALLOUT ad extensions to a Microsoft (Bing) campaign — the extra links and highlights that make the ad taller and lift CTR.

account_idcampaign_idsitelinkscalloutscustomer_idconfirm
add_microsoft_ad_schedulefree

Sets WHEN a Microsoft (Bing) campaign is allowed to serve — e.g.

account_idcampaign_iddaysfrom_hourto_hourbid_adjustmentconfirm
list_microsoft_ad_extensionsfree

Lists the SITELINK and CALLOUT extensions attached to campaigns in a Microsoft (Bing) account, with their text, URLs and status — use it before adding more (duplicates are a common cause of disapprovals) or to find the id to remove.

account_idcustomer_id
list_microsoft_negative_keywordsfree

Lists the NEGATIVE keywords currently blocking traffic on a Microsoft (Bing) campaign or ad group — run this when impressions drop unexpectedly, or before removing one.

account_identity_identity_type
microsoft_entity_performance_reportfree

Microsoft (Bing) performance BROKEN DOWN below campaign level — which ad group, ad, keyword, location, device or age/gender actually produced the clicks and conversions.

account_idstart_dateend_datelevel
microsoft_location_search2 credits

Searches Microsoft/Bing Advertising GEOGRAPHIC LOCATIONS by name and returns the numeric LocationId(s) required by add_microsoft_location_target.

queryaccount_idcustomer_idlocation_typelimit
microsoft_search_terms_reportfree

SEARCH TERMS report for Microsoft Advertising (Bing) — the actual queries people typed, with the keyword that matched and its match type.

account_iddaysmin_wastelimitstart_dateend_datecustomer_id
remove_microsoft_ad_extensionsfree

REMOVES sitelink/callout extensions: detaches them from the campaign and deletes them from the account library.

account_idextension_idscampaign_idcustomer_idconfirm
remove_microsoft_negative_keywordsfree

REMOVES negative keywords from a Microsoft (Bing) campaign or ad group — the undo for a negative that was added by mistake.

account_identity_idkeywordsentity_typeconfirm
update_microsoft_ad_groupfree

UPDATES a Microsoft (Bing) ad group's settings.

account_idcampaign_idad_group_idnamecpc_bidend_datestart_datestatusnetworkconfirm
update_microsoft_responsive_search_adfree

EDITS the copy of an existing Microsoft (Bing) Responsive Search Ad — swap a weak headline or description WITHOUT deleting and rebuilding the ad (a rebuild resets its performance history).

account_idad_group_idad_idheadlinesdescriptionsfinal_urlpath1path2customer_idconfirm
upload_microsoft_offline_conversionsfree

UPLOADS OFFLINE CONVERSIONS to Microsoft Advertising (Bing) — closes the loop between your CRM and your Bing ads, so bidding optimises toward real revenue instead of just form fills.

account_idconversion_nameconversionscurrencyconfirm