Ads: accounts & measurement
Ad accounts, account-level ad management, tracking tags, lead gen, product catalogs and conversions.
ads_measurementConnections
Update an ads connection
/ads/connections/{connectionId}Changes the local label of an ads connection or moves it (and its ad accounts) to another profile.
Try it with MCPAsk your agent to call update-ad-connection (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Body object
namestring | null≤ 100 characters
profile_idstring | null≤ 80 characters
Returns object
objectstringrequiredad_connection
idstringplatformstringconnect_flowstring | nullprofile_idstring | nullsocial_account_idstring | nullexternal_user_idstringnamestring | nulldisplay_namestring | nullavatar_urlstring | nullstatusstringactiveneeds_reconnectdisconnected
scopesarray of stringtoken_expires_atstring (date-time) | nullmetadataobjectad_account_countintegersyncobjectShow 4 child attributes
statusstringerrorstring | nulllast_synced_atstring (date-time) | nullinitial_sync_completed_atstring (date-time) | nulllast_discovered_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Re-discover ad accounts
/ads/connections/{connectionId}/discoverLists the ad accounts the connection reaches on the network now: new ones are added (selected), vanished ones become closed.
Try it with MCPAsk your agent to call discover-ad-connection-accounts (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
objectstringrequiredad_account
idstringconnection_idstring | nullprofile_idstring | nullplatformstringexternal_idstringnamestring | nullcurrencystring | nulltimezonestring | nullstatusstringplatform_statusstring | nullbusiness_idstring | nullbusiness_namestring | nullmanager_customer_idstring | nullis_managerbooleanis_testbooleanselectedbooleanselectablebooleanunusable_reasonstring | nullbilling_statusstringmetadataobjectlast_discovered_atstring (date-time) | nulllast_synced_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
List business portfolios
/ads/connections/{connectionId}/businessesMeta business portfolios the connected user belongs to, with their verification status.
Try it with MCPAsk your agent to call list-ad-businesses (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Query parameters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredbusiness
idstringnamestring | nullverification_statusstring | nullcreated_atstring (date-time) | nullpermitted_tasksarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List business users
/ads/connections/{connectionId}/businesses/{businessId}/usersPeople and system users of a Meta business portfolio (the ids to assign to Pages, ad accounts and pixels).
Try it with MCPAsk your agent to call list-ad-business-users (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
businessIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredbusiness_user
idstringnamestring | nullemailstring | nullrolestring | nulltypestringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List TikTok Business Centers
/ads/connections/{connectionId}/business-centersThe TikTok Business Centers the connection can read, with their advertiser counts.
Try it with MCPAsk your agent to call list-ad-business-centers (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 5 item attributes
objectstringrequiredbusiness_center
idstringnamestring | nulladvertiser_countinteger | nullrolestring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List Page users
/ads/connections/{connectionId}/pages/{pageId}/usersPeople of a business portfolio assigned to a Facebook Page.
Try it with MCPAsk your agent to call list-ad-page-users (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
pageIdstringrequired1–256 characters
Query parameters
business_idstringrequired1–64 characters
Returns object
objectstringlist
dataarray of objectShow 5 item attributes
objectstringrequiredpage_user
idstringpage_idstringnamestring | nulltasksarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Assign a user to a Page
/ads/connections/{connectionId}/pages/{pageId}/usersGives a business user tasks on a Facebook Page (replaces their task set). ADVERTISE is what ad creation needs.
Try it with MCPAsk your agent to call assign-ad-page-user (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
pageIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
business_idstringrequired1–64 characters
user_idstringrequired1–64 characters
tasksarray of stringrequired≥ 1 items
Returns object
objectstringrequiredpage_user
idstringpage_idstringnamestring | nulltasksarray of stringResponses
Remove a user from a Page
/ads/connections/{connectionId}/pages/{pageId}/users/{userId}Try it with MCPAsk your agent to call remove-ad-page-user (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
pageIdstringrequired1–256 characters
userIdstringrequired1–256 characters
Query parameters
business_idstring1–64 characters
Returns object
objectstringrequiredpage_user
idstringrequireddeletedbooleanrequiredResponses
Get the Google Ads manager hierarchy
/ads/connections/{connectionId}/hierarchyLive manager (MCC) and client tree of a Google Ads connection, with pending invitations and link status.
Try it with MCPAsk your agent to call get-ad-manager-hierarchy (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Returns object
objectstringrequiredmanager_hierarchy
connection_idstringrootsarray of objectShow 9 item attributes
customer_idstringnamestring | nullcurrencystring | nulltime_zonestring | nullmanagerbooleantest_accountbooleanstatusstring | nullmanager_linksarray of objectShow 3 item attributes
manager_customer_idstring | nullmanager_link_idstring | nullstatusstringclientsarray of objectShow 12 item attributes
customer_idstringnamestring | nullcurrencystring | nulltime_zonestring | nullmanagerbooleantest_accountbooleanhiddenbooleanlevelintegerstatusstring | nullparent_customer_idstring | nullmanager_link_idstring | nulllink_statusstring | nulldirect_customersarray of objectShow 3 item attributes
customer_idstringmanagerbooleanpending_invitationsarray of objectShow 2 item attributes
manager_customer_idstring | nullmanager_link_idstring | nullunavailablearray of objectShow 2 item attributes
customer_idstringreasonstringtruncatedbooleanResponses
Invite a client account to a manager
/ads/connections/{connectionId}/manager-linksSends a manager-to-client link invitation (Google Ads). The link stays PENDING until the client accepts.
Try it with MCPAsk your agent to call create-ad-manager-link (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
manager_customer_idstringrequired1–20 characters
client_customer_idstringrequired1–20 characters
validate_onlybooleanReturns object
objectstringrequiredmanager_link
manager_customer_idstringclient_customer_idstringmanager_link_idstring | nullstatusstringvalidate_onlybooleanResponses
Accept, decline, cancel or end a manager link
/ads/connections/{connectionId}/manager-links/{managerLinkId}Try it with MCPAsk your agent to call update-ad-manager-link (toolset ads_measurement)Set up MCP
Path parameters
connectionIdstringrequiredAds connection id (adc_…)
1–80 characters
managerLinkIdstringrequired1–256 characters
Body object
manager_customer_idstringrequired1–20 characters
client_customer_idstringrequired1–20 characters
actionstringrequiredacceptdeclinecancelunlink
validate_onlybooleanReturns object
objectstringrequiredmanager_link
manager_customer_idstringclient_customer_idstringmanager_link_idstring | nullstatusstringvalidate_onlybooleanResponses
Accounts
List ad accounts
/ads/accountsThe platform ad accounts reached by the workspace ads connections. refresh=true re-discovers the matching connections live first.
Try it with MCPAsk your agent to call list-ad-accounts (toolset ads_measurement)Set up MCP
Query parameters
pageintegerdefault: 1≥ 1
limitintegerdefault: 201–100
connection_idstring1–80 characters
platformstring1–40 characters
profile_idstring1–80 characters
statusstringactivependingdisabledclosedunknown
selectedbooleanexternal_idstring1–256 characters
searchstring1–200 characters
refreshbooleanin_scope_onlybooleansortstringnamecreated_atplatformstatus
orderstringascdesc
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
objectstringrequiredad_account
idstringconnection_idstring | nullprofile_idstring | nullplatformstringexternal_idstringnamestring | nullcurrencystring | nulltimezonestring | nullstatusstringplatform_statusstring | nullbusiness_idstring | nullbusiness_namestring | nullmanager_customer_idstring | nullis_managerbooleanis_testbooleanselectedbooleanselectablebooleanunusable_reasonstring | nullbilling_statusstringmetadataobjectlast_discovered_atstring (date-time) | nulllast_synced_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Create a Meta ad account
/ads/accountsCreates an ad account in a Meta business portfolio (a payment method must then be added in Ads Manager).
Try it with MCPAsk your agent to call create-ad-account (toolset ads_measurement)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
connection_idstringrequired1–80 characters
business_idstringrequired1–64 characters
namestringrequired1–100 characters
currencystringrequiredpattern ^[A-Za-z]{3}$
timezone_idintegerrequiredend_advertiserstring1–64 characters
media_agencystring1–64 characters
partnerstring1–64 characters
invoicebooleaninvoice_group_idstring1–64 characters
invoicing_emailsarray of string (email)≤ 20 items
iobooleanpo_numberstring1–64 characters
funding_idstring1–64 characters
Returns object
objectstringrequiredad_account
idstringconnection_idstring | nullprofile_idstring | nullplatformstringexternal_idstringnamestring | nullcurrencystring | nulltimezonestring | nullstatusstringplatform_statusstring | nullbusiness_idstring | nullbusiness_namestring | nullmanager_customer_idstring | nullis_managerbooleanis_testbooleanselectedbooleanselectablebooleanunusable_reasonstring | nullbilling_statusstringmetadataobjectlast_discovered_atstring (date-time) | nulllast_synced_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpayment_method_requiredbooleanads_manager_urlstring | nullnext_stepsstring | nullwarningsarray of stringResponses
Get an ad account
/ads/accounts/{adAccountId}Try it with MCPAsk your agent to call get-ad-account (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringrequiredad_account
idstringconnection_idstring | nullprofile_idstring | nullplatformstringexternal_idstringnamestring | nullcurrencystring | nulltimezonestring | nullstatusstringplatform_statusstring | nullbusiness_idstring | nullbusiness_namestring | nullmanager_customer_idstring | nullis_managerbooleanis_testbooleanselectedbooleanselectablebooleanunusable_reasonstring | nullbilling_statusstringmetadataobjectlast_discovered_atstring (date-time) | nulllast_synced_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Select or move an ad account
/ads/accounts/{adAccountId}Local settings: selected (managed, synced, billed) and profile_id.
Try it with MCPAsk your agent to call update-ad-account (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
selectedbooleanprofile_idstring | null≤ 80 characters
Returns object
objectstringrequiredad_account
idstringconnection_idstring | nullprofile_idstring | nullplatformstringexternal_idstringnamestring | nullcurrencystring | nulltimezonestring | nullstatusstringplatform_statusstring | nullbusiness_idstring | nullbusiness_namestring | nullmanager_customer_idstring | nullis_managerbooleanis_testbooleanselectedbooleanselectablebooleanunusable_reasonstring | nullbilling_statusstringmetadataobjectlast_discovered_atstring (date-time) | nulllast_synced_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Update ad account settings on the network
/ads/accounts/{adAccountId}/settingsMeta: name, spend cap, amount-spent reset, default DSA beneficiary / payor. Google: account tracking template and final URL suffix.
Try it with MCPAsk your agent to call update-ad-account-settings (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
namestring1–100 characters
spend_capnumber | nullreset_amount_spentbooleandefault_dsa_beneficiarystring1–512 characters
default_dsa_payorstring1–512 characters
tracking_url_templatestring≤ 2048 characters
final_url_suffixstring≤ 2048 characters
Returns object
objectstringrequiredad_account_settings
ad_account_idstringplatformstringnamestring | nullspend_capnumber | nullurl_trackingobject | nullShow 2 child attributes
tracking_url_templatestring | nullfinal_url_suffixstring | nulldsa_defaultsobject | nullShow 2 child attributes
beneficiarystring | nullpayorstring | nullfinanceobject | nullShow 7 child attributes
objectstringad_account_finance
ad_account_idstringcurrencystring | nullbalancenumber | nullamount_spentnumber | nullspend_capnumber | nullfunding_sourceobject | nullShow 2 child attributes
display_stringstring | nulltypenumber | nullResponses
Get ad account finances
/ads/accounts/{adAccountId}/financeBalance, total spend, spend cap and funding source (Meta).
Try it with MCPAsk your agent to call get-ad-account-finance (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringrequiredad_account_finance
ad_account_idstringcurrencystring | nullbalancenumber | nullamount_spentnumber | nullspend_capnumber | nullfunding_sourceobject | nullShow 2 child attributes
display_stringstring | nulltypenumber | nullResponses
Read campaigns and ad sets live
/ads/accounts/{adAccountId}/liveReads campaigns and ad sets straight from the network (Meta, TikTok), e.g. to check budgets before a write.
Try it with MCPAsk your agent to call get-ad-account-live (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
statusstring1–200 characters
levelstringcampaignad_set
limitintegerdefault: 1001–200
campaigns_cursorstring1–4096 characters
ad_sets_cursorstring1–4096 characters
Returns object
objectstringrequiredad_account_live
ad_account_idstringplatformstringcurrencystring | nullread_atstring (date-time) | nullcampaignsarray of objectShow 11 item attributes
idstringnamestring | nullstatusstringplatform_statusstring | nullconfigured_statusstring | nullbudgetobject | nullShow 2 child attributes
amountnumbertypestringdaily_budgetnumber | nulllifetime_budgetnumber | nullbudget_remainingnumber | nullbid_strategystring | nullspend_capnumber | nullad_setsarray of objectShow 18 item attributes
idstringnamestring | nullstatusstringplatform_statusstring | nullconfigured_statusstring | nullbudgetobject | nullShow 2 child attributes
amountnumbertypestringdaily_budgetnumber | nulllifetime_budgetnumber | nullbudget_remainingnumber | nullbid_strategystring | nullcampaign_idstring | nullbid_amountnumber | nulloptimization_goalstring | nullbilling_eventstring | nullpromoted_objectobject | nulltargetingobject | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullnext_cursorsobjectShow 2 child attributes
campaignsstring | nullad_setsstring | nullResponses
Get DSA defaults
/ads/accounts/{adAccountId}/dsa-defaultsTry it with MCPAsk your agent to call get-ad-account-dsa-defaults (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringrequireddsa_defaults
ad_account_idstringbeneficiarystring | nullpayorstring | nullResponses
Get DSA recommendations
/ads/accounts/{adAccountId}/dsa-recommendationsSuggested beneficiary / payor names for EU DSA disclosures (never applied automatically).
Try it with MCPAsk your agent to call get-ad-account-dsa-recommendations (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringrequireddsa_recommendations
ad_account_idstringrecommendationsarray of stringResponses
List ad account users
/ads/accounts/{adAccountId}/usersTry it with MCPAsk your agent to call list-ad-account-users (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
business_idstring1–64 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredad_account_user
idstringnamestring | nullemailstring | nullrolestring | nulltasksarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Assign a user to an ad account
/ads/accounts/{adAccountId}/usersMANAGE = admin, ADVERTISE creates ads, ANALYZE reads reports, DRAFT edits drafts. Replaces the user’s task set.
Try it with MCPAsk your agent to call assign-ad-account-user (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringrequired1–64 characters
tasksarray of stringrequired≥ 1 items
business_idstring1–64 characters
Returns object
objectstringrequiredad_account_user
idstringnamestring | nullemailstring | nullrolestring | nulltasksarray of stringResponses
Remove a user from an ad account
/ads/accounts/{adAccountId}/users/{userId}Try it with MCPAsk your agent to call remove-ad-account-user (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
userIdstringrequired1–256 characters
Returns object
objectstringrequiredad_account_user
idstringrequireddeletedbooleanrequiredResponses
Ad account change log
/ads/accounts/{adAccountId}/activityWho changed what and when (Meta activities, Google change history: last 30 days).
Try it with MCPAsk your agent to call list-ad-account-activity (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
sincestringYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
untilstringYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
object_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 12 item attributes
objectstringrequiredad_activity
idstring | nullevent_typestring | nullevent_timestring (date-time) | nullactor_idstring | nullactor_namestring | nullobject_typestring | nullobject_idstring | nullobject_namestring | nullapplication_namestring | nulltranslated_event_typestring | nullextra_dataobject | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List A/B tests and lift studies
/ads/accounts/{adAccountId}/studiesTry it with MCPAsk your agent to call list-ad-studies (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
fieldsstring1–2000 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredad_study
idstringnamestring | nulltypestring | nulldescriptionstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullcellsarray of objectrawobjectpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List Instagram ad identities
/ads/accounts/{adAccountId}/instagram-accountsTry it with MCPAsk your agent to call list-ad-instagram-accounts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringrequiredinstagram_identities
ad_account_idstringaccountsarray of objectShow 5 item attributes
ig_user_idstringusernamestring | nullprofile_picture_urlstring | nullis_page_backedbooleansourcestringpagesarray of objectShow 4 item attributes
page_idstringnamestring | nullinstagram_business_accountobject | nullShow 3 child attributes
ig_user_idstringusernamestring | nullprofile_picture_urlstring | nullconnected_instagram_accountobject | nullShow 3 child attributes
ig_user_idstringusernamestring | nullprofile_picture_urlstring | nullresolvedobjectShow 3 child attributes
page_idstring | nullig_user_idstring | nullsourcestring | nullResponses
List Instagram posts to boost
/ads/accounts/{adAccountId}/instagram-postsTry it with MCPAsk your agent to call list-ad-instagram-posts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
ig_user_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 8 item attributes
objectstringrequiredinstagram_post
idstringcaptionstring | nullmedia_typestringmedia_urlstring | nullthumbnail_urlstring | nullpermalinkstring | nulltimestampstring (date-time) | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullig_user_idstring | nullusernamestring | nullResponses
List advertisable apps
/ads/accounts/{adAccountId}/advertisable-applicationsTry it with MCPAsk your agent to call list-advertisable-applications (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 5 item attributes
objectstringrequiredadvertisable_application
idstringnamestring | nullsupported_platformsarray of stringstore_urlsobjectpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Get iOS 14 campaign limits
/ads/accounts/{adAccountId}/ios-campaign-limitsTry it with MCPAsk your agent to call get-ios-campaign-limits (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
application_idstringrequired1–64 characters
Returns object
objectstringrequiredios_campaign_limits
application_idstringcampaign_group_limitnumber | nullcampaign_limitnumber | nulldetailsarray of objectResponses
List TikTok pixels
/ads/accounts/{adAccountId}/pixelsTikTok pixels with their supported optimization events.
Try it with MCPAsk your agent to call list-ad-pixels (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
codestring1–64 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredad_pixel
idstringcodestring | nullnamestring | nulleventsarray of stringevent_detailsarray of objectShow 3 item attributes
namestring | nulloptimization_eventstring | nullcustombooleanpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List custom conversions
/ads/accounts/{adAccountId}/custom-conversionsMeta custom conversions of the ad account, archived included.
Try it with MCPAsk your agent to call list-custom-conversions (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredcustom_conversion
idstringnamestring | nullruleobject | nullcustom_event_typestring | nullpixel_idstring | nullis_archivedbooleandefault_conversion_valuenumber | nullreusedbooleanpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a custom conversion
/ads/accounts/{adAccountId}/custom-conversionsCreates a Meta custom conversion, or returns the existing non-archived one with the same name on the same pixel (reused: true, 200).
Try it with MCPAsk your agent to call create-custom-conversion (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–100 characters
pixel_idstringrequired1–64 characters
custom_event_typestringrequired1–64 characters
ruleobjectrequireddefault_conversion_valuenumberReturns object
objectstringrequiredcustom_conversion
idstringnamestring | nullruleobject | nullcustom_event_typestring | nullpixel_idstring | nullis_archivedbooleandefault_conversion_valuenumber | nullreusedbooleanResponses
List ad labels
/ads/accounts/{adAccountId}/labelsTry it with MCPAsk your agent to call list-ad-labels (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredad_label
idstringnamestring | nullstatusstring | nullbackground_colorstring | nulldescriptionstring | nullresource_namestring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create an ad label
/ads/accounts/{adAccountId}/labelsTry it with MCPAsk your agent to call create-ad-label (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–80 characters
background_colorstringpattern ^#[0-9A-Fa-f]{6}$
descriptionstring1–200 characters
Returns object
objectstringrequiredad_label
idstringnamestring | nullstatusstring | nullbackground_colorstring | nulldescriptionstring | nullresource_namestring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Update an ad label
/ads/accounts/{adAccountId}/labels/{labelId}Try it with MCPAsk your agent to call update-ad-label (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
labelIdstringrequired1–256 characters
Body object
namestring1–80 characters
background_colorstringpattern ^#[0-9A-Fa-f]{6}$
descriptionstring1–200 characters
Returns object
objectstringrequiredad_label
idstringnamestring | nullstatusstring | nullbackground_colorstring | nulldescriptionstring | nullresource_namestring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Remove an ad label
/ads/accounts/{adAccountId}/labels/{labelId}Try it with MCPAsk your agent to call delete-ad-label (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
labelIdstringrequired1–256 characters
Returns object
objectstringrequiredad_label
idstringrequireddeletedbooleanrequiredResponses
Attach a label
/ads/accounts/{adAccountId}/labels/{labelId}/assignmentsAttaches a Google Ads label to campaigns, ad groups, ads and keywords; targets that already carry it count as unchanged.
Try it with MCPAsk your agent to call attach-ad-label (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
labelIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
campaign_idsarray of string≤ 1000 items
ad_set_idsarray of string≤ 1000 items
ad_idsarray of string≤ 1000 items
keyword_idsarray of string≤ 1000 items
Returns object
objectstringrequiredlabel_assignment_result
label_idstringattachedintegerdetachedintegerunchangedintegerResponses
Detach a label
/ads/accounts/{adAccountId}/labels/{labelId}/assignmentsTry it with MCPAsk your agent to call detach-ad-label (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
labelIdstringrequired1–256 characters
Query parameters
campaign_idsstringComma separated ids
≤ 10000 characters
ad_set_idsstringComma separated ids
≤ 10000 characters
ad_idsstringComma separated ids
≤ 10000 characters
keyword_idsstringComma separated ids
≤ 10000 characters
Returns object
objectstringrequiredlabel_assignment_result
label_idstringattachedintegerdetachedintegerunchangedintegerResponses
List high-demand periods
/ads/accounts/{adAccountId}/high-demand-periodsScheduled budget increases on a Meta campaign or ad set (exactly one of campaign_id / ad_set_id).
Try it with MCPAsk your agent to call list-high-demand-periods (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
campaign_idstring1–64 characters
ad_set_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredhigh_demand_period
idstringtarget_idstringbudget_valuenumber | nullbudget_value_typestring | nulltime_startstring (date-time) | nulltime_endstring (date-time) | nullrecurrence_typestring | nullrawobjectpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Schedule a budget increase
/ads/accounts/{adAccountId}/high-demand-periodsTry it with MCPAsk your agent to call create-high-demand-period (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
campaign_idstring1–64 characters
ad_set_idstring1–64 characters
budget_valuenumberrequiredbudget_value_typestringrequiredABSOLUTEMULTIPLIER
time_startstring | integerrequiredISO 8601 date-time or unix seconds
time_endstring | integerrequiredISO 8601 date-time or unix seconds
recurrence_typestringONE_TIMEWEEKLYMONTHLY
Returns object
objectstringrequiredhigh_demand_period
idstringtarget_idstringbudget_valuenumber | nullbudget_value_typestring | nulltime_startstring (date-time) | nulltime_endstring (date-time) | nullrecurrence_typestring | nullrawobjectResponses
List value rule sets
/ads/accounts/{adAccountId}/value-rule-setsTry it with MCPAsk your agent to call list-value-rule-sets (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 4 item attributes
objectstringrequiredvalue_rule_set
idstringnamestring | nullrulesarray of objectShow 6 item attributes
idstring | nullnamestring | nulladjust_signstring | nulladjust_valuenumber | nullstatusstring | nullcriteriaarray of objectShow 5 item attributes
idstring | nullcriteria_typestring | nulloperatorstring | nullcriteria_valuesarray of stringcriteria_value_typesarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a value rule set
/ads/accounts/{adAccountId}/value-rule-setsTry it with MCPAsk your agent to call create-value-rule-set (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–100 characters
rulesarray of objectrequired1–50 items
Show 6 item attributes
idstring | null≤ 64 characters
namestringrequired1–100 characters
adjust_signstringrequiredINCREASEDECREASE
adjust_valueintegerrequired1–1000
statusstring1–32 characters
criteriaarray of objectrequired≥ 1 items
Show 5 item attributes
idstring | null≤ 64 characters
criteria_typestringrequiredAGEGENDEROS_TYPEDEVICE_PLATFORMLOCATIONPLACEMENTOMNI_CHANNELAUDIENCE_LABEL
operatorstringCONTAINS
criteria_valuesarray of stringrequired≥ 1 items
criteria_value_typesarray of stringReturns object
objectstringrequiredvalue_rule_set
idstringnamestring | nullrulesarray of objectShow 6 item attributes
idstring | nullnamestring | nulladjust_signstring | nulladjust_valuenumber | nullstatusstring | nullcriteriaarray of objectShow 5 item attributes
idstring | nullcriteria_typestring | nulloperatorstring | nullcriteria_valuesarray of stringcriteria_value_typesarray of stringResponses
Read a value rule set
/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}Try it with MCPAsk your agent to call get-value-rule-set (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
valueRuleSetIdstringrequired1–256 characters
Returns object
objectstringrequiredvalue_rule_set
idstringnamestring | nullrulesarray of objectShow 6 item attributes
idstring | nullnamestring | nulladjust_signstring | nulladjust_valuenumber | nullstatusstring | nullcriteriaarray of objectShow 5 item attributes
idstring | nullcriteria_typestring | nulloperatorstring | nullcriteria_valuesarray of stringcriteria_value_typesarray of stringResponses
Replace a value rule set
/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}Full replace: keep a rule or criterion by echoing its id, omit it to delete it.
Try it with MCPAsk your agent to call replace-value-rule-set (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
valueRuleSetIdstringrequired1–256 characters
Body object
namestringrequired1–100 characters
rulesarray of objectrequired1–50 items
Show 6 item attributes
idstring | null≤ 64 characters
namestringrequired1–100 characters
adjust_signstringrequiredINCREASEDECREASE
adjust_valueintegerrequired1–1000
statusstring1–32 characters
criteriaarray of objectrequired≥ 1 items
Show 5 item attributes
idstring | null≤ 64 characters
criteria_typestringrequiredAGEGENDEROS_TYPEDEVICE_PLATFORMLOCATIONPLACEMENTOMNI_CHANNELAUDIENCE_LABEL
operatorstringCONTAINS
criteria_valuesarray of stringrequired≥ 1 items
criteria_value_typesarray of stringReturns object
objectstringrequiredvalue_rule_set
idstringnamestring | nullrulesarray of objectShow 6 item attributes
idstring | nullnamestring | nulladjust_signstring | nulladjust_valuenumber | nullstatusstring | nullcriteriaarray of objectShow 5 item attributes
idstring | nullcriteria_typestring | nulloperatorstring | nullcriteria_valuesarray of stringcriteria_value_typesarray of stringResponses
Delete a value rule set
/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}Try it with MCPAsk your agent to call delete-value-rule-set (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
valueRuleSetIdstringrequired1–256 characters
Returns object
objectstringrequiredvalue_rule_set
idstringrequireddeletedbooleanrequiredResponses
List negative keyword lists
/ads/accounts/{adAccountId}/negative-keyword-listsGoogle Ads shared negative keyword lists.
Try it with MCPAsk your agent to call list-negative-keyword-lists (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequirednegative_keyword_list
idstringresource_namestring | nullnamestring | nullmember_countintegerreference_countintegerkeywordsarray of objectShow 3 item attributes
criterion_idstringtextstringmatch_typestringcreatedintegerremovedintegerpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a negative keyword list
/ads/accounts/{adAccountId}/negative-keyword-listsTry it with MCPAsk your agent to call create-negative-keyword-list (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–255 characters
keywordsarray of string | object≤ 5000 items
One of 2 shapes
Option 1 string
Option 2 object
textstringrequired1–80 characters
match_typestringexactphrasebroad
Returns object
objectstringrequirednegative_keyword_list
idstringresource_namestring | nullnamestring | nullmember_countintegerreference_countintegerkeywordsarray of objectShow 3 item attributes
criterion_idstringtextstringmatch_typestringcreatedintegerremovedintegerResponses
Get a negative keyword list
/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}Try it with MCPAsk your agent to call get-negative-keyword-list (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
listIdstringrequired1–256 characters
Returns object
objectstringrequirednegative_keyword_list
idstringresource_namestring | nullnamestring | nullmember_countintegerreference_countintegerkeywordsarray of objectShow 3 item attributes
criterion_idstringtextstringmatch_typestringcreatedintegerremovedintegerResponses
Rename a negative keyword list
/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}Try it with MCPAsk your agent to call rename-negative-keyword-list (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
listIdstringrequired1–256 characters
Body object
namestringrequired1–255 characters
Returns object
objectstringrequirednegative_keyword_list
idstringresource_namestring | nullnamestring | nullmember_countintegerreference_countintegerkeywordsarray of objectShow 3 item attributes
criterion_idstringtextstringmatch_typestringcreatedintegerremovedintegerResponses
Delete a negative keyword list
/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}Try it with MCPAsk your agent to call delete-negative-keyword-list (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
listIdstringrequired1–256 characters
Returns object
objectstringrequirednegative_keyword_list
idstringrequireddeletedbooleanrequiredResponses
Replace negative list keywords
/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}/keywordsDiffs by normalized text + match type; [] clears the list. Affects every campaign using it.
Try it with MCPAsk your agent to call replace-negative-keyword-list-keywords (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
listIdstringrequired1–256 characters
Body object
keywordsarray of string | objectrequired≤ 5000 items
One of 2 shapes
Option 1 string
Option 2 object
textstringrequired1–80 characters
match_typestringexactphrasebroad
Returns object
objectstringrequirednegative_keyword_list
idstringresource_namestring | nullnamestring | nullmember_countintegerreference_countintegerkeywordsarray of objectShow 3 item attributes
criterion_idstringtextstringmatch_typestringcreatedintegerremovedintegerResponses
List account callouts
/ads/accounts/{adAccountId}/calloutsGoogle Ads callouts attached at account level.
Try it with MCPAsk your agent to call list-account-callouts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredcallout
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nulltextstringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Add account callouts
/ads/accounts/{adAccountId}/calloutsTry it with MCPAsk your agent to call add-account-callouts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
calloutsarray of stringrequired1–20 items
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredcallout
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nulltextstringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Update account callouts
/ads/accounts/{adAccountId}/calloutsEdits existing callout assets in place (shared assets change everywhere they are used).
Try it with MCPAsk your agent to call update-account-callouts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
updatesarray of objectrequired≥ 1 items
Show 2 item attributes
asset_idstringrequired1–32 characters
textstringrequired1–25 characters
Returns object
objectstringrequiredasset_update_result
updatedintegerResponses
Remove an account callout
/ads/accounts/{adAccountId}/callouts/{assetId}Detaches it from the account level only; campaign and ad group attachments stay.
Try it with MCPAsk your agent to call remove-account-callout (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
assetIdstringrequired1–256 characters
Returns object
objectstringrequiredcallout
idstringrequireddeletedbooleanrequiredResponses
List account sitelinks
/ads/accounts/{adAccountId}/sitelinksGoogle Ads sitelinks attached at account level.
Try it with MCPAsk your agent to call list-account-sitelinks (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredsitelink
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nulltextstringlink_urlstring | nulldescription1string | nulldescription2string | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Add account sitelinks
/ads/accounts/{adAccountId}/sitelinksTry it with MCPAsk your agent to call add-account-sitelinks (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sitelinksarray of objectrequired1–20 items
Show 4 item attributes
textstringrequired1–25 characters
link_urlstring (uri)required≤ 2048 characters
description1string1–35 characters
description2string1–35 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredsitelink
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nulltextstringlink_urlstring | nulldescription1string | nulldescription2string | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Update account sitelinks
/ads/accounts/{adAccountId}/sitelinksEdits existing sitelink assets in place (shared assets change everywhere they are used).
Try it with MCPAsk your agent to call update-account-sitelinks (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
updatesarray of objectrequired≥ 1 items
Show 5 item attributes
asset_idstringrequired1–32 characters
textstring1–25 characters
link_urlstring (uri)≤ 2048 characters
description1string1–35 characters
description2string1–35 characters
Returns object
objectstringrequiredasset_update_result
updatedintegerResponses
Remove an account sitelink
/ads/accounts/{adAccountId}/sitelinks/{assetId}Detaches it from the account level only; campaign and ad group attachments stay.
Try it with MCPAsk your agent to call remove-account-sitelink (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
assetIdstringrequired1–256 characters
Returns object
objectstringrequiredsitelink
idstringrequireddeletedbooleanrequiredResponses
List account structured snippets
/ads/accounts/{adAccountId}/structured-snippetsGoogle Ads structured snippets attached at account level.
Try it with MCPAsk your agent to call list-account-structured-snippets (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 7 item attributes
objectstringrequiredstructured_snippet
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nullheaderstringvaluesarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Add account structured snippets
/ads/accounts/{adAccountId}/structured-snippetsTry it with MCPAsk your agent to call add-account-structured-snippets (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
structured_snippetsarray of objectrequired1–20 items
Show 2 item attributes
headerstringrequiredAmenitiesBrandsCoursesDegree programsDestinationsFeatured hotelsInsurance coverageModelsNeighborhoodsService catalogShowsStylesTypes
valuesarray of stringrequired3–10 items
Returns object
objectstringlist
dataarray of objectShow 7 item attributes
objectstringrequiredstructured_snippet
idstringstatusstring | nullresource_namestring | nullcustomer_asset_resource_namestring | nullheaderstringvaluesarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Update account structured snippets
/ads/accounts/{adAccountId}/structured-snippetsEdits existing structured snippet assets in place (shared assets change everywhere they are used).
Try it with MCPAsk your agent to call update-account-structured-snippets (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
updatesarray of objectrequired≥ 1 items
Show 3 item attributes
asset_idstringrequired1–32 characters
headerstringAmenitiesBrandsCoursesDegree programsDestinationsFeatured hotelsInsurance coverageModelsNeighborhoodsService catalogShowsStylesTypes
valuesarray of string3–10 items
Returns object
objectstringrequiredasset_update_result
updatedintegerResponses
Remove an account structured snippet
/ads/accounts/{adAccountId}/structured-snippets/{assetId}Detaches it from the account level only; campaign and ad group attachments stay.
Try it with MCPAsk your agent to call remove-account-structured-snippet (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
assetIdstringrequired1–256 characters
Returns object
objectstringrequiredstructured_snippet
idstringrequireddeletedbooleanrequiredResponses
List tracking tags
/ads/accounts/{adAccountId}/tracking-tagsPixels and measurement tags of the ad account (install code omitted).
Try it with MCPAsk your agent to call list-tracking-tags (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 16 item attributes
objectstringrequiredtracking_tag
idstringsite_tag_idstring | nullplatformstringkindstringnamestring | nullstatusstringcodestring | nulllast_fired_atstring (date-time) | nullis_unavailablebooleancreated_atstring (date-time) | nullautomatic_matching_fieldsarray of stringowner_business_idstring | nullowner_ad_account_idstring | nullauto_taggingboolean | nulleventsarray of objectShow 15 item attributes
objectstringtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a tracking tag
/ads/accounts/{adAccountId}/tracking-tagsNot idempotent on the networks: send an Idempotency-Key and never retry blindly.
Try it with MCPAsk your agent to call create-tracking-tag (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–100 characters
automatic_matching_fieldsarray of stringdefault_event_typestring1–64 characters
domainstring1–255 characters
partner_namestring1–64 characters
Returns object
objectstringrequiredtracking_tag
idstringsite_tag_idstring | nullplatformstringkindstringnamestring | nullstatusstringcodestring | nulllast_fired_atstring (date-time) | nullis_unavailablebooleancreated_atstring (date-time) | nullautomatic_matching_fieldsarray of stringowner_business_idstring | nullowner_ad_account_idstring | nullauto_taggingboolean | nulleventsarray of objectShow 15 item attributes
objectstringtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullResponses
Get a tracking tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}The tag with its install code and conversion events.
Try it with MCPAsk your agent to call get-tracking-tag (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Returns object
objectstringrequiredtracking_tag
idstringsite_tag_idstring | nullplatformstringkindstringnamestring | nullstatusstringcodestring | nulllast_fired_atstring (date-time) | nullis_unavailablebooleancreated_atstring (date-time) | nullautomatic_matching_fieldsarray of stringowner_business_idstring | nullowner_ad_account_idstring | nullauto_taggingboolean | nulleventsarray of objectShow 15 item attributes
objectstringtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullResponses
Update a tracking tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}Try it with MCPAsk your agent to call update-tracking-tag (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Body object
namestring1–100 characters
enable_automatic_matchingbooleanautomatic_matching_fieldsarray of stringfirst_party_cookie_statusstringemptyfirst_party_cookie_disabledfirst_party_cookie_enabled
data_use_settingstringadvertising_and_analyticsanalytics_onlyempty
auto_taggingbooleanReturns object
objectstringrequiredtracking_tag
idstringsite_tag_idstring | nullplatformstringkindstringnamestring | nullstatusstringcodestring | nulllast_fired_atstring (date-time) | nullis_unavailablebooleancreated_atstring (date-time) | nullautomatic_matching_fieldsarray of stringowner_business_idstring | nullowner_ad_account_idstring | nullauto_taggingboolean | nulleventsarray of objectShow 15 item attributes
objectstringtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullResponses
List accounts a tag is shared with
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accountsTry it with MCPAsk your agent to call list-tracking-tag-shared-accounts (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Query parameters
business_idstring1–64 characters
Returns object
objectstringlist
dataarray of objectShow 5 item attributes
objectstringrequiredtracking_tag_shared_account
idstringnamestring | nullbusiness_idstring | nullrolestring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Share a tag with an ad account
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accountsTry it with MCPAsk your agent to call share-tracking-tag (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringrequired1–256 characters
business_idstring1–64 characters
Returns object
objectstringrequiredtracking_tag_shared_account
idstringnamestring | nullbusiness_idstring | nullrolestring | nullResponses
Stop sharing a tag with an account
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts/{sharedAccountId}Try it with MCPAsk your agent to call unshare-tracking-tag (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
sharedAccountIdstringrequired1–256 characters
Query parameters
business_idstring1–64 characters
Returns object
objectstringrequiredtracking_tag_shared_account
idstringrequireddeletedbooleanrequiredResponses
List conversion events of a tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/eventsTry it with MCPAsk your agent to call list-tracking-tag-events (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 15 item attributes
objectstringrequiredtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a conversion event
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/eventsNot idempotent on the networks. A field the network does not store → 422.
Try it with MCPAsk your agent to call create-tracking-tag-event (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–100 characters
typestring1–64 characters
site_eventstringpage_viewview_contentadd_to_cartsearchinitiate_checkoutadd_payment_infopurchase
enabledbooleandefault_valuenumbercurrencystringpattern ^[A-Za-z]{3}$
click_window_daysinteger1–365
view_window_daysinteger0–365
url_containsstring1–500 characters
counting_typestringoneevery
Returns object
objectstringrequiredtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullResponses
Update a conversion event
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}Try it with MCPAsk your agent to call update-tracking-tag-event (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
eventIdstringrequired1–256 characters
Body object
namestring1–100 characters
typestring1–64 characters
site_eventstringpage_viewview_contentadd_to_cartsearchinitiate_checkoutadd_payment_infopurchase
enabledbooleandefault_valuenumbercurrencystringpattern ^[A-Za-z]{3}$
click_window_daysinteger1–365
view_window_daysinteger0–365
url_containsstring1–500 characters
counting_typestringoneevery
Returns object
objectstringrequiredtracking_tag_event
idstringnamestringtypestring | nullsite_eventstring | nullsite_event_idstring | nullstatusstring | nulldefault_valuenumber | nullcurrencystring | nullclick_window_daysnumber | nullview_window_daysnumber | nullurl_containsstring | nullalways_use_default_valueboolean | nullprimaryboolean | nullcounting_typestring | nullResponses
Delete a conversion event
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}Archives or disables it on networks without a hard delete (state).
Try it with MCPAsk your agent to call delete-tracking-tag-event (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
eventIdstringrequired1–256 characters
Returns object
objectstringtracking_tag_event
idstringdeletedbooleanstatestringResponses
List tag users
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/usersTry it with MCPAsk your agent to call list-tracking-tag-users (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 4 item attributes
objectstringrequiredtracking_tag_user
idstringnamestring | nulltasksarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Assign a user to a tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/usersTry it with MCPAsk your agent to call assign-tracking-tag-user (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringrequired1–64 characters
tasksarray of stringrequired≥ 1 items
business_idstring1–64 characters
Returns object
objectstringrequiredtracking_tag_user
idstringnamestring | nulltasksarray of stringResponses
Remove a user from a tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users/{userId}Try it with MCPAsk your agent to call remove-tracking-tag-user (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
userIdstringrequired1–256 characters
Returns object
objectstringrequiredtracking_tag_user
idstringrequireddeletedbooleanrequiredResponses
List partner businesses of a tag
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/partnersTry it with MCPAsk your agent to call list-tracking-tag-partners (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 3 item attributes
objectstringrequiredtracking_tag_partner
idstringnamestring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Get tag diagnostics
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/diagnosticsTry it with MCPAsk your agent to call get-tracking-tag-diagnostics (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredtracking_tag_diagnostic
keystringtitlestringdescriptionstring | nullresultstringaction_urlstring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Get aggregated tag stats
/ads/accounts/{adAccountId}/tracking-tags/{tagId}/statsTry it with MCPAsk your agent to call get-tracking-tag-stats (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
tagIdstringrequired1–256 characters
Query parameters
aggregationstringeventhosturlurl_by_rulepixel_firedevice_typedevice_osbrowser_typehad_piicustom_data_fieldmatch_keysevent_sourceevent_detection_methodevent_processing_resultsevent_total_countsevent_value_count
start_timestring | integerISO 8601 date-time or unix seconds
end_timestring | integerISO 8601 date-time or unix seconds
Returns object
objectstringrequiredtracking_tag_stats
tag_idstringplatformstringaggregationstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullrowsarray of objectResponses
List conversion actions
/ads/accounts/{adAccountId}/conversion-actionsGoogle Ads conversion actions with their tag snippets.
Try it with MCPAsk your agent to call list-conversion-actions (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
typestring1–64 characters
Returns object
objectstringlist
dataarray of objectShow 16 item attributes
objectstringrequiredconversion_action
idstringnamestring | nulltypestring | nullstatusstring | nullcategorystring | nulloriginstring | nullprimary_for_goalboolean | nulldefault_valuenumber | nulldefault_currencystring | nullalways_use_default_valueboolean | nullcounting_typestring | nullclick_through_lookback_window_daysnumber | nullview_through_lookback_window_daysnumber | nullresource_namestring | nulltag_snippetsarray of objectShow 4 item attributes
typestring | nullpage_formatstring | nullglobal_site_tagstring | nullevent_snippetstring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a website conversion action
/ads/accounts/{adAccountId}/conversion-actionsTry it with MCPAsk your agent to call create-conversion-action (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–255 characters
categorystringDEFAULTPAGE_VIEWPURCHASESIGNUPDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORMBOOK_APPOINTMENTREQUEST_QUOTEGET_DIRECTIONSOUTBOUND_CLICKCONTACTENGAGEMENTSTORE_VISITSTORE_SALEQUALIFIED_LEADCONVERTED_LEAD
default_valuenumberdefault_currencystringpattern ^[A-Za-z]{3}$
always_use_default_valuebooleancounting_typestringONE_PER_CLICKMANY_PER_CLICK
click_through_lookback_window_daysinteger1–90
view_through_lookback_window_daysinteger1–30
primary_for_goalbooleantypestringWEBPAGE
Returns object
objectstringrequiredconversion_action
idstringnamestring | nulltypestring | nullstatusstring | nullcategorystring | nulloriginstring | nullprimary_for_goalboolean | nulldefault_valuenumber | nulldefault_currencystring | nullalways_use_default_valueboolean | nullcounting_typestring | nullclick_through_lookback_window_daysnumber | nullview_through_lookback_window_daysnumber | nullresource_namestring | nulltag_snippetsarray of objectShow 4 item attributes
typestring | nullpage_formatstring | nullglobal_site_tagstring | nullevent_snippetstring | nullResponses
Update a conversion action
/ads/accounts/{adAccountId}/conversion-actions/{actionId}Try it with MCPAsk your agent to call update-conversion-action (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
actionIdstringrequired1–256 characters
Body object
namestring1–255 characters
categorystringDEFAULTPAGE_VIEWPURCHASESIGNUPDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORMBOOK_APPOINTMENTREQUEST_QUOTEGET_DIRECTIONSOUTBOUND_CLICKCONTACTENGAGEMENTSTORE_VISITSTORE_SALEQUALIFIED_LEADCONVERTED_LEAD
default_valuenumberdefault_currencystringpattern ^[A-Za-z]{3}$
always_use_default_valuebooleancounting_typestringONE_PER_CLICKMANY_PER_CLICK
click_through_lookback_window_daysinteger1–90
view_through_lookback_window_daysinteger1–30
primary_for_goalbooleanstatusstringENABLEDREMOVED
Returns object
objectstringrequiredconversion_action
idstringnamestring | nulltypestring | nullstatusstring | nullcategorystring | nulloriginstring | nullprimary_for_goalboolean | nulldefault_valuenumber | nulldefault_currencystring | nullalways_use_default_valueboolean | nullcounting_typestring | nullclick_through_lookback_window_daysnumber | nullview_through_lookback_window_daysnumber | nullresource_namestring | nulltag_snippetsarray of objectShow 4 item attributes
typestring | nullpage_formatstring | nullglobal_site_tagstring | nullevent_snippetstring | nullResponses
List account conversion goals
/ads/accounts/{adAccountId}/conversion-goalsTry it with MCPAsk your agent to call list-conversion-goals (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredconversion_goal
categorystring | nulloriginstring | nullbiddablebooleanresource_namestring | nullconversion_actionsarray of objectShow 4 item attributes
idstringnamestring | nullstatusstring | nullprimary_for_goalbooleanpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Update account conversion goals
/ads/accounts/{adAccountId}/conversion-goalsTry it with MCPAsk your agent to call update-conversion-goals (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Body object
goalsarray of objectrequired1–100 items
Show 3 item attributes
categorystringrequired1–64 characters
originstringrequired1–64 characters
biddablebooleanrequiredReturns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredconversion_goal
categorystring | nulloriginstring | nullbiddablebooleanresource_namestring | nullconversion_actionsarray of objectShow 4 item attributes
idstringnamestring | nullstatusstring | nullprimary_for_goalbooleanpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
List custom conversion goals
/ads/accounts/{adAccountId}/custom-conversion-goalsTry it with MCPAsk your agent to call list-custom-conversion-goals (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredcustom_conversion_goal
idstringresource_namestring | nullnamestring | nullstatusstring | nullconversion_action_idsarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a custom conversion goal
/ads/accounts/{adAccountId}/custom-conversion-goalsTry it with MCPAsk your agent to call create-custom-conversion-goal (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–255 characters
conversion_action_idsarray of stringrequired1–100 items
Returns object
objectstringrequiredcustom_conversion_goal
idstringresource_namestring | nullnamestring | nullstatusstring | nullconversion_action_idsarray of stringResponses
Update a custom conversion goal
/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}Try it with MCPAsk your agent to call update-custom-conversion-goal (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
goalIdstringrequired1–256 characters
Body object
namestring1–255 characters
conversion_action_idsarray of string1–100 items
Returns object
objectstringrequiredcustom_conversion_goal
idstringresource_namestring | nullnamestring | nullstatusstring | nullconversion_action_idsarray of stringResponses
Remove a custom conversion goal
/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}Try it with MCPAsk your agent to call delete-custom-conversion-goal (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
goalIdstringrequired1–256 characters
Returns object
objectstringrequiredcustom_conversion_goal
idstringrequireddeletedbooleanrequiredResponses
List conversion destinations
/ads/accounts/{adAccountId}/conversion-destinationsWhere the ad account can receive conversion events (pixels, conversion actions, conversion rules, …): use id as destination_id.
Try it with MCPAsk your agent to call list-conversion-destinations (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Query parameters
include_inactivebooleanReturns object
objectstringlist
dataarray of objectShow 14 item attributes
objectstringrequiredconversion_destination
idstringnamestring | nulltypestring | nullstatusstringplatformstringad_account_idstring | nullconversion_eventsarray of objectShow 6 item attributes
idstringnamestring | nullevent_typestring | nullcustom_event_namestring | nullarchivedbooleanoptimizablebooleanattribution_typestring | nullpost_click_attribution_window_sizenumber | nullview_through_attribution_window_sizenumber | nullvalue_typestring | nullvalueobject | nullShow 2 child attributes
currency_codestring | nullamountstring | nullenabledboolean | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a conversion destination
/ads/accounts/{adAccountId}/conversion-destinationsLinkedIn conversion rule (not idempotent) or Google Ads conversion action (reused by name).
Try it with MCPAsk your agent to call create-conversion-destination (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–255 characters
attribution_typestringLAST_TOUCH_BY_CAMPAIGNLAST_TOUCH_BY_CONVERSION
post_click_attribution_window_sizeinteger173090365
view_through_attribution_window_sizeinteger173090365
value_typestringDYNAMICFIXEDNO_VALUE
valueobjectShow 2 child attributes
currency_codestringrequiredpattern ^[A-Za-z]{3}$
amountstring | numberrequiredtypestringrequired1–64 characters
auto_association_typestringALL_CAMPAIGNSOBJECTIVE_BASEDNONE
counting_typestringMANY_PER_CLICKONE_PER_CLICK
primary_for_goalbooleanReturns object
objectstringrequiredconversion_destination
idstringnamestring | nulltypestring | nullstatusstringplatformstringad_account_idstring | nullconversion_eventsarray of objectShow 6 item attributes
idstringnamestring | nullevent_typestring | nullcustom_event_namestring | nullarchivedbooleanoptimizablebooleanattribution_typestring | nullpost_click_attribution_window_sizenumber | nullview_through_attribution_window_sizenumber | nullvalue_typestring | nullvalueobject | nullShow 2 child attributes
currency_codestring | nullamountstring | nullenabledboolean | nullResponses
Get a conversion destination
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}Try it with MCPAsk your agent to call get-conversion-destination (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Returns object
objectstringrequiredconversion_destination
idstringnamestring | nulltypestring | nullstatusstringplatformstringad_account_idstring | nullconversion_eventsarray of objectShow 6 item attributes
idstringnamestring | nullevent_typestring | nullcustom_event_namestring | nullarchivedbooleanoptimizablebooleanattribution_typestring | nullpost_click_attribution_window_sizenumber | nullview_through_attribution_window_sizenumber | nullvalue_typestring | nullvalueobject | nullShow 2 child attributes
currency_codestring | nullamountstring | nullenabledboolean | nullResponses
Update a conversion destination
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}Try it with MCPAsk your agent to call update-conversion-destination (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Body object
namestring1–255 characters
attribution_typestringLAST_TOUCH_BY_CAMPAIGNLAST_TOUCH_BY_CONVERSION
post_click_attribution_window_sizeinteger173090365
view_through_attribution_window_sizeinteger173090365
value_typestringDYNAMICFIXEDNO_VALUE
valueobjectShow 2 child attributes
currency_codestringrequiredpattern ^[A-Za-z]{3}$
amountstring | numberrequiredenabledbooleanReturns object
objectstringrequiredconversion_destination
idstringnamestring | nulltypestring | nullstatusstringplatformstringad_account_idstring | nullconversion_eventsarray of objectShow 6 item attributes
idstringnamestring | nullevent_typestring | nullcustom_event_namestring | nullarchivedbooleanoptimizablebooleanattribution_typestring | nullpost_click_attribution_window_sizenumber | nullview_through_attribution_window_sizenumber | nullvalue_typestring | nullvalueobject | nullShow 2 child attributes
currency_codestring | nullamountstring | nullenabledboolean | nullResponses
Delete (disable) a conversion destination
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}Try it with MCPAsk your agent to call delete-conversion-destination (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Returns object
objectstringconversion_destination
idstringdeletedbooleanstatestringResponses
List associated campaigns
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associationsTry it with MCPAsk your agent to call list-conversion-associations (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Returns object
objectstringlist
dataarray of objectShow 4 item attributes
objectstringrequiredconversion_association
campaign_idstringconversion_idstringassociated_atstring (date-time) | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Associate campaigns
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associationsTry it with MCPAsk your agent to call add-conversion-associations (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
campaign_idsarray of stringrequired1–500 items
Returns object
objectstringrequiredconversion_association_result
succeededarray of stringfailedarray of objectShow 2 item attributes
campaign_idstringreasonstringResponses
Remove associated campaigns
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associationsTry it with MCPAsk your agent to call remove-conversion-associations (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Query parameters
campaign_idsstringrequiredComma separated ids
≤ 10000 characters
Returns object
objectstringrequiredconversion_association_result
succeededarray of stringfailedarray of objectShow 2 item attributes
campaign_idstringreasonstringResponses
Get attribution metrics
/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/metricsTry it with MCPAsk your agent to call get-conversion-metrics (toolset ads_measurement)Set up MCP
Path parameters
adAccountIdstringrequiredAd account id (ada_…)
1–80 characters
destinationIdstringrequired1–256 characters
Query parameters
start_datestringrequiredYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
end_datestringYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
granularitystringALLDAILYMONTHLYYEARLY
Returns object
objectstringrequiredconversion_metrics
destination_idstringgranularitystringrowsarray of objectShow 3 item attributes
startstring | nullendstring | nullmetricsobjectShow 6 child attributes
external_website_conversionsnumberexternal_website_post_click_conversionsnumberexternal_website_post_view_conversionsnumberconversion_value_in_local_currencynumberqualified_leadsnumbercost_in_local_currencynumberResponses
Comments
List comments on an ad
/ads/{adId}/commentsComments on the ad’s post, dark posts included (Meta: Facebook or Instagram placement; TikTok).
Try it with MCPAsk your agent to call list-ad-comments (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
placementstringfacebookinstagram
sincestringYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
untilstringYYYY-MM-DD
pattern ^\d{4}-\d{2}-\d{2}$
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 15 item attributes
objectstringrequiredad_comment
idstringad_idstringplatformstringplacementstring | nullparent_idstring | nulltextstringauthorobjectShow 3 child attributes
idstring | nullnamestring | nullusernamestring | nulllike_countintegerreply_countintegerhiddenbooleancan_replybooleancan_hidebooleancan_deletebooleancreated_atstring (date-time) | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Reply to an ad comment
/ads/{adId}/comments/{commentId}/replyTry it with MCPAsk your agent to call reply-ad-comment (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
commentIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
textstringrequired1–500 characters
placementstringfacebookinstagram
Returns object
objectstringrequiredad_comment
idstringad_idstringplatformstringplacementstring | nullparent_idstring | nulltextstringauthorobjectShow 3 child attributes
idstring | nullnamestring | nullusernamestring | nulllike_countintegerreply_countintegerhiddenbooleancan_replybooleancan_hidebooleancan_deletebooleancreated_atstring (date-time) | nullResponses
Hide or unhide an ad comment
/ads/{adId}/comments/{commentId}/hideTry it with MCPAsk your agent to call hide-ad-comment (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
commentIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
hiddenbooleanrequiredplacementstringfacebookinstagram
Returns object
objectstringrequiredad_comment
idstringhiddenbooleanResponses
Delete an ad comment
/ads/{adId}/comments/{commentId}Try it with MCPAsk your agent to call delete-ad-comment (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
commentIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
placementstringfacebookinstagram
Returns object
objectstringrequiredad_comment
idstringrequireddeletedbooleanrequiredResponses
Tracking tags
Get ad URL tracking params
/ads/{adId}/tracking-tagsClick-URL tracking parameters (UTMs), not pixels: Meta creative url_tags, Google campaign tracking template / final URL suffix, LinkedIn Dynamic UTMs.
Try it with MCPAsk your agent to call get-ad-tracking-params (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
campaign_idstring1–64 characters
Returns object
objectstringrequiredad_tracking_params
ad_idstringplatformstringlevelstringurl_tagsstring | nulltemplate_url_specobject | nulltracking_url_templatestring | nullfinal_url_suffixstring | nulldynamic_value_parametersobject | nullcustom_value_parametersobject | nullResponses
Set ad URL tracking params
/ads/{adId}/tracking-tagsMeta rebuilds the (immutable) creative with the new url_tags and repoints the ad.
Try it with MCPAsk your agent to call set-ad-tracking-params (toolset ads_measurement)Set up MCP
Path parameters
adIdstringrequired1–256 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
campaign_idstring1–64 characters
url_tagsarray of object≤ 50 items
Show 2 item attributes
keystringrequired1–100 characters
valuestringrequired≤ 500 characters
creativeobjectShow 7 child attributes
headlinestringrequired1–255 characters
bodystringrequired≤ 5000 characters
call_to_actionstringrequired1–64 characters
link_urlstring (uri)required≤ 2048 characters
image_urlstring (uri)≤ 2048 characters
video_urlstring (uri)≤ 2048 characters
video_idstring1–64 characters
tracking_url_templatestring≤ 2048 characters
final_url_suffixstring≤ 2048 characters
dynamic_value_parametersmap of stringcustom_value_parametersmap of stringReturns object
objectstringrequiredad_tracking_params
ad_idstringplatformstringlevelstringurl_tagsstring | nulltemplate_url_specobject | nulltracking_url_templatestring | nullfinal_url_suffixstring | nulldynamic_value_parametersobject | nullcustom_value_parametersobject | nullResponses
Leads
List leads
/ads/leadsStored lead-gen submissions (leadgen webhooks, live form reads, LinkedIn polling).
Try it with MCPAsk your agent to call list-leads (toolset ads_measurement)Set up MCP
Query parameters
pageintegerdefault: 1≥ 1
limitintegerdefault: 201–100
ad_account_idstring1–80 characters
connection_idstring1–80 characters
form_idstring1–64 characters
platformstring1–40 characters
ad_idstring1–64 characters
campaign_idstring1–64 characters
is_testbooleanis_organicbooleansourcestringwebhooksyncapi
sincestring1–40 characters
untilstring1–40 characters
sortstringsubmitted_atcreated_at
orderstringascdesc
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
objectstringrequiredlead
idstringexternal_idstringplatformstringconnection_idstring | nullad_account_idstring | nullprofile_idstring | nullcontact_idstring | nullform_idstring | nullform_namestring | nullpage_idstring | nullad_idstring | nullad_set_idstring | nullcampaign_idstring | nullis_organicbooleanis_testbooleanfieldsmap of stringfield_dataarray of objectShow 2 item attributes
namestringvaluesarray of stringsourcestringsubmitted_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Get a lead
/ads/leads/{leadId}Try it with MCPAsk your agent to call get-lead (toolset ads_measurement)Set up MCP
Path parameters
leadIdstringrequired1–80 characters
Returns object
objectstringrequiredlead
idstringexternal_idstringplatformstringconnection_idstring | nullad_account_idstring | nullprofile_idstring | nullcontact_idstring | nullform_idstring | nullform_namestring | nullpage_idstring | nullad_idstring | nullad_set_idstring | nullcampaign_idstring | nullis_organicbooleanis_testbooleanfieldsmap of stringfield_dataarray of objectShow 2 item attributes
namestringvaluesarray of stringsourcestringsubmitted_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Lead forms
List lead forms
/ads/lead-formsMeta instant forms of a Page, LinkedIn Lead Gen Forms of a sponsored account.
Try it with MCPAsk your agent to call list-lead-forms (toolset ads_measurement)Set up MCP
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
statusstring1–32 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 17 item attributes
objectstringrequiredlead_form
idstringplatformstringnamestring | nullstatusstring | nulllocalestring | nullpage_idstring | nullad_account_idstring | nullleads_countinteger | nullprivacy_policy_urlstring | nullfollow_up_action_urlstring | nullheadlinestring | nulldescriptionstring | nullquestionsarray of objectShow 5 item attributes
idstring | nullkeystring | nulllabelstring | nulltypestring | nulloptionsarray of objectShow 2 item attributes
valuestring | nullkeystring | nullthank_you_pageobject | nullShow 5 child attributes
titlestring | nullbodystring | nullbutton_textstring | nullbutton_typestring | nullwebsite_urlstring | nullcreated_atstring (date-time) | nullrawobjectpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a lead form
/ads/lead-formsTry it with MCPAsk your agent to call create-lead-form (toolset ads_measurement)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
namestringrequired1–255 characters
page_idstring1–64 characters
questionsarray of objectrequired1–30 items
Show 5 item attributes
typestringrequired1–64 characters
keystring1–100 characters
labelstring1–500 characters
inline_contextstring1–500 characters
optionsarray of object≤ 50 items
Show 2 item attributes
valuestringrequired1–200 characters
keystring1–100 characters
privacy_policy_urlstring (uri)required≤ 2048 characters
privacy_policy_link_textstring1–70 characters
follow_up_action_urlstring (uri)≤ 2048 characters
localestringpattern ^[a-z]{2}_[A-Z]{2}$
thank_you_titlestring1–60 characters
thank_you_bodystring1–500 characters
thank_you_button_textstring1–60 characters
thank_you_button_typestring1–64 characters
thank_you_website_urlstring (uri)≤ 2048 characters
is_optimized_for_qualitybooleanheadlinestring1–60 characters
descriptionstring1–160 characters
statestringDRAFTPUBLISHED
platform_dataobjectReturns object
objectstringrequiredlead_form
idstringplatformstringnamestring | nullstatusstring | nulllocalestring | nullpage_idstring | nullad_account_idstring | nullleads_countinteger | nullprivacy_policy_urlstring | nullfollow_up_action_urlstring | nullheadlinestring | nulldescriptionstring | nullquestionsarray of objectShow 5 item attributes
idstring | nullkeystring | nulllabelstring | nulltypestring | nulloptionsarray of objectShow 2 item attributes
valuestring | nullkeystring | nullthank_you_pageobject | nullShow 5 child attributes
titlestring | nullbodystring | nullbutton_textstring | nullbutton_typestring | nullwebsite_urlstring | nullcreated_atstring (date-time) | nullrawobjectResponses
Get a lead form
/ads/lead-forms/{formId}Try it with MCPAsk your agent to call get-lead-form (toolset ads_measurement)Set up MCP
Path parameters
formIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
Returns object
objectstringrequiredlead_form
idstringplatformstringnamestring | nullstatusstring | nulllocalestring | nullpage_idstring | nullad_account_idstring | nullleads_countinteger | nullprivacy_policy_urlstring | nullfollow_up_action_urlstring | nullheadlinestring | nulldescriptionstring | nullquestionsarray of objectShow 5 item attributes
idstring | nullkeystring | nulllabelstring | nulltypestring | nulloptionsarray of objectShow 2 item attributes
valuestring | nullkeystring | nullthank_you_pageobject | nullShow 5 child attributes
titlestring | nullbodystring | nullbutton_textstring | nullbutton_typestring | nullwebsite_urlstring | nullcreated_atstring (date-time) | nullrawobjectResponses
Archive a lead form
/ads/lead-forms/{formId}Try it with MCPAsk your agent to call archive-lead-form (toolset ads_measurement)Set up MCP
Path parameters
formIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
Returns object
objectstringlead_form
idstringarchivedbooleandeletedbooleanResponses
List the leads of a form
/ads/lead-forms/{formId}/leadsReads the form’s leads live and stores them (new leads emit lead.received).
Try it with MCPAsk your agent to call list-lead-form-leads (toolset ads_measurement)Set up MCP
Path parameters
formIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
sincestring | integerISO 8601 date-time or unix seconds
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 22 item attributes
objectstringrequiredlead
idstringexternal_idstringplatformstringconnection_idstring | nullad_account_idstring | nullprofile_idstring | nullcontact_idstring | nullform_idstring | nullform_namestring | nullpage_idstring | nullad_idstring | nullad_set_idstring | nullcampaign_idstring | nullis_organicbooleanis_testbooleanfieldsmap of stringfield_dataarray of objectShow 2 item attributes
namestringvaluesarray of stringsourcestringsubmitted_atstring (date-time) | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a test lead
/ads/lead-forms/{formId}/test-leadsTry it with MCPAsk your agent to call create-test-lead (toolset ads_measurement)Set up MCP
Path parameters
formIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
field_dataarray of objectrequired1–50 items
Show 2 item attributes
namestringrequired1–100 characters
valuesarray of stringrequired≥ 1 items
Returns object
objectstringrequiredtest_lead
idstringform_idstringResponses
Delete test leads
/ads/lead-forms/{formId}/test-leadsTry it with MCPAsk your agent to call delete-test-leads (toolset ads_measurement)Set up MCP
Path parameters
formIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
page_idstring1–64 characters
lead_idstring1–64 characters
Returns object
objectstringtest_lead
deletedbooleanidsarray of stringResponses
Catalogs
List product catalogs
/ads/catalogsMeta Commerce catalogs owned by (or shared with) a business portfolio.
Try it with MCPAsk your agent to call list-catalogs (toolset ads_measurement)Set up MCP
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 6 item attributes
objectstringrequiredcatalog
idstringnamestring | nullverticalstring | nullproduct_countinteger | nullbusiness_idstring | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullbusiness_idstring | nullResponses
Create a product catalog
/ads/catalogsTry it with MCPAsk your agent to call create-catalog (toolset ads_measurement)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
namestringrequired1–200 characters
verticalstringcommercevehicleshotelsflightsdestinationshome_listingslocal_service_businessoffline_commerceticketed_experiencestransactable_items
Returns object
objectstringrequiredcatalog
idstringnamestring | nullverticalstring | nullproduct_countinteger | nullbusiness_idstring | nullResponses
Get a product catalog
/ads/catalogs/{catalogId}Try it with MCPAsk your agent to call get-catalog (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredcatalog
idstringnamestring | nullverticalstring | nullproduct_countinteger | nullbusiness_idstring | nullResponses
Delete a product catalog
/ads/catalogs/{catalogId}Try it with MCPAsk your agent to call delete-catalog (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredcatalog
idstringrequireddeletedbooleanrequiredResponses
List catalog products
/ads/catalogs/{catalogId}/productsTry it with MCPAsk your agent to call list-catalog-products (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
retailer_idstring1–100 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 27 item attributes
objectstringrequiredcatalog_product
idstringretailer_idstring | nullnamestring | nulldescriptionstring | nullurlstring | nullimage_urlstring | nulladditional_image_urlsarray of stringpricestring | nullsale_pricestring | nullcurrencystring | nullavailabilitystring | nullconditionstring | nullbrandstring | nullcategorystring | nullproduct_typestring | nullgtinstring | nullinventoryinteger | nullvisibilitystring | nullcolorstring | nullsizestring | nullgenderstring | nullmaterialstring | nullpatternstring | nullcustom_labelsarray of string | nullreview_statusstring | nullreview_rejection_reasonsarray of stringpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Add a product
/ads/catalogs/{catalogId}/productsTry it with MCPAsk your agent to call create-catalog-product (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
productobjectrequiredShow 31 child attributes
retailer_idstring1–100 characters
namestring1–200 characters
descriptionstring1–9999 characters
urlstring (uri)≤ 2048 characters
image_urlstring (uri)≤ 2048 characters
additional_image_urlsarray of string (uri)≤ 20 items
pricenumbercurrencystringpattern ^[A-Za-z]{3}$
sale_pricenumbersale_price_start_datestring1–40 characters
sale_price_end_datestring1–40 characters
availabilitystringin stockout of stockpreorderavailable for orderdiscontinuedpending
conditionstringnewrefurbishedused
brandstring1–100 characters
categorystring1–250 characters
google_product_categorystring1–250 characters
product_typestring1–750 characters
gtinstring1–70 characters
mpnstring1–100 characters
inventoryintegervisibilitystringpublishedstaging
colorstring1–200 characters
sizestring1–200 characters
genderstringfemalemaleunisex
materialstring1–200 characters
patternstring1–100 characters
custom_label_0string1–100 characters
custom_label_1string1–100 characters
custom_label_2string1–100 characters
custom_label_3string1–100 characters
custom_label_4string1–100 characters
Returns object
objectstringrequiredcatalog_product
idstringretailer_idstring | nullnamestring | nulldescriptionstring | nullurlstring | nullimage_urlstring | nulladditional_image_urlsarray of stringpricestring | nullsale_pricestring | nullcurrencystring | nullavailabilitystring | nullconditionstring | nullbrandstring | nullcategorystring | nullproduct_typestring | nullgtinstring | nullinventoryinteger | nullvisibilitystring | nullcolorstring | nullsizestring | nullgenderstring | nullmaterialstring | nullpatternstring | nullcustom_labelsarray of string | nullreview_statusstring | nullreview_rejection_reasonsarray of stringResponses
Create, update or delete products in bulk
/ads/catalogs/{catalogId}/products/batchUp to 5,000 requests keyed by retailer_id, processed asynchronously (202).
Try it with MCPAsk your agent to call batch-catalog-products (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
requestsarray of objectrequired1–5000 items
Show 2 item attributes
methodstringrequiredCREATEUPDATEDELETE
productobjectrequiredShow 31 child attributes
retailer_idstring1–100 characters
namestring1–200 characters
descriptionstring1–9999 characters
urlstring (uri)≤ 2048 characters
image_urlstring (uri)≤ 2048 characters
additional_image_urlsarray of string (uri)≤ 20 items
pricenumbercurrencystringpattern ^[A-Za-z]{3}$
sale_pricenumbersale_price_start_datestring1–40 characters
sale_price_end_datestring1–40 characters
availabilitystringin stockout of stockpreorderavailable for orderdiscontinuedpending
conditionstringnewrefurbishedused
brandstring1–100 characters
categorystring1–250 characters
google_product_categorystring1–250 characters
product_typestring1–750 characters
gtinstring1–70 characters
mpnstring1–100 characters
inventoryintegervisibilitystringpublishedstaging
colorstring1–200 characters
sizestring1–200 characters
genderstringfemalemaleunisex
materialstring1–200 characters
patternstring1–100 characters
custom_label_0string1–100 characters
custom_label_1string1–100 characters
custom_label_2string1–100 characters
custom_label_3string1–100 characters
custom_label_4string1–100 characters
Returns object
objectstringrequiredcatalog_batch_request
catalog_idstringhandlesarray of stringstatus_urlstring | nullResponses
Get a bulk request’s status
/ads/catalogs/{catalogId}/batches/{handle}Try it with MCPAsk your agent to call get-catalog-batch (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
handlestringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredcatalog_batch
handlestringstatusstringerrors_total_countintegererrorsarray of objectShow 2 item attributes
retailer_idstring | nullmessagestringResponses
Get a product
/ads/catalogs/{catalogId}/products/{productId}Try it with MCPAsk your agent to call get-catalog-product (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
productIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredcatalog_product
idstringretailer_idstring | nullnamestring | nulldescriptionstring | nullurlstring | nullimage_urlstring | nulladditional_image_urlsarray of stringpricestring | nullsale_pricestring | nullcurrencystring | nullavailabilitystring | nullconditionstring | nullbrandstring | nullcategorystring | nullproduct_typestring | nullgtinstring | nullinventoryinteger | nullvisibilitystring | nullcolorstring | nullsizestring | nullgenderstring | nullmaterialstring | nullpatternstring | nullcustom_labelsarray of string | nullreview_statusstring | nullreview_rejection_reasonsarray of stringResponses
Update a product
/ads/catalogs/{catalogId}/products/{productId}Try it with MCPAsk your agent to call update-catalog-product (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
productIdstringrequired1–256 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
productobjectrequiredShow 31 child attributes
retailer_idstring1–100 characters
namestring1–200 characters
descriptionstring1–9999 characters
urlstring (uri)≤ 2048 characters
image_urlstring (uri)≤ 2048 characters
additional_image_urlsarray of string (uri)≤ 20 items
pricenumbercurrencystringpattern ^[A-Za-z]{3}$
sale_pricenumbersale_price_start_datestring1–40 characters
sale_price_end_datestring1–40 characters
availabilitystringin stockout of stockpreorderavailable for orderdiscontinuedpending
conditionstringnewrefurbishedused
brandstring1–100 characters
categorystring1–250 characters
google_product_categorystring1–250 characters
product_typestring1–750 characters
gtinstring1–70 characters
mpnstring1–100 characters
inventoryintegervisibilitystringpublishedstaging
colorstring1–200 characters
sizestring1–200 characters
genderstringfemalemaleunisex
materialstring1–200 characters
patternstring1–100 characters
custom_label_0string1–100 characters
custom_label_1string1–100 characters
custom_label_2string1–100 characters
custom_label_3string1–100 characters
custom_label_4string1–100 characters
Returns object
objectstringrequiredcatalog_product
idstringretailer_idstring | nullnamestring | nulldescriptionstring | nullurlstring | nullimage_urlstring | nulladditional_image_urlsarray of stringpricestring | nullsale_pricestring | nullcurrencystring | nullavailabilitystring | nullconditionstring | nullbrandstring | nullcategorystring | nullproduct_typestring | nullgtinstring | nullinventoryinteger | nullvisibilitystring | nullcolorstring | nullsizestring | nullgenderstring | nullmaterialstring | nullpatternstring | nullcustom_labelsarray of string | nullreview_statusstring | nullreview_rejection_reasonsarray of stringResponses
Delete a product
/ads/catalogs/{catalogId}/products/{productId}Try it with MCPAsk your agent to call delete-catalog-product (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
productIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredcatalog_product
idstringrequireddeletedbooleanrequiredResponses
List product feeds
/ads/catalogs/{catalogId}/feedsTry it with MCPAsk your agent to call list-catalog-feeds (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 7 item attributes
objectstringrequiredcatalog_feed
idstringnamestring | nullproduct_countinteger | nullscheduleobject | nullShow 4 child attributes
intervalstring | nullurlstring | nullhourinteger | nullday_of_weekstring | nullcreated_atstring (date-time) | nulllatest_uploadobject | nullShow 9 child attributes
objectstringcatalog_feed_upload
idstringurlstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullerror_countinteger | nullwarning_countinteger | nullitems_detectedinteger | nullitems_deletedinteger | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a product feed
/ads/catalogs/{catalogId}/feedsTry it with MCPAsk your agent to call create-catalog-feed (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
namestringrequired1–200 characters
scheduleobjectShow 4 child attributes
intervalstringrequiredHOURLYDAILYWEEKLY
urlstring (uri)required≤ 2048 characters
hourinteger0–23
day_of_weekstringSUNDAYMONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAY
Returns object
objectstringrequiredcatalog_feed
idstringnamestring | nullproduct_countinteger | nullscheduleobject | nullShow 4 child attributes
intervalstring | nullurlstring | nullhourinteger | nullday_of_weekstring | nullcreated_atstring (date-time) | nulllatest_uploadobject | nullShow 9 child attributes
objectstringcatalog_feed_upload
idstringurlstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullerror_countinteger | nullwarning_countinteger | nullitems_detectedinteger | nullitems_deletedinteger | nullResponses
List a feed’s uploads
/ads/catalogs/{catalogId}/feeds/{feedId}/uploadsTry it with MCPAsk your agent to call list-catalog-feed-uploads (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
feedIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 9 item attributes
objectstringrequiredcatalog_feed_upload
idstringurlstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullerror_countinteger | nullwarning_countinteger | nullitems_detectedinteger | nullitems_deletedinteger | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Fetch a feed file now
/ads/catalogs/{catalogId}/feeds/{feedId}/uploadsTry it with MCPAsk your agent to call create-catalog-feed-upload (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
feedIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
urlstring (uri)required≤ 2048 characters
Returns object
objectstringrequiredcatalog_feed_upload
idstringurlstring | nullstart_timestring (date-time) | nullend_timestring (date-time) | nullerror_countinteger | nullwarning_countinteger | nullitems_detectedinteger | nullitems_deletedinteger | nullResponses
List product sets
/ads/catalogs/{catalogId}/product-setsTry it with MCPAsk your agent to call list-product-sets (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringlist
dataarray of objectShow 5 item attributes
objectstringrequiredproduct_set
idstringnamestring | nullproduct_countinteger | nullfilterobject | nullpageintegerlimitintegertotalinteger | nullhas_morebooleannext_page_urlstring | nullprevious_page_urlstring | nullnext_cursorstring | nullResponses
Create a product set
/ads/catalogs/{catalogId}/product-setsTry it with MCPAsk your agent to call create-product-set (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
namestringrequired1–200 characters
filterobjectrequiredReturns object
objectstringrequiredproduct_set
idstringnamestring | nullproduct_countinteger | nullfilterobject | nullResponses
Update a product set
/ads/catalogs/{catalogId}/product-sets/{productSetId}Try it with MCPAsk your agent to call update-product-set (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
productSetIdstringrequired1–256 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
namestring1–200 characters
filterobjectReturns object
objectstringrequiredproduct_set
idstringnamestring | nullproduct_countinteger | nullfilterobject | nullResponses
Delete a product set
/ads/catalogs/{catalogId}/product-sets/{productSetId}Try it with MCPAsk your agent to call delete-product-set (toolset ads_measurement)Set up MCP
Path parameters
catalogIdstringrequired1–256 characters
productSetIdstringrequired1–256 characters
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
business_idstring1–64 characters
limitintegerdefault: 25Items per page (max 100)
1–100
cursorstringnext_cursor from the previous page
≤ 4096 characters
afterstringAlias of cursor
≤ 4096 characters
Returns object
objectstringrequiredproduct_set
idstringrequireddeletedbooleanrequiredResponses
Conversions
Send conversion events
/ads/conversionsRelays server-side conversion events (PII normalized + SHA-256 hashed, never stored) to the network Conversions API.
Try it with MCPAsk your agent to call send-conversions (toolset ads_measurement)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
destination_idstringrequired1–256 characters
eventsarray of objectrequired1–1000 items
Show 11 item attributes
event_namestringrequired1–100 characters
event_timestring | integerrequiredISO 8601 date-time or unix seconds
event_idstringrequired1–100 characters
valuenumbercurrencystringpattern ^[A-Za-z]{3}$
userobjectrequiredShow 35 child attributes
emailstring1–320 characters
emailsarray of string≤ 10 items
phonestring1–64 characters
phonesarray of string≤ 10 items
first_namestring1–200 characters
last_namestring1–200 characters
citystring1–200 characters
statestring1–100 characters
zipstring1–32 characters
countrystring1–64 characters
date_of_birthstring1–16 characters
genderstring1–16 characters
external_idstring1–256 characters
external_idsarray of string≤ 10 items
ip_addressstring1–64 characters
user_agentstring1–1024 characters
company_namestring1–200 characters
titlestring1–200 characters
fbcstring1–500 characters
fbpstring1–500 characters
gclidstring1–500 characters
gbraidstring1–500 characters
wbraidstring1–500 characters
ttclidstring1–500 characters
ttpstring1–500 characters
li_fat_idstring1–500 characters
epikstring1–500 characters
sc_click_idstring1–500 characters
sc_cookie1string1–500 characters
rdt_cidstring1–500 characters
twclidstring1–500 characters
click_idstring1–500 characters
lead_idstring1–64 characters
uuidstring1–200 characters
hashedbooleanitemsarray of object≤ 200 items
Show 5 item attributes
idstringrequired1–100 characters
quantityinteger≥ 1
pricenumbernamestring1–200 characters
categorystring1–200 characters
source_urlstring (uri)≤ 2048 characters
action_sourcestringwebappofflinecrmphone_callsystem_generated
order_idstring1–100 characters
platform_dataobjecttest_codestring1–100 characters
consentobjectShow 2 child attributes
ad_user_datastringGRANTEDDENIED
ad_personalizationstringGRANTEDDENIED
Returns object
objectstringrequiredconversion_result
platformstringad_account_idstringdestination_idstringtestbooleanevents_receivedintegerevents_failedintegerfailuresarray of objectShow 4 item attributes
indexintegerevent_idstring | nullmessagestringcodestring | nulltrace_idstring | nullResponses
Adjust uploaded conversions
/ads/conversions/adjustmentsRetract, restate or enhance conversions already sent (Google Ads).
Try it with MCPAsk your agent to call adjust-conversions (toolset ads_measurement)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
destination_idstringrequired1–64 characters
adjustmentsarray of objectrequired1–2000 items
Show 9 item attributes
adjustment_typestringrequiredRETRACTIONRESTATEMENTENHANCEMENT
adjustment_timestring | integerrequiredISO 8601 date-time or unix seconds
order_idstring1–100 characters
gclidstring1–500 characters
conversion_timestring | integerISO 8601 date-time or unix seconds
restatement_valuenumbercurrencystringpattern ^[A-Za-z]{3}$
userobjectShow 35 child attributes
emailstring1–320 characters
emailsarray of string≤ 10 items
phonestring1–64 characters
phonesarray of string≤ 10 items
first_namestring1–200 characters
last_namestring1–200 characters
citystring1–200 characters
statestring1–100 characters
zipstring1–32 characters
countrystring1–64 characters
date_of_birthstring1–16 characters
genderstring1–16 characters
external_idstring1–256 characters
external_idsarray of string≤ 10 items
ip_addressstring1–64 characters
user_agentstring1–1024 characters
company_namestring1–200 characters
titlestring1–200 characters
fbcstring1–500 characters
fbpstring1–500 characters
gclidstring1–500 characters
gbraidstring1–500 characters
wbraidstring1–500 characters
ttclidstring1–500 characters
ttpstring1–500 characters
li_fat_idstring1–500 characters
epikstring1–500 characters
sc_click_idstring1–500 characters
sc_cookie1string1–500 characters
rdt_cidstring1–500 characters
twclidstring1–500 characters
click_idstring1–500 characters
lead_idstring1–64 characters
uuidstring1–200 characters
hashedbooleanuser_agentstring1–1024 characters
Returns object
objectstringrequiredconversion_adjustment_result
platformstringad_account_idstringdestination_idstringadjustments_receivedintegeradjustments_failedintegerfailuresarray of objectShow 3 item attributes
indexintegermessagestringcodestring | nulltrace_idstring | nullResponses
Get Event Match Quality
/ads/conversions/qualityTry it with MCPAsk your agent to call get-event-match-quality (toolset ads_measurement)Set up MCP
Query parameters
ad_account_idstringAd account (ada_…)
≤ 80 characters
connection_idstringAds connection (adc_…), with platform_ad_account_id when it has several ad accounts
≤ 80 characters
platform_ad_account_idstringNetwork ad account id (act_…, customer id, advertiser id …)
≤ 256 characters
destination_idstring1–256 characters
Returns object
objectstringrequiredevent_match_quality
platformstringdestination_idstringrowsarray of objectShow 4 item attributes
event_namestring | nullcomposite_scorenumber | nullmatch_keysarray of objectShow 2 item attributes
identifierstring | nullcoverage_percentagenumber | nullevent_coverage_percentagenumber | null