Manage ChatGPT Ads
manage_chatgpt_adsCreate, update, pause or archive ChatGPT Ads campaigns, ad groups and ads in a connected ad account, with a preview-and-approval step before changes are sent.
Instructions
Create and change ChatGPT Ads campaigns, ad groups and ads in the ad account the user connected to Upload-Post. This spends the user's money: spend runs on their own OpenAI billing, and an ad serves only when its campaign, ad group and ad are all active and OpenAI approved the ad. Objects are created paused unless params.status is active. Fields go in params with the API's names. promote: campaign + ad group + ad in one call (title 3-50 characters, body up to 100, target_url, image_url or file_id; budget = lifetime spend limit in the account currency, minimum 1, or budget_micros; max_bid per billing event or max_bid_micros; bidding_type impressions|clicks|conversions, billing_event_type impression|click, start_time, end_time, locations, targeting, context_hints, name, ad_group_name, ad_name, status); if a later step fails the error lists in details.created what was already created. create_campaign (name, budget or budget_micros, status, description, start_time, end_time, bidding_type, conversion_event_setting_ids, locations, custom_audience_ids, excluded_custom_audience_ids, targeting); create_ad_group (campaign_id, name, max_bid or max_bid_micros unless bidding_config, billing_event_type, status, description, context_hints, product_set); create_ad (ad_group_id, name, and title, body, target_url, file_id, price at the top level or a full creative object; type chat_card|product_ad_template; it serves after OpenAI's review); upload_creative (image_url, OpenAI fetches it; returns the file_id an ad uses); update_campaign / update_ad_group / update_ad (the id plus only the fields to change; an edited ad goes back into review); activate_* starts spending, pause_* stops it, archive_* is irreversible (campaign_id, ad_group_id or ad_id). Connecting or disconnecting the ad account is done in the Upload-Post dashboard. Read results with chatgpt_ads_read. Needs the user's approval: call it first without confirmed to get a preview (nothing is sent), show the user exactly what will go out, and repeat the call with confirmed: true only after they approve.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_chatgpt_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | No | The ad (ad, ad_insights, preview_ad, update/activate/pause/archive_ad). | |
| action | Yes | ||
| params | No | Other API fields for this action, with the REST API's own names (snake_case) and shapes. See the description for each action's fields. Leave out what you do not want to change. | |
| confirmed | No | Set to true only after the user has seen the preview this tool returns without it and approved it. Without it nothing is sent. | |
| ad_group_id | No | The ad group (ad_group, ad_group_insights, update/activate/pause/archive_ad_group; ads lists the ads of this group; create_ad puts the ad in it). | |
| campaign_id | No | The campaign (campaign, campaign_insights, update/activate/pause/archive_campaign; ad_groups lists the groups of this campaign; create_ad_group puts the group in it). | |
| ad_account_id | No | Connected ad account to use (`adacct_...`, from chatgpt_ads_read accounts). Without it and without profile_username: the default account. | |
| profile_username | No | Use the ad account linked to this Upload-Post profile, and only that one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |