@zernio/node 0.2.201 → 0.2.203

package/dist/index.d.mts

@@ -17581,6 +17581,18 @@ type CreateStandaloneAdData = {
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */
         budgetType?: 'daily' | 'lifetime';
+        /**
+         * Meta only. Where the budget lives, which selects the Meta budget model:
+         * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
+         * ad set. This is the back-compatible behaviour — omit this field to keep it.
+         * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
+         * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
+         * across ad sets automatically.
+         * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
+         * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
+         *
+         */
+        budgetLevel?: 'adset' | 'campaign';
         currency?: string;
         /**
          * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
@@ -17773,6 +17785,34 @@ type CreateStandaloneAdData = {
          * Language codes (e.g. ['en']). Restricts the audience by language.
          */
         languages?: Array<(string)>;
+        /**
+         * Meta only. Manual ad placements. Omit for automatic placements (Meta's default,
+         * recommended for most cases — Meta optimises delivery across all eligible surfaces).
+         * When set, restricts delivery to the chosen surfaces, mapped onto the ad set's
+         * `targeting.{publisher_platforms, facebook_positions, instagram_positions,
+         * messenger_positions, audience_network_positions, threads_positions,
+         * whatsapp_positions, device_platforms}`. Enum membership is validated here; Meta
+         * additionally enforces co-selection rules (e.g. some positions require their parent
+         * publisher platform) and returns an actionable error which we surface. Non-Meta
+         * platforms reject this field.
+         *
+         */
+        placements?: {
+            /**
+             * Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.
+             */
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            /**
+             * Restrict by device. Omit to deliver on both mobile and desktop.
+             */
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        };
         /**
          * ID of a `saved_targeting` audience (created via POST /v1/ads/audiences). When set, its stored
          * TargetingSpec is expanded as the base targeting; inline fields on this body merge on top. Lets you
@@ -17791,6 +17831,105 @@ type CreateStandaloneAdData = {
          * Required for lifetime budgets
          */
         endDate?: string;
+        /**
+         * Meta only. Ad-set start time (ISO 8601, e.g. "2026-06-10T09:00:00Z"), mapped to the
+         * ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime
+         * budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already
+         * available on `POST /v1/ads/boost`.)
+         *
+         */
+        startDate?: string;
+        /**
+         * Meta only. Override the Instagram account the ad is delivered as — pass an Instagram
+         * Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`.
+         * When omitted we auto-resolve the IG account linked to the connected Facebook Page
+         * (the existing default). Useful when a Page has more than one eligible IG account.
+         *
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Dynamic Creative: supply a POOL of assets and Meta auto-combines and
+         * optimises them into the best-performing variations within a single ad (mapped to the
+         * creative's `asset_feed_spec`). When set, the top-level single-creative fields
+         * (`imageUrl`, `headline`, `body`, `linkUrl`, `callToAction`) are ignored. Mutually
+         * exclusive with the `creatives[]` multi-creative shape. Meta limits: ≤10 images,
+         * ≤5 bodies / titles / descriptions.
+         *
+         */
+        dynamicCreative?: {
+            /**
+             * Pool of image URLs (1-10). Uploaded to the ad account and referenced by hash in the asset feed.
+             */
+            imageUrls: Array<(string)>;
+            /**
+             * Primary-text variations (the body copy).
+             */
+            bodies?: Array<(string)>;
+            /**
+             * Headline variations.
+             */
+            titles?: Array<(string)>;
+            /**
+             * Description (link caption) variations.
+             */
+            descriptions?: Array<(string)>;
+            /**
+             * Destination URL variations. At least one is required unless `goal` is `lead_generation`.
+             */
+            linkUrls?: Array<(string)>;
+            /**
+             * CTA-button variations. Required.
+             */
+            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
+            /**
+             * Asset-feed ad format. Defaults to SINGLE_IMAGE.
+             */
+            adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
+        };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image 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.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */

package/dist/index.d.ts

@@ -17581,6 +17581,18 @@ type CreateStandaloneAdData = {
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */
         budgetType?: 'daily' | 'lifetime';
+        /**
+         * Meta only. Where the budget lives, which selects the Meta budget model:
+         * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
+         * ad set. This is the back-compatible behaviour — omit this field to keep it.
+         * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
+         * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
+         * across ad sets automatically.
+         * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
+         * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
+         *
+         */
+        budgetLevel?: 'adset' | 'campaign';
         currency?: string;
         /**
          * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
@@ -17773,6 +17785,34 @@ type CreateStandaloneAdData = {
          * Language codes (e.g. ['en']). Restricts the audience by language.
          */
         languages?: Array<(string)>;
+        /**
+         * Meta only. Manual ad placements. Omit for automatic placements (Meta's default,
+         * recommended for most cases — Meta optimises delivery across all eligible surfaces).
+         * When set, restricts delivery to the chosen surfaces, mapped onto the ad set's
+         * `targeting.{publisher_platforms, facebook_positions, instagram_positions,
+         * messenger_positions, audience_network_positions, threads_positions,
+         * whatsapp_positions, device_platforms}`. Enum membership is validated here; Meta
+         * additionally enforces co-selection rules (e.g. some positions require their parent
+         * publisher platform) and returns an actionable error which we surface. Non-Meta
+         * platforms reject this field.
+         *
+         */
+        placements?: {
+            /**
+             * Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.
+             */
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            /**
+             * Restrict by device. Omit to deliver on both mobile and desktop.
+             */
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        };
         /**
          * ID of a `saved_targeting` audience (created via POST /v1/ads/audiences). When set, its stored
          * TargetingSpec is expanded as the base targeting; inline fields on this body merge on top. Lets you
@@ -17791,6 +17831,105 @@ type CreateStandaloneAdData = {
          * Required for lifetime budgets
          */
         endDate?: string;
+        /**
+         * Meta only. Ad-set start time (ISO 8601, e.g. "2026-06-10T09:00:00Z"), mapped to the
+         * ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime
+         * budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already
+         * available on `POST /v1/ads/boost`.)
+         *
+         */
+        startDate?: string;
+        /**
+         * Meta only. Override the Instagram account the ad is delivered as — pass an Instagram
+         * Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`.
+         * When omitted we auto-resolve the IG account linked to the connected Facebook Page
+         * (the existing default). Useful when a Page has more than one eligible IG account.
+         *
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Dynamic Creative: supply a POOL of assets and Meta auto-combines and
+         * optimises them into the best-performing variations within a single ad (mapped to the
+         * creative's `asset_feed_spec`). When set, the top-level single-creative fields
+         * (`imageUrl`, `headline`, `body`, `linkUrl`, `callToAction`) are ignored. Mutually
+         * exclusive with the `creatives[]` multi-creative shape. Meta limits: ≤10 images,
+         * ≤5 bodies / titles / descriptions.
+         *
+         */
+        dynamicCreative?: {
+            /**
+             * Pool of image URLs (1-10). Uploaded to the ad account and referenced by hash in the asset feed.
+             */
+            imageUrls: Array<(string)>;
+            /**
+             * Primary-text variations (the body copy).
+             */
+            bodies?: Array<(string)>;
+            /**
+             * Headline variations.
+             */
+            titles?: Array<(string)>;
+            /**
+             * Description (link caption) variations.
+             */
+            descriptions?: Array<(string)>;
+            /**
+             * Destination URL variations. At least one is required unless `goal` is `lead_generation`.
+             */
+            linkUrls?: Array<(string)>;
+            /**
+             * CTA-button variations. Required.
+             */
+            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
+            /**
+             * Asset-feed ad format. Defaults to SINGLE_IMAGE.
+             */
+            adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
+        };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image 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.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -18043,6 +18043,18 @@ export type CreateStandaloneAdData = {
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */
         budgetType?: 'daily' | 'lifetime';
+        /**
+         * Meta only. Where the budget lives, which selects the Meta budget model:
+         * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
+         * ad set. This is the back-compatible behaviour — omit this field to keep it.
+         * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
+         * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
+         * across ad sets automatically.
+         * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
+         * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
+         *
+         */
+        budgetLevel?: 'adset' | 'campaign';
         currency?: string;
         /**
          * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
@@ -18235,6 +18247,34 @@ export type CreateStandaloneAdData = {
          * Language codes (e.g. ['en']). Restricts the audience by language.
          */
         languages?: Array<(string)>;
+        /**
+         * Meta only. Manual ad placements. Omit for automatic placements (Meta's default,
+         * recommended for most cases — Meta optimises delivery across all eligible surfaces).
+         * When set, restricts delivery to the chosen surfaces, mapped onto the ad set's
+         * `targeting.{publisher_platforms, facebook_positions, instagram_positions,
+         * messenger_positions, audience_network_positions, threads_positions,
+         * whatsapp_positions, device_platforms}`. Enum membership is validated here; Meta
+         * additionally enforces co-selection rules (e.g. some positions require their parent
+         * publisher platform) and returns an actionable error which we surface. Non-Meta
+         * platforms reject this field.
+         *
+         */
+        placements?: {
+            /**
+             * Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.
+             */
+            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+            threadsPositions?: Array<('threads_stream')>;
+            whatsappPositions?: Array<('status')>;
+            /**
+             * Restrict by device. Omit to deliver on both mobile and desktop.
+             */
+            devicePlatforms?: Array<('mobile' | 'desktop')>;
+        };
         /**
          * ID of a `saved_targeting` audience (created via POST /v1/ads/audiences). When set, its stored
          * TargetingSpec is expanded as the base targeting; inline fields on this body merge on top. Lets you
@@ -18253,6 +18293,105 @@ export type CreateStandaloneAdData = {
          * Required for lifetime budgets
          */
         endDate?: string;
+        /**
+         * Meta only. Ad-set start time (ISO 8601, e.g. "2026-06-10T09:00:00Z"), mapped to the
+         * ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime
+         * budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already
+         * available on `POST /v1/ads/boost`.)
+         *
+         */
+        startDate?: string;
+        /**
+         * Meta only. Override the Instagram account the ad is delivered as — pass an Instagram
+         * Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`.
+         * When omitted we auto-resolve the IG account linked to the connected Facebook Page
+         * (the existing default). Useful when a Page has more than one eligible IG account.
+         *
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Dynamic Creative: supply a POOL of assets and Meta auto-combines and
+         * optimises them into the best-performing variations within a single ad (mapped to the
+         * creative's `asset_feed_spec`). When set, the top-level single-creative fields
+         * (`imageUrl`, `headline`, `body`, `linkUrl`, `callToAction`) are ignored. Mutually
+         * exclusive with the `creatives[]` multi-creative shape. Meta limits: ≤10 images,
+         * ≤5 bodies / titles / descriptions.
+         *
+         */
+        dynamicCreative?: {
+            /**
+             * Pool of image URLs (1-10). Uploaded to the ad account and referenced by hash in the asset feed.
+             */
+            imageUrls: Array<(string)>;
+            /**
+             * Primary-text variations (the body copy).
+             */
+            bodies?: Array<(string)>;
+            /**
+             * Headline variations.
+             */
+            titles?: Array<(string)>;
+            /**
+             * Description (link caption) variations.
+             */
+            descriptions?: Array<(string)>;
+            /**
+             * Destination URL variations. At least one is required unless `goal` is `lead_generation`.
+             */
+            linkUrls?: Array<(string)>;
+            /**
+             * CTA-button variations. Required.
+             */
+            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
+            /**
+             * Asset-feed ad format. Defaults to SINGLE_IMAGE.
+             */
+            adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
+        };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image 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.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */