Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Update ChatGPT Ads Ad Group
Changes the name, bid, bid strategy or context hints of an existing ChatGPT Ads ad group.
- Type
- Makes changes
- Credits
- 5
- Platform
- ChatGPT Ads
- Approval
- Preview first, applied after you approve
What it does
Changes the name, bid, bid strategy or context hints of an existing ChatGPT Ads ad group.
Context hints are what decides which ChatGPT conversations the ads can match, so this is the main relevance lever on the platform. Write them as short natural sentences describing the product, the use case or the need, in the language the buyers actually chat in: "lightweight trail running shoes for rocky terrain" works, "shoes" does not, and "customers in California" belongs in country targeting instead. Up to 2000 per ad group; they are not exact-match keywords and they do not replace country or platform targeting. `hints_mode`: `add` appends to what is already there (the default, and the safe one), `replace` swaps the whole list, `remove` deletes the ones you pass, `clear` empties it. OpenAI's own field is replace-only, so a bare `replace` with two hints would silently delete the rest; the merge happens here. `max_bid` is in the account currency and is checked against the parent campaign's real daily budget plus a sanity ceiling that catches a decimal slip; a deliberate high bid passes with `allow_high_bid=true`. `strategy`: fixed_bid | maximize_clicks | maximize_conversions. Switching to a maximize strategy drops the manual bid because OpenAI requires it to be absent there. Bid settings not passed, including audience bid multipliers, are preserved, not cleared. confirm=false returns a dry run.
MCP: update_chatgpt_ads_ad_group
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| ad_group_id | string | Required | · | Exact ad group identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| name | string | Optional | · | Human-readable name for the resource being created or updated. |
| max_bid | number | Optional | 0 | Max bid value in the provider's required numeric unit. Use the account currency for money values and the provider format for ratios or percentages. |
| strategy | string | Optional | · | fixed_bid · maximize_clicks · maximize_conversions · Bidding, fetch, or analysis strategy accepted by this operation. |
| allow_high_bid | boolean | Optional | false | Allow high bid value in the provider's required numeric unit. Use the account currency for money values and the provider format for ratios or percentages. |
| context_hints | array | Optional | · | Context hints value for update chatgpt ads ad group. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible. |
| hints_mode | string | Optional | add | add · replace · remove · clear · Exact hints mode value for update chatgpt ads ad group. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation; matching the schema pattern. |
| confirm | boolean | Optional | false | Safety confirmation for a state-changing operation. Leave false to preview or validate; set true only after the user explicitly approves the shown change. |
| account | string | Optional | · | Connected account selector for this operation. Use the exact account ID or account value accepted by this tool; when in doubt, obtain it from the relevant account-listing tool. |
Related tools
chatgpt_ads_ad_previewChatGPT Ads Conversion Setupchatgpt_ads_conversion_setupChatGPT Ads Object Detailschatgpt_ads_detailsChatGPT Ads Location Lookupchatgpt_ads_geo_lookupChatGPT Ads Insightschatgpt_ads_insightsChatGPT Ads Spend Limitschatgpt_ads_spend_limitsChatGPT Ads Statuschatgpt_ads_statusConnect ChatGPT Adsconnect_chatgpt_adsCreate ChatGPT Ads Adcreate_chatgpt_ads_ad