Save Build
ads_save_buildSave a durable build: a launch configuration the web uploader can open and ads_create can launch by buildId. A spec-only build is the supported shape for agent-created configurations; the web uploader generates its own webState when it opens the build, and webState is only accepted unchanged from a build that was read. accountId can be omitted when the spec or webState carries it. Returns the build metadata with its url, launchable and launchBlockers, and display: totalAdSets, totalAds and the ads in each ad set as the web uploader renders them (display.complete false carries a reason, and display.inheritedFromSource lists fields that come from the source ad or preset). launchable describes headless ads_create launches only; any build opens in the web uploader. A saved build uses the campaign and ad set of its template ad, or new ones. Video items take the numeric Facebook video id (videoId in the upload result) as mediaId. Each call saves a new build; ads_update_build changes an existing one. Uploaded media accepts texts.common.multiAdvertiserAds only (boolean); omit to copy the source, which is off when the source ad does not say. True is refused while site links remain. Imported posts keep per-row choices. Website highlights is copied from the source and cannot be changed; none, all off and empty features never change it. Preview and saved display report both settings separately. video_uncrop and translate_voiceover require source OPT_IN.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional durable build name. | |
| spec | No | Portable launch specification. Spec-only creation is supported and preferred for agent-created builds. | |
| notes | No | Optional free-form notes stored on the build. | |
| webState | No | Opaque web uploader session snapshot. Do not construct it by hand. Only provide webState when round-tripping a snapshot previously read from a build without changing its structure. | |
| accountId | No | Optional ad account ID. The server can also derive it from webState.selectedAccount.accountId, webState.selectedAccount.account_id, or spec.accountId. |