Update Campaign

Low-level update for an OpenAI Ads campaign using a raw update payload

Low-level update for an OpenAI Ads campaign using a raw update payload. Use focused campaign nodes first when available, such as status, budget, or rename.

App	OpenAI Ads
Operation ID	openai_ads_update_campaign
Type	Action
Connection	openai_ads (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
campaign_id	string or SelectableOption	Yes	-	Campaign ID to update (from openai_ads_list_campaigns). Do not include this inside update_payload.
update_payload	object or string	Yes	-	OpenAI Ads campaign update payload as a JSON object. Only the fields provided here are sent to OpenAI Ads. If you include budget, send the full budget object. Use focused operations first when they exist, for example openai_ads_update_campaign_status, openai_ads_update_campaign_budget, or openai_ads_rename_campaign. Do not include identity fields like campaign_id or id.
dry_run	boolean	No	False	When true, return the resolved update payload without calling OpenAI Ads.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: Dict

Returns the updated campaign object exactly as returned by the OpenAI Ads API. In dry_run mode, returns the resolved payload without calling the API.

Fields: dynamic (depend on the inputs)

Example:

{
  "id": "cmpn_...",
  "name": "Spring launch v2",
  "status": "paused",
  "budget": {
    "lifetime_spend_limit_micros": 30000000
  },
  "updated_at": 1735862400
}