A campaign rarely stays as it was built. These tools change what is already running: the money, the bid, the schedule, who it reaches and what it shows, without deleting the ad and losing its history. They also make paused copies of what already works. Every change is read back from the platform before Hermoso tells you it happened.
How every change works
Live objects ask first. If the campaign, ad set, asset group or ad is switched on, a change that can raise spend or change what people see is refused until you pass confirm: true. The refusal names exactly what would change. A paused object edits freely.
Nothing is shortened. A headline that is too long, a path over 15 characters or a tag with a space is refused with the limit, never cut to fit.
Copies are born paused. Every duplicate spends nothing until someone switches it on.
What you are told comes from the platform. The reply quotes what Meta, Google, TikTok or X stores after the change, and says so plainly when that read does not match what was asked.
Meta
Tool
What it does
update_meta_object
Besides the name, daily budget, targeting and status: lifetimeBudgetUsd (needs an end time; Meta does not let a budget go below 110% of what is already spent), bidStrategy, bidAmountUsd (bid or cost cap), minRoas (with LOWEST_COST_WITH_MIN_ROAS and the goal VALUE), endTime (or "ongoing" for a daily budget) and optimizationGoal on an ad set. On an ad: creativeId to point it at another creative, or imageHash / videoId from upload_meta_asset and urlTags for new UTMs. Meta does not let a creative be edited, so Hermoso builds a new one from the ad's current copy and button, points the ad at it and keeps the old one.
duplicate_meta_object
Copies a campaign, ad set or ad with Meta's own copy feature, with everything under it (deep: false copies only the top object). An ad set can go into another campaign with targetCampaignId, an ad into another ad set with targetAdSetId. Up to 50 ads per call.
Google Ads
Tool
What it does
manage_google_ads_asset_groups
Performance Max asset groups: list, create (with Google's minimum set of headlines, long headlines, descriptions and images in the same call), update the name, final URL and display paths, pause, enable, remove (never the last one), link and unlink assets (never below Google's minimum), and for a campaign on a Merchant Center feed, read and set which products it advertises: everything, only some brands, item ids, product types, categories, conditions or custom labels, or everything except them.
update_google_ads_ad
Edits a responsive search ad in place: headlines (with pins), descriptions, display paths, final URLs, the final URL suffix and the tracking template. A list you send replaces the ad's list, so send all of it.
set_google_ads_status
Now also turns one keyword on or off: level: "keyword" with adGroupId and keywordId.
google_ads_keyword_ideas
mode: "historical" returns the volume, competition, bid range and month-by-month searches of keywords you already have (up to 10,000), with startMonth / endMonth for a range.
duplicate_google_ads_campaign
Copies a Search or Display campaign: its budget amount, bidding, networks, locations, languages, schedule, negatives, ad groups, keywords and responsive ads. Google has no copy feature in its API, so Hermoso rebuilds it in one step. The copy's history and Quality Score start fresh. dryRun: true checks it without creating anything.
TikTok and X
Tool
What it does
update_tiktok_ads_ad_group
Changes an ad group's targeting (locations, ages, gender, languages, interests, audiences, devices, networks), its bid (cost cap or maximum delivery) and its schedule (the start before it begins, the end, and the hours it runs). TikTok replaces the whole ad group on every edit, so Hermoso resends everything you did not change exactly as TikTok stores it. Placement, optimization goal and billing cannot change after launch; the budget is set_tiktok_ads_budget.
manage_x_ads_conversion_events
Lists, creates and updates the conversion events on the X Pixel (purchase, lead, page view and the rest), with each event's id and the pixel id. send_x_ads_conversions now finds those ids itself: leave pixelId out and name an event by its kind, for example "eventType": "PURCHASE".
The API routes are POST /api/meta/object/update, POST /api/meta/object/duplicate, POST /api/google-ads/asset-groups, POST /api/google-ads/ad/update, POST /api/google-ads/duplicate, POST /api/google-ads/status, POST /api/google-ads/keyword-ideas, POST /api/tiktok-ads/adgroup/update and GET / POST /api/x-ads/conversion-events. In the app, ask the Studio for any of these in your own words.
Example
update_meta_object {"objectId": "120211", "adAccountId": "act_1", "bidAmountUsd": 6}
→ "120211 is LIVE and spending. This changes bid 5.00 USD → 6.00 USD ... Nothing was changed."
update_meta_object {"objectId": "120211", "adAccountId": "act_1", "bidAmountUsd": 6, "confirm": true}
→ "Meta now stores: bid 6.00 USD (amounts in USD)."
duplicate_meta_object {"objectId": "120200", "adAccountId": "act_1"}
→ "Meta made 1 campaign, 1 ad set, 2 ads ... all PAUSED, so nothing spends until someone switches them on."