Safe Writes: preview before apply
How Safe Writes previews and confirms every change before it can touch a live ad account, and what the gateway will not do.
266 of the 605 tools change something. They are absent from the tool list on the Free plan, and refused if called anyway.
Every write previews firstLink to this section
A write tool called without confirm: true changes nothing. It returns what it would do, in the units the platform expects, and stops. The same call repeated with confirm: true applies it.
{ "customerId": "123-456-7890", "budgetId": "456", "dailyAmount": 75 }
{
"applied": false,
"action": "google_ads_update_campaign_budget",
"change": { "customer": "1234567890", "budget": "456",
"newDailyBudget": 75, "inMicros": 75000000 },
"message": "Preview only, nothing was changed."
}The preview exists because a model composes these calls. It can pick the wrong account, the wrong campaign, or the wrong order of magnitude on a budget. The preview turns an expensive mistake into a visible one.
AmountsLink to this section
You always give an amount in the account currency. The gateway converts to whatever the platform expects, and the preview shows both numbers so the conversion is auditable.
| Platform | Unit sent | 75 becomes |
|---|---|---|
| Google Ads | micro units | 75000000 |
| micro currency | 75000000 | |
| Meta | currency minor unit | 7500, or 75 on a currency with no minor unit |
| TikTok | the amount itself | 75 |
Bulk ad creation: the Campaign LauncherLink to this section
A brief and a set of media become one saved proposal that holds the whole campaign graph, on one platform or on several at once. Preparing the proposal sends nothing to an advertising API. You approve one specific revision, and that approval is bound to every parameter and to the exact media files: change a budget and the approval no longer applies.
Media can be attached in the conversation or imported from Google Drive or Dropbox. The Google Drive connection is limited to the files you pick. Imports bring creative files in for the Launcher only; they are unrelated to Google Sheets exports, which send data out.
| Plan | Ads created per month | Files per batch | Launches in parallel |
|---|---|---|---|
| Free | Not available | Not available | Not available |
| Pro | 500 | 25 | 1 |
| Team | 5,000 | 100 | 2 |
| Enterprise | Unlimited | 200 | 4 |
A launch that is interrupted resumes from its saved checkpoints. A step whose outcome is uncertain is read back from the platform and is never sent a second time.
What the gateway will not doLink to this section
- Create anything in an active state. New campaigns, ad sets and ads are created paused, or as drafts on LinkedIn. Activation is a separate step with its own approval.
- Apply a change nobody confirmed. That holds for a single budget edit and for a Launcher proposal of two hundred files.
- Delete campaigns, ad sets or ads. Pausing and archiving are available. Deletion is exposed only for library items such as an unused card, a media file or a draft.
- Invent what a platform requires. Identities, pixels, catalogues and pages are read from the account, and a missing one stops the proposal rather than being guessed.
Duplication, targeting edits and creative upload exist where the platform's API supports them, and the coverage differs from one source to the next. Ask the assistant to call get_capabilities for a platform, or read that source's page, before assuming an operation.