@getlatedev/node 0.2.226 → 0.2.228

package/dist/index.d.mts

@@ -18085,7 +18085,7 @@ type UpdateAdTrackingTagsData = {
             value: string;
         }>;
         /**
-         * Meta only. Required to rebuild the immutable creative when setting urlTags.
+         * Meta only. OPTIONAL — omit to preserve the existing creative verbatim (default). Provide it only to rebuild the creative explicitly, or for creatives whose object_story_spec Meta strips.
          */
         creative?: {
             headline: string;
@@ -18473,7 +18473,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization are derived automatically from the goal. NOT compatible with `placementAssets` (per-placement creative) or `dynamicCreative` (multiple assets/text): Meta does not allow an asset_feed_spec creative on instant-form lead ads, so that combination is rejected with INVALID_FIELD_VALUE. Per-placement / multi-asset creative is supported on `traffic` and `conversions` goals.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. `placementAssets` (per-placement creative) IS supported on instant-form lead ads — the form is attached for you. NOT compatible with `dynamicCreative` (the auto-optimizing multi-asset pool), which Meta requires a dedicated Dynamic Creative ad set for; that combination is rejected with INVALID_FIELD_VALUE (use `placementAssets`, a single creative, or run `dynamicCreative` on a `traffic`/`conversions` goal).
          */
         leadGenFormId?: string;
         /**

package/dist/index.d.ts

@@ -18085,7 +18085,7 @@ type UpdateAdTrackingTagsData = {
             value: string;
         }>;
         /**
-         * Meta only. Required to rebuild the immutable creative when setting urlTags.
+         * Meta only. OPTIONAL — omit to preserve the existing creative verbatim (default). Provide it only to rebuild the creative explicitly, or for creatives whose object_story_spec Meta strips.
          */
         creative?: {
             headline: string;
@@ -18473,7 +18473,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization are derived automatically from the goal. NOT compatible with `placementAssets` (per-placement creative) or `dynamicCreative` (multiple assets/text): Meta does not allow an asset_feed_spec creative on instant-form lead ads, so that combination is rejected with INVALID_FIELD_VALUE. Per-placement / multi-asset creative is supported on `traffic` and `conversions` goals.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. `placementAssets` (per-placement creative) IS supported on instant-form lead ads — the form is attached for you. NOT compatible with `dynamicCreative` (the auto-optimizing multi-asset pool), which Meta requires a dedicated Dynamic Creative ad set for; that combination is rejected with INVALID_FIELD_VALUE (use `placementAssets`, a single creative, or run `dynamicCreative` on a `traffic`/`conversions` goal).
          */
         leadGenFormId?: string;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.226",
+  version: "0.2.228",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.226",
+  version: "0.2.228",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.226",
+  "version": "0.2.228",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -4712,10 +4712,13 @@ export const getAdTrackingTags = <ThrowOnError extends boolean = false>(options:
 /**
  * Set/update an ad's click-URL tracking tags
  * Unified update. Send only the fields for the ad's platform:
- * - Meta: `urlTags` (array of {key,value}) + `creative` (headline, body, callToAction, linkUrl, imageUrl).
- * Meta creatives are immutable, so this REBUILDS the creative and repoints the ad — the full
- * creative is required. Placement-customized / asset-feed / dark creatives may not be
- * rebuildable this way and return 422.
+ * - Meta: `urlTags` (array of {key,value}). Meta creatives are immutable, so this rebuilds the
+ * creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim
+ * (re-post its object_story_spec + the new url_tags, reusing the image), so you send `urlTags`
+ * ALONE — no need to read back headline/body/CTA. `creative` (headline, body, callToAction,
+ * linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post
+ * / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for
+ * `creative`).
  * - Google: `trackingUrlTemplate` and/or `finalUrlSuffix` (full template strings; account quota applies).
  * - LinkedIn: `dynamicValueParameters` and/or `customValueParameters` (campaign-level Dynamic UTM).
  *

package/src/generated/types.gen.ts

@@ -18559,7 +18559,7 @@ export type UpdateAdTrackingTagsData = {
             value: string;
         }>;
         /**
-         * Meta only. Required to rebuild the immutable creative when setting urlTags.
+         * Meta only. OPTIONAL — omit to preserve the existing creative verbatim (default). Provide it only to rebuild the creative explicitly, or for creatives whose object_story_spec Meta strips.
          */
         creative?: {
             headline: string;
@@ -18962,7 +18962,7 @@ export type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization are derived automatically from the goal. NOT compatible with `placementAssets` (per-placement creative) or `dynamicCreative` (multiple assets/text): Meta does not allow an asset_feed_spec creative on instant-form lead ads, so that combination is rejected with INVALID_FIELD_VALUE. Per-placement / multi-asset creative is supported on `traffic` and `conversions` goals.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. `placementAssets` (per-placement creative) IS supported on instant-form lead ads — the form is attached for you. NOT compatible with `dynamicCreative` (the auto-optimizing multi-asset pool), which Meta requires a dedicated Dynamic Creative ad set for; that combination is rejected with INVALID_FIELD_VALUE (use `placementAssets`, a single creative, or run `dynamicCreative` on a `traffic`/`conversions` goal).
          */
         leadGenFormId?: string;
         /**