@zernio/node 0.2.527 → 0.2.529

package/dist/index.d.mts

@@ -3025,13 +3025,27 @@ type CtwaAdRequestBody = {
             thumbnailUrl: string;
         };
     }>;
+    /**
+     * Attach the creatives to this EXISTING messaging ad set instead of
+     * building a campaign, so the ad set keeps its learning phase. It then
+     * owns budget, targeting and schedule, so `budgetAmount`, `budgetType`,
+     * `endDate`, `objective`, `countries`, `interests` and `audienceId` are
+     * rejected with a 400 alongside it. Its `destination_type` must match
+     * the ad's destination.
+     *
+     */
+    adSetId?: string;
     /**
      * Budget amount in the ad account's currency major units
      * (e.g. dollars for USD, not cents). Must be > 0.
+     * Required unless `adSetId` is set, where the ad set owns it.
      *
      */
-    budgetAmount: number;
-    budgetType: 'daily' | 'lifetime';
+    budgetAmount?: number;
+    /**
+     * Required unless `adSetId` is set.
+     */
+    budgetType?: 'daily' | 'lifetime';
     /**
      * ISO 4217 currency code matching the ad account's currency
      * (e.g. `USD`). Optional; Meta infers from the ad account
@@ -3200,6 +3214,9 @@ type CtwaAdRequestBody = {
      */
     dsaPayor?: string;
 };
+/**
+ * Required unless `adSetId` is set.
+ */
 type budgetType = 'daily' | 'lifetime';
 /**
  * Meta's Advantage+ audience expansion. `0` (default) keeps
@@ -17468,7 +17485,7 @@ type SendInboxMessageData = {
     };
     path: {
         /**
-         * The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+         * Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
          */
         conversationId: string;
     };
@@ -28231,13 +28248,28 @@ type BoostPostData = {
          * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
          */
         goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budget: {
+        /**
+         * Meta only. Attach the boosted post to this existing ad set instead of creating a campaign. The ad set then owns budget, schedule and targeting; sending those too is a 400.
+         */
+        adSetId?: string;
+        /**
+         * Required unless adSetId is set.
+         */
+        budget?: {
             /**
              * Minimum varies: TikTok=$20, Pinterest=$5, others=$1
              */
             amount: number;
             type: 'daily' | 'lifetime';
         };
+        /**
+         * Meta only. Instagram identity the ad runs AS (creative.instagram_user_id), overriding the account linked to the Page. Live-verified against a Page-post creative.
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Ad-set destination_type — where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Lead ads force ON_AD and ignore this.
+         */
+        destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP';
         currency?: string;
         schedule?: {
             startDate?: string;
@@ -28403,20 +28435,32 @@ type BoostPostData = {
          */
         specialAdCategoryCountry?: Array<(string)>;
         /**
-         * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
-         * Spark Ads have no clickable destination — required for traffic / conversion
-         * objectives. Maps to `landing_page_url` on the creative entry of /v2/ad/create/
-         * (TikTok SDK `AdcreateCreatives.landing_page_url`). Ignored on Meta / LinkedIn /
-         * Pinterest / X / Google (those infer the destination from the boosted post).
+         * Destination URL for the CTA button. Send it together with `callToAction`.
+         *
+         * **Meta**: adds a top-level `call_to_action` to the post-reference creative.
+         * This is what gives a `traffic` boost a clickable destination without
+         * replacing the creative and losing the post's social proof. Ignored when
+         * `leadGenFormId` is set, which supplies its own destination. Live-verified
+         * against a Page-post creative.
+         *
+         * **TikTok**: maps to `landing_page_url` on the Spark Ad creative
+         * (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable
+         * destination without it.
+         *
+         * Ignored on LinkedIn / Pinterest / X / Google, which infer the destination
+         * from the boosted post.
          *
          */
         linkUrl?: string;
         /**
-         * TikTok-only. Call-to-action button label on the Spark Ad creative (e.g.
-         * `LEARN_MORE`, `SHOP_NOW`, `DOWNLOAD_NOW`, `SIGN_UP`, `WATCH_NOW`). Maps to
-         * `call_to_action` on the creative entry of /v2/ad/create/. Pass-through —
-         * the platform validates the value. See TikTok's "Enumeration - Call-to-Action"
-         * reference for the full list.
+         * CTA button label. Send it together with `linkUrl` — a CTA without a
+         * destination produces a button that goes nowhere, so sending one alone is a 400.
+         *
+         * **Meta**: validated against the Meta CTA enum (same values as
+         * POST /v1/ads/create), e.g. `LEARN_MORE`, `SHOP_NOW`, `SIGN_UP`.
+         *
+         * **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the
+         * platform validates the value. See TikTok's "Enumeration - Call-to-Action".
          *
          */
         callToAction?: string;

package/dist/index.d.ts

@@ -3025,13 +3025,27 @@ type CtwaAdRequestBody = {
             thumbnailUrl: string;
         };
     }>;
+    /**
+     * Attach the creatives to this EXISTING messaging ad set instead of
+     * building a campaign, so the ad set keeps its learning phase. It then
+     * owns budget, targeting and schedule, so `budgetAmount`, `budgetType`,
+     * `endDate`, `objective`, `countries`, `interests` and `audienceId` are
+     * rejected with a 400 alongside it. Its `destination_type` must match
+     * the ad's destination.
+     *
+     */
+    adSetId?: string;
     /**
      * Budget amount in the ad account's currency major units
      * (e.g. dollars for USD, not cents). Must be > 0.
+     * Required unless `adSetId` is set, where the ad set owns it.
      *
      */
-    budgetAmount: number;
-    budgetType: 'daily' | 'lifetime';
+    budgetAmount?: number;
+    /**
+     * Required unless `adSetId` is set.
+     */
+    budgetType?: 'daily' | 'lifetime';
     /**
      * ISO 4217 currency code matching the ad account's currency
      * (e.g. `USD`). Optional; Meta infers from the ad account
@@ -3200,6 +3214,9 @@ type CtwaAdRequestBody = {
      */
     dsaPayor?: string;
 };
+/**
+ * Required unless `adSetId` is set.
+ */
 type budgetType = 'daily' | 'lifetime';
 /**
  * Meta's Advantage+ audience expansion. `0` (default) keeps
@@ -17468,7 +17485,7 @@ type SendInboxMessageData = {
     };
     path: {
         /**
-         * The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+         * Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
          */
         conversationId: string;
     };
@@ -28231,13 +28248,28 @@ type BoostPostData = {
          * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
          */
         goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budget: {
+        /**
+         * Meta only. Attach the boosted post to this existing ad set instead of creating a campaign. The ad set then owns budget, schedule and targeting; sending those too is a 400.
+         */
+        adSetId?: string;
+        /**
+         * Required unless adSetId is set.
+         */
+        budget?: {
             /**
              * Minimum varies: TikTok=$20, Pinterest=$5, others=$1
              */
             amount: number;
             type: 'daily' | 'lifetime';
         };
+        /**
+         * Meta only. Instagram identity the ad runs AS (creative.instagram_user_id), overriding the account linked to the Page. Live-verified against a Page-post creative.
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Ad-set destination_type — where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Lead ads force ON_AD and ignore this.
+         */
+        destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP';
         currency?: string;
         schedule?: {
             startDate?: string;
@@ -28403,20 +28435,32 @@ type BoostPostData = {
          */
         specialAdCategoryCountry?: Array<(string)>;
         /**
-         * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
-         * Spark Ads have no clickable destination — required for traffic / conversion
-         * objectives. Maps to `landing_page_url` on the creative entry of /v2/ad/create/
-         * (TikTok SDK `AdcreateCreatives.landing_page_url`). Ignored on Meta / LinkedIn /
-         * Pinterest / X / Google (those infer the destination from the boosted post).
+         * Destination URL for the CTA button. Send it together with `callToAction`.
+         *
+         * **Meta**: adds a top-level `call_to_action` to the post-reference creative.
+         * This is what gives a `traffic` boost a clickable destination without
+         * replacing the creative and losing the post's social proof. Ignored when
+         * `leadGenFormId` is set, which supplies its own destination. Live-verified
+         * against a Page-post creative.
+         *
+         * **TikTok**: maps to `landing_page_url` on the Spark Ad creative
+         * (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable
+         * destination without it.
+         *
+         * Ignored on LinkedIn / Pinterest / X / Google, which infer the destination
+         * from the boosted post.
          *
          */
         linkUrl?: string;
         /**
-         * TikTok-only. Call-to-action button label on the Spark Ad creative (e.g.
-         * `LEARN_MORE`, `SHOP_NOW`, `DOWNLOAD_NOW`, `SIGN_UP`, `WATCH_NOW`). Maps to
-         * `call_to_action` on the creative entry of /v2/ad/create/. Pass-through —
-         * the platform validates the value. See TikTok's "Enumeration - Call-to-Action"
-         * reference for the full list.
+         * CTA button label. Send it together with `linkUrl` — a CTA without a
+         * destination produces a button that goes nowhere, so sending one alone is a 400.
+         *
+         * **Meta**: validated against the Meta CTA enum (same values as
+         * POST /v1/ads/create), e.g. `LEARN_MORE`, `SHOP_NOW`, `SIGN_UP`.
+         *
+         * **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the
+         * platform validates the value. See TikTok's "Enumeration - Call-to-Action".
          *
          */
         callToAction?: string;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -7855,7 +7855,19 @@ export const getDsaRecommendations = <ThrowOnError extends boolean = false>(opti
 
 /**
  * Boost post as ad
- * Creates a paid ad campaign from an existing published post. Creates the full platform campaign hierarchy (campaign, ad set, ad).
+ * Creates a paid ad from an existing published post, keeping the post's
+ * engagement. By default it provisions the whole hierarchy (campaign, ad
+ * set, ad).
+ *
+ * **Attach shape (Meta).** Send `adSetId` to put the ad under an EXISTING
+ * ad set instead, so that ad set keeps its learning phase. It then owns
+ * `budget`, `schedule` and `targeting`, and sending any of those alongside
+ * `adSetId` is a 400 rather than a silent drop. `budget` is required only
+ * without `adSetId`.
+ *
+ * `instagramAccountId`, `destinationType` and `adSetId` are Meta-only and
+ * return 400 on other platforms.
+ *
  */
 export const boostPost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BoostPostData, ThrowOnError>) => {
     return (options?.client ?? client).post<BoostPostResponse, BoostPostError, ThrowOnError>({
@@ -8608,6 +8620,8 @@ export const createCallAd = <ThrowOnError extends boolean = false>(options: Opti
  *
  * - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.
  *
+ * **Attach shape.** Send `adSetId` (with either creative shape) to add the ads to an EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase — the way to refresh a CTWA creative without resetting delivery. The ad set then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it rather than silently dropped. The target ad set's `destination_type` must match the ad's destination (a WhatsApp ad needs a `WHATSAPP` ad set), otherwise Meta would accept an ad that never delivers.
+ *
  * Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
  */
 export const createCtwaAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateCtwaAdData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -1854,13 +1854,27 @@ export type CtwaAdRequestBody = {
             thumbnailUrl: string;
         };
     }>;
+    /**
+     * Attach the creatives to this EXISTING messaging ad set instead of
+     * building a campaign, so the ad set keeps its learning phase. It then
+     * owns budget, targeting and schedule, so `budgetAmount`, `budgetType`,
+     * `endDate`, `objective`, `countries`, `interests` and `audienceId` are
+     * rejected with a 400 alongside it. Its `destination_type` must match
+     * the ad's destination.
+     *
+     */
+    adSetId?: string;
     /**
      * Budget amount in the ad account's currency major units
      * (e.g. dollars for USD, not cents). Must be > 0.
+     * Required unless `adSetId` is set, where the ad set owns it.
      *
      */
-    budgetAmount: number;
-    budgetType: 'daily' | 'lifetime';
+    budgetAmount?: number;
+    /**
+     * Required unless `adSetId` is set.
+     */
+    budgetType?: 'daily' | 'lifetime';
     /**
      * ISO 4217 currency code matching the ad account's currency
      * (e.g. `USD`). Optional; Meta infers from the ad account
@@ -2030,6 +2044,9 @@ export type CtwaAdRequestBody = {
     dsaPayor?: string;
 };
 
+/**
+ * Required unless `adSetId` is set.
+ */
 export type budgetType = 'daily' | 'lifetime';
 
 /**
@@ -17131,7 +17148,7 @@ export type SendInboxMessageData = {
     };
     path: {
         /**
-         * The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+         * Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
          */
         conversationId: string;
     };
@@ -28767,13 +28784,28 @@ export type BoostPostData = {
          * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
          */
         goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budget: {
+        /**
+         * Meta only. Attach the boosted post to this existing ad set instead of creating a campaign. The ad set then owns budget, schedule and targeting; sending those too is a 400.
+         */
+        adSetId?: string;
+        /**
+         * Required unless adSetId is set.
+         */
+        budget?: {
             /**
              * Minimum varies: TikTok=$20, Pinterest=$5, others=$1
              */
             amount: number;
             type: 'daily' | 'lifetime';
         };
+        /**
+         * Meta only. Instagram identity the ad runs AS (creative.instagram_user_id), overriding the account linked to the Page. Live-verified against a Page-post creative.
+         */
+        instagramAccountId?: string;
+        /**
+         * Meta only. Ad-set destination_type — where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Lead ads force ON_AD and ignore this.
+         */
+        destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP';
         currency?: string;
         schedule?: {
             startDate?: string;
@@ -28939,20 +28971,32 @@ export type BoostPostData = {
          */
         specialAdCategoryCountry?: Array<(string)>;
         /**
-         * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
-         * Spark Ads have no clickable destination — required for traffic / conversion
-         * objectives. Maps to `landing_page_url` on the creative entry of /v2/ad/create/
-         * (TikTok SDK `AdcreateCreatives.landing_page_url`). Ignored on Meta / LinkedIn /
-         * Pinterest / X / Google (those infer the destination from the boosted post).
+         * Destination URL for the CTA button. Send it together with `callToAction`.
+         *
+         * **Meta**: adds a top-level `call_to_action` to the post-reference creative.
+         * This is what gives a `traffic` boost a clickable destination without
+         * replacing the creative and losing the post's social proof. Ignored when
+         * `leadGenFormId` is set, which supplies its own destination. Live-verified
+         * against a Page-post creative.
+         *
+         * **TikTok**: maps to `landing_page_url` on the Spark Ad creative
+         * (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable
+         * destination without it.
+         *
+         * Ignored on LinkedIn / Pinterest / X / Google, which infer the destination
+         * from the boosted post.
          *
          */
         linkUrl?: string;
         /**
-         * TikTok-only. Call-to-action button label on the Spark Ad creative (e.g.
-         * `LEARN_MORE`, `SHOP_NOW`, `DOWNLOAD_NOW`, `SIGN_UP`, `WATCH_NOW`). Maps to
-         * `call_to_action` on the creative entry of /v2/ad/create/. Pass-through —
-         * the platform validates the value. See TikTok's "Enumeration - Call-to-Action"
-         * reference for the full list.
+         * CTA button label. Send it together with `linkUrl` — a CTA without a
+         * destination produces a button that goes nowhere, so sending one alone is a 400.
+         *
+         * **Meta**: validated against the Meta CTA enum (same values as
+         * POST /v1/ads/create), e.g. `LEARN_MORE`, `SHOP_NOW`, `SIGN_UP`.
+         *
+         * **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the
+         * platform validates the value. See TikTok's "Enumeration - Call-to-Action".
          *
          */
         callToAction?: string;