Documentation / Tool Reference

ChatGPT Ads tools

Tools for ads that run inside ChatGPT: connect an OpenAI ad account with its API key, create campaigns, ad groups and ads, set spending limits, read delivery reports and find out why an ad is not serving.

Connection & Account · 2

connect_chatgpt_adsfree

Connects a ChatGPT Ads (OpenAI) ad account so campaigns can be managed from chat.

api_keyconfirm
manage_chatgpt_ads_accountsfree

Lists, re-checks, disconnects or re-defaults your connected ChatGPT Ads accounts.

actionaccountconfirm

Reading & Reporting · 4

chatgpt_ads_ad_previewfree

Renders how an existing ChatGPT Ads ad looks, plus the delivery blockers OpenAI reports for it.

ad_idaccount
chatgpt_ads_detailsfree

Full details of one ChatGPT Ads campaign, ad group or ad by id, including everything that decides delivery.

idaccounthints_limithints_offset
chatgpt_ads_geo_lookupfree

Finds ChatGPT Ads location ids (countries, regions, markets, postal codes) to use in campaign location targeting.

querylimitaccount
chatgpt_ads_insightsfree

ChatGPT Ads delivery report with every option OpenAI offers: hourly/daily/monthly buckets, platform/country/device breakdowns, zero-impression rows and conversion metrics.

accountscope_idleveldaysstart_dateend_dategranularitysegmentinclude_zeroconversionslimitoffset

Account health & Alerts · 1

diagnose_chatgpt_ads_delivery2 credits

Explains why ChatGPT Ads are not getting impressions: ranked findings with the evidence, the fix and the tool that applies it.

accountcampaign_idcheck_landing_pages

Campaign · 2

create_chatgpt_ads_campaign8 credits

Creates a ChatGPT Ads campaign in your connected ChatGPT Ads account.

namedaily_budgetlifetime_budgetobjectiveactivateconfirmaccount
update_chatgpt_ads_campaign5 credits

Changes an existing ChatGPT Ads campaign: name, budget, locations, platforms, schedule, conversion events, status.

campaign_idnamedaily_budgetlifetime_budgetconfirmaccountinclude_locationsexclude_locationslocations_modeplatformsstartendconversion_event_setting_idsconversion_mode

Ad group & Ad · 5

chatgpt_ads_status5 credits

Pauses, activates or archives a ChatGPT Ads campaign, ad group or ad.

kindidactionconfirmaccount
create_chatgpt_ads_ad8 credits

Creates a ChatGPT Ads ad (chat card) inside an ad group.

ad_group_idnametitlebodytarget_urlimage_urlactivateconfirmaccount
create_chatgpt_ads_ad_group5 credits

Creates an ad group under a ChatGPT Ads campaign and sets its maximum bid and context hints.

campaign_idnamemax_bidbilling_eventactivateallow_high_bidcontext_hintsconfirmaccount
update_chatgpt_ads_ad5 credits

Changes the copy, destination or image of an existing ChatGPT Ads ad.

ad_idnametitlebodytarget_urlimage_urlconfirmaccount
update_chatgpt_ads_ad_group5 credits

Changes the name, bid, bid strategy or context hints of an existing ChatGPT Ads ad group.

ad_group_idnamemax_bidstrategyallow_high_bidcontext_hintshints_modeconfirmaccount

Optimization · 2

chatgpt_ads_spend_limitsfree

Shows the ChatGPT Ads account-level spending limits: date-range windows and the recurring daily limit, with spend so far.

account
manage_chatgpt_ads_spend_limit5 credits

Creates, changes or removes a ChatGPT Ads account spending limit (date-range window or recurring daily limit).

actionwindow_idstart_dateend_dateamountnameio_idno_end_dateconfirmaccount

Conversion tracking · 2

chatgpt_ads_conversion_setupfree

Shows ChatGPT Ads conversion tracking: pixels (data sources), conversion event settings with the campaigns they are attached to, and events received in the last ~15 minutes.

accountcheck_recent_events
create_chatgpt_ads_event_setting5 credits

Creates a ChatGPT Ads conversion event setting (which tracked action counts as a conversion) on one pixel source.

nameevent_typesource_idcustom_event_nameconfirmaccount