@getlatedev/node 0.2.237 → 0.2.239

package/dist/index.d.mts

@@ -18646,6 +18646,10 @@ type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -18655,7 +18659,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 + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * 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`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -18684,7 +18688,7 @@ type CreateStandaloneAdData = {
              */
             url: string;
             /**
-             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
+             * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
             thumbnailUrl?: string;
         };
@@ -18702,16 +18706,20 @@ type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
             imageUrl?: string;
             /**
-             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             * Video creative for this entry. Mutually exclusive with `imageUrl`. thumbnailUrl is optional — when omitted, the poster is auto-generated from Meta's preferred video thumbnail.
              */
             video?: {
                 url: string;
-                thumbnailUrl: string;
+                thumbnailUrl?: string;
             };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
@@ -18725,6 +18733,16 @@ type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -18949,8 +18967,11 @@ type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.

package/dist/index.d.ts

@@ -18646,6 +18646,10 @@ type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -18655,7 +18659,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 + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * 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`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -18684,7 +18688,7 @@ type CreateStandaloneAdData = {
              */
             url: string;
             /**
-             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
+             * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
             thumbnailUrl?: string;
         };
@@ -18702,16 +18706,20 @@ type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
             imageUrl?: string;
             /**
-             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             * Video creative for this entry. Mutually exclusive with `imageUrl`. thumbnailUrl is optional — when omitted, the poster is auto-generated from Meta's preferred video thumbnail.
              */
             video?: {
                 url: string;
-                thumbnailUrl: string;
+                thumbnailUrl?: string;
             };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
@@ -18725,6 +18733,16 @@ type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -18949,8 +18967,11 @@ type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.237",
+  version: "0.2.239",
   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.237",
+  version: "0.2.239",
   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.237",
+  "version": "0.2.239",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -19139,6 +19139,10 @@ export type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -19148,7 +19152,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 + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * 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`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -19177,7 +19181,7 @@ export type CreateStandaloneAdData = {
              */
             url: string;
             /**
-             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
+             * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
             thumbnailUrl?: string;
         };
@@ -19195,16 +19199,20 @@ export type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
             imageUrl?: string;
             /**
-             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             * Video creative for this entry. Mutually exclusive with `imageUrl`. thumbnailUrl is optional — when omitted, the poster is auto-generated from Meta's preferred video thumbnail.
              */
             video?: {
                 url: string;
-                thumbnailUrl: string;
+                thumbnailUrl?: string;
             };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
@@ -19218,6 +19226,16 @@ export type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -19442,8 +19460,11 @@ export type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.