chatgpt_ads account is an OpenAI Ads Manager ad account, not a social
network. It publishes nothing and receives no messages: it holds campaigns
whose ads appear as cards under ChatGPT answers.
Campaigns
Budget, countries, what you pay for.
Ad groups
Targeted by the conversations they should appear in.
Chat cards
Title, text, image and landing page, with a preview.
Insights
Spend and performance at every level.
Connect
OpenAI has no public OAuth for ads: each ad account has its own Ads API key. Create one in OpenAI Ads Manager → Settings → API keys, then hand it to PlugKit:- A key opens exactly one ad account. Connect several accounts with one key each.
- A
platform.openai.comkey is refused: it isn’t an Ads key. - If the key is revoked in Ads Manager, the account switches to “needs reconnection”: connect it again with a new key.
Check what you're spending against
review_status: the brand review OpenAI
runs on the account. No ad serves until it is approved.
Same API as Meta and Google Ads
ChatGPT Ads uses the same/v1/ads/{accountId}/… routes as
Meta Ads and Google Ads, and the
account decides which one PlugKit calls. The words are mapped like this:
Build a campaign
Campaign — budget and countries
dailyBudgetorlifetimeBudgetis required. The budget lives on the campaign: ad groups have none. OpenAI enforces a minimum, which depends on the currency; below it, the error tells you the minimum in your currency.countriesis required, with no default. Only the countries OpenAI has opened to the ad account are accepted — they depend on the country the account was created in. Any other country is refused with “The campaign does not target any country where this account can advertise”.locationIdsadds regions or markets, found by name:GET /v1/ads/ACCOUNT_ID/locations?q=California.biddingType:clicks(default),impressionsorconversions(needs a conversion event enabled on the account).platformsrestricts where the ad serves:ios_app,android_app,web,desktop_web,ios_web,android_web. All by default.
Ad group — the conversations to appear in
- ChatGPT has no keywords:
contextHintsdescribes, in plain language, the conversations where the ad should appear. - Leave the bid out and OpenAI bids automatically. Pass
bidAmount(minor units) for a fixed max bid.bidStrategycan forcefixed_bid,maximize_clicksormaximize_conversions. - If OpenAI doesn’t keep the bid you passed, the response carries a
warningsentry saying so, andbid_amountshows what is really set.
Ad — a chat card
title(3 to 50 characters),body(100 max) andtargetUrlare required.- An image is required. Pass
imageUrl, a public image of at least 640×640 that OpenAI fetches itself (a file from your PlugKit media library works), orfileIdfor an image already uploaded to OpenAI. Over MCP,create_adalso takesmediaId, a library id.
Preview before activating
PATCH …/campaigns/{id}, …/adsets/{id} and …/ads/{id} with
{ "status": "ACTIVE" }.
Insights
levelisaccount,campaign,adsetorad.objectId(acmpn_,adgrp_orad_id) narrows to one object.datePreset:today,yesterday,last_7d,last_14d,last_30d(default),this_month,last_month— orsince+until(YYYY-MM-DD).- You get totals for the period: impressions, clicks, spend, CTR, CPC, CPM
and conversions.
spend,cpcandcpmare major units, as strings ("12.34"), like on Meta. There is no reach.
MCP
Over MCP, the same tools as Meta and Google Ads apply (create_campaign,
create_ad_set, create_ad, get_ads_insights…), plus two ChatGPT-only
tools: preview_ad and lookup_ad_locations.