late-sdk 0.0.694 → 0.0.696

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbf0fe01cd67abe3149890f3c719bfaa72fff603e5922d11c97fe9f040c5fdd9
-  data.tar.gz: 6a0a8f3aa81d04d1d5c3c189dd901048b1f36f77cc9f125178a6b6c7a785e0e7
+  metadata.gz: 12ba987b2654ea623ca4cbfcc0eab14e0201ec04357fd5d4dfab34494912ea3c
+  data.tar.gz: 6fe49bc03278cee3e5ce303431a1621c015cb28c6f0b9d0e6952af3ce42525cb
 SHA512:
-  metadata.gz: f61d68d843726f13ff6beccc0e10e953645e5f2c235a05d7c0802a87c0d514464514e3b60290f7273b8b7da13e7f39152b3608cfbb9cdd3c66f2e7a1ccd75ba2
-  data.tar.gz: 7647d8f894c669bed62b235e761909f2dd30f6048f7788bb17c9f2e42d33cd66eb58d1d2365811b10bfe780172b20762091f297fe8c9ffff96ad6abeea6b90f6
+  metadata.gz: 2a8d597e626f40cdc2fc4ac8371eeea96535e404b42a514d5b1019b01548cea87229c83c4fb7b81b5735a89f1b35c1784237596057c02b29391a01f1e76f68d0
+  data.tar.gz: 4886d30a0bac6358218b310bdfe1ec18ff0e39ee8bf7510ee4926df9b39736b66884466a096f1aaa84f2f16dd67197d7f79f96d2b46f6b43e6027429122fdee3

data/docs/AdCampaignsApi.md

@@ -34,7 +34,7 @@ All URIs are relative to *https://zernio.com/api*
 
 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. 
 
 ### Examples
 
@@ -48,7 +48,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::AdCampaignsApi.new
-boost_post_request = Zernio::BoostPostRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', goal: 'engagement', budget: Zernio::BoostPostRequestBudget.new({amount: 3.56, type: 'daily'})}) # BoostPostRequest | 
+boost_post_request = Zernio::BoostPostRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', goal: 'engagement'}) # BoostPostRequest | 
 
 begin
   # Boost post as ad

data/docs/BoostPostRequest.md

@@ -10,7 +10,10 @@
 | **ad_account_id** | **String** | Platform ad account ID |  |
 | **name** | **String** |  |  |
 | **goal** | **String** | 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. |  |
-| **budget** | [**BoostPostRequestBudget**](BoostPostRequestBudget.md) |  |  |
+| **ad_set_id** | **String** | 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. | [optional] |
+| **budget** | [**BoostPostRequestBudget**](BoostPostRequestBudget.md) |  | [optional] |
+| **instagram_account_id** | **String** | 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. | [optional] |
+| **destination_type** | **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. | [optional] |
 | **currency** | **String** |  | [optional] |
 | **schedule** | [**BoostPostRequestSchedule**](BoostPostRequestSchedule.md) |  | [optional] |
 | **targeting** | [**BoostPostRequestTargeting**](BoostPostRequestTargeting.md) |  | [optional] |
@@ -22,8 +25,8 @@
 | **tracking** | [**BoostPostRequestTracking**](BoostPostRequestTracking.md) |  | [optional] |
 | **special_ad_categories** | **Array<String>** | Meta only. Required for housing, employment, credit, or political ads. | [optional] |
 | **special_ad_category_country** | **Array<String>** | Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise). | [optional] |
-| **link_url** | **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).  | [optional] |
-| **call_to_action** | **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.  | [optional] |
+| **link_url** | **String** | 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.  | [optional] |
+| **call_to_action** | **String** | 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\".  | [optional] |
 | **spark_auth_code** | **String** | TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads — the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/.  | [optional] |
 | **dsa_beneficiary** | **String** | Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted.  | [optional] |
 | **dsa_payor** | **String** | Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor.  | [optional] |
@@ -41,7 +44,10 @@ instance = Zernio::BoostPostRequest.new(
   ad_account_id: null,
   name: null,
   goal: null,
+  ad_set_id: null,
   budget: null,
+  instagram_account_id: null,
+  destination_type: null,
   currency: USD,
   schedule: null,
   targeting: null,

data/docs/CreateCallAdRequest.md

@@ -12,8 +12,9 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0.  |  |
-| **budget_type** | **String** |  |  |
+| **ad_set_id** | **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.  | [optional] |
+| **budget_amount** | **Float** | 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.  | [optional] |
+| **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted.  | [optional] |
 | **end_date** | **Time** | ISO 8601 datetime. Required when `budgetType` is `lifetime`.  | [optional] |
 | **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes. Defaults to `[\"US\"]` only when no other geo (`cities`, `regions`, `zips`, `metros`, `customLocations`) is supplied.  | [optional] |
@@ -51,6 +52,7 @@ instance = Zernio::CreateCallAdRequest.new(
   image_url: null,
   video: null,
   creatives: null,
+  ad_set_id: null,
   budget_amount: null,
   budget_type: null,
   currency: null,

data/docs/CreateMessagingAdRequest.md

@@ -12,8 +12,9 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0.  |  |
-| **budget_type** | **String** |  |  |
+| **ad_set_id** | **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.  | [optional] |
+| **budget_amount** | **Float** | 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.  | [optional] |
+| **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted.  | [optional] |
 | **end_date** | **Time** | ISO 8601 datetime. Required when `budgetType` is `lifetime`.  | [optional] |
 | **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes. Defaults to `[\"US\"]` only when no other geo (`cities`, `regions`, `zips`, `metros`, `customLocations`) is supplied.  | [optional] |
@@ -50,6 +51,7 @@ instance = Zernio::CreateMessagingAdRequest.new(
   image_url: null,
   video: null,
   creatives: null,
+  ad_set_id: null,
   budget_amount: null,
   budget_type: null,
   currency: null,

data/docs/CtwaAdRequestBody.md

@@ -12,8 +12,9 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0.  |  |
-| **budget_type** | **String** |  |  |
+| **ad_set_id** | **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.  | [optional] |
+| **budget_amount** | **Float** | 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.  | [optional] |
+| **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted.  | [optional] |
 | **end_date** | **Time** | ISO 8601 datetime. Required when `budgetType` is `lifetime`.  | [optional] |
 | **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes. Defaults to `[\"US\"]` only when no other geo (`cities`, `regions`, `zips`, `metros`, `customLocations`) is supplied.  | [optional] |
@@ -49,6 +50,7 @@ instance = Zernio::CtwaAdRequestBody.new(
   image_url: null,
   video: null,
   creatives: null,
+  ad_set_id: null,
   budget_amount: null,
   budget_type: null,
   currency: null,

data/docs/MessagingAdsApi.md

@@ -29,7 +29,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagingAdsApi.new
-create_call_ad_request = Zernio::CreateCallAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily', phone_number: 'phone_number_example', link_url: 'link_url_example'}) # CreateCallAdRequest | 
+create_call_ad_request = Zernio::CreateCallAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', phone_number: 'phone_number_example', link_url: 'link_url_example'}) # CreateCallAdRequest | 
 
 begin
   # Create Click-to-Call ad
@@ -83,7 +83,7 @@ nil (empty response body)
 
 Create Click-to-WhatsApp ad (deprecated)
 
-Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.  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.
+Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.
 
 ### Examples
 
@@ -97,7 +97,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagingAdsApi.new
-ctwa_ad_request_body = Zernio::CtwaAdRequestBody.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily'}) # CtwaAdRequestBody | 
+ctwa_ad_request_body = Zernio::CtwaAdRequestBody.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example'}) # CtwaAdRequestBody | 
 
 begin
   # Create Click-to-WhatsApp ad (deprecated)
@@ -166,7 +166,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagingAdsApi.new
-create_messaging_ad_request = Zernio::CreateMessagingAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily', destination: 'whatsapp'}) # CreateMessagingAdRequest | 
+create_messaging_ad_request = Zernio::CreateMessagingAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', destination: 'whatsapp'}) # CreateMessagingAdRequest | 
 
 begin
   # Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)

data/lib/zernio-sdk/api/ad_campaigns_api.rb

@@ -20,7 +20,7 @@ module Zernio
       @api_client = api_client
     end
     # 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. 
     # @param boost_post_request [BoostPostRequest] 
     # @param [Hash] opts the optional parameters
     # @return [UpdateAd200Response]
@@ -30,7 +30,7 @@ module Zernio
     end
 
     # 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. 
     # @param boost_post_request [BoostPostRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(UpdateAd200Response, Integer, Hash)>] UpdateAd200Response data, response status code and response headers

data/lib/zernio-sdk/api/messaging_ads_api.rb

@@ -88,7 +88,7 @@ module Zernio
     end
 
     # Create Click-to-WhatsApp ad (deprecated)
-    # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.  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.
+    # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.
     # @param ctwa_ad_request_body [CtwaAdRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [CreateCtwaAd201Response]
@@ -98,7 +98,7 @@ module Zernio
     end
 
     # Create Click-to-WhatsApp ad (deprecated)
-    # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.  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.
+    # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.
     # @param ctwa_ad_request_body [CtwaAdRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreateCtwaAd201Response, Integer, Hash)>] CreateCtwaAd201Response data, response status code and response headers

data/lib/zernio-sdk/models/boost_post_request.rb

@@ -32,8 +32,17 @@ module Zernio
     # 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.
     attr_accessor :goal
 
+    # 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.
+    attr_accessor :ad_set_id
+
     attr_accessor :budget
 
+    # 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.
+    attr_accessor :instagram_account_id
+
+    # 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.
+    attr_accessor :destination_type
+
     attr_accessor :currency
 
     attr_accessor :schedule
@@ -62,10 +71,10 @@ module Zernio
     # Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
     attr_accessor :special_ad_category_country
 
-    # 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. 
     attr_accessor :link_url
 
-    # 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\". 
     attr_accessor :call_to_action
 
     # TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads — the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/. 
@@ -111,7 +120,10 @@ module Zernio
         :'ad_account_id' => :'adAccountId',
         :'name' => :'name',
         :'goal' => :'goal',
+        :'ad_set_id' => :'adSetId',
         :'budget' => :'budget',
+        :'instagram_account_id' => :'instagramAccountId',
+        :'destination_type' => :'destinationType',
         :'currency' => :'currency',
         :'schedule' => :'schedule',
         :'targeting' => :'targeting',
@@ -151,7 +163,10 @@ module Zernio
         :'ad_account_id' => :'String',
         :'name' => :'String',
         :'goal' => :'String',
+        :'ad_set_id' => :'String',
         :'budget' => :'BoostPostRequestBudget',
+        :'instagram_account_id' => :'String',
+        :'destination_type' => :'String',
         :'currency' => :'String',
         :'schedule' => :'BoostPostRequestSchedule',
         :'targeting' => :'BoostPostRequestTargeting',
@@ -226,10 +241,20 @@ module Zernio
         self.goal = nil
       end
 
+      if attributes.key?(:'ad_set_id')
+        self.ad_set_id = attributes[:'ad_set_id']
+      end
+
       if attributes.key?(:'budget')
         self.budget = attributes[:'budget']
-      else
-        self.budget = nil
+      end
+
+      if attributes.key?(:'instagram_account_id')
+        self.instagram_account_id = attributes[:'instagram_account_id']
+      end
+
+      if attributes.key?(:'destination_type')
+        self.destination_type = attributes[:'destination_type']
       end
 
       if attributes.key?(:'currency')
@@ -332,10 +357,6 @@ module Zernio
         invalid_properties.push('invalid value for "goal", goal cannot be nil.')
       end
 
-      if @budget.nil?
-        invalid_properties.push('invalid value for "budget", budget cannot be nil.')
-      end
-
       if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
         invalid_properties.push('invalid value for "dsa_beneficiary", the character length must be smaller than or equal to 100.')
       end
@@ -358,7 +379,8 @@ module Zernio
       return false if @goal.nil?
       goal_validator = EnumAttributeValidator.new('String', ["engagement", "traffic", "awareness", "video_views", "lead_generation", "conversions", "app_promotion"])
       return false unless goal_validator.valid?(@goal)
-      return false if @budget.nil?
+      destination_type_validator = EnumAttributeValidator.new('String', ["INSTAGRAM_PROFILE", "WEBSITE", "ON_AD", "MESSENGER", "WHATSAPP"])
+      return false unless destination_type_validator.valid?(@destination_type)
       return false if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
       return false if !@dsa_payor.nil? && @dsa_payor.to_s.length > 100
       true
@@ -408,14 +430,14 @@ module Zernio
       @goal = goal
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] budget Value to be assigned
-    def budget=(budget)
-      if budget.nil?
-        fail ArgumentError, 'budget cannot be nil'
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] destination_type Object to be assigned
+    def destination_type=(destination_type)
+      validator = EnumAttributeValidator.new('String', ["INSTAGRAM_PROFILE", "WEBSITE", "ON_AD", "MESSENGER", "WHATSAPP"])
+      unless validator.valid?(destination_type)
+        fail ArgumentError, "invalid value for \"destination_type\", must be one of #{validator.allowable_values}."
       end
-
-      @budget = budget
+      @destination_type = destination_type
     end
 
     # Custom attribute writer method with validation
@@ -457,7 +479,10 @@ module Zernio
           ad_account_id == o.ad_account_id &&
           name == o.name &&
           goal == o.goal &&
+          ad_set_id == o.ad_set_id &&
           budget == o.budget &&
+          instagram_account_id == o.instagram_account_id &&
+          destination_type == o.destination_type &&
           currency == o.currency &&
           schedule == o.schedule &&
           targeting == o.targeting &&
@@ -486,7 +511,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [post_id, platform_post_id, account_id, ad_account_id, name, goal, budget, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, optimization_goal].hash
+      [post_id, platform_post_id, account_id, ad_account_id, name, goal, ad_set_id, budget, instagram_account_id, destination_type, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, optimization_goal].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/boost_post_request_budget.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
+  # Required unless adSetId is set.
   class BoostPostRequestBudget < ApiModelBase
     # Minimum varies: TikTok=$20, Pinterest=$5, others=$1
     attr_accessor :amount

data/lib/zernio-sdk/models/create_call_ad_request.rb

@@ -38,9 +38,13 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. 
+    # 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. 
+    attr_accessor :ad_set_id
+
+    # 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. 
     attr_accessor :budget_amount
 
+    # Required unless `adSetId` is set.
     attr_accessor :budget_type
 
     # ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted. 
@@ -138,6 +142,7 @@ module Zernio
         :'image_url' => :'imageUrl',
         :'video' => :'video',
         :'creatives' => :'creatives',
+        :'ad_set_id' => :'adSetId',
         :'budget_amount' => :'budgetAmount',
         :'budget_type' => :'budgetType',
         :'currency' => :'currency',
@@ -186,6 +191,7 @@ module Zernio
         :'image_url' => :'String',
         :'video' => :'CtwaAdRequestBodyVideo',
         :'creatives' => :'Array<CtwaAdRequestBodyCreativesInner>',
+        :'ad_set_id' => :'String',
         :'budget_amount' => :'Float',
         :'budget_type' => :'String',
         :'currency' => :'String',
@@ -282,16 +288,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'ad_set_id')
+        self.ad_set_id = attributes[:'ad_set_id']
+      end
+
       if attributes.key?(:'budget_amount')
         self.budget_amount = attributes[:'budget_amount']
-      else
-        self.budget_amount = nil
       end
 
       if attributes.key?(:'budget_type')
         self.budget_type = attributes[:'budget_type']
-      else
-        self.budget_type = nil
       end
 
       if attributes.key?(:'currency')
@@ -446,14 +452,6 @@ module Zernio
         invalid_properties.push('invalid value for "creatives", number of items must be greater than or equal to 1.')
       end
 
-      if @budget_amount.nil?
-        invalid_properties.push('invalid value for "budget_amount", budget_amount cannot be nil.')
-      end
-
-      if @budget_type.nil?
-        invalid_properties.push('invalid value for "budget_type", budget_type cannot be nil.')
-      end
-
       if !@currency.nil? && @currency.to_s.length > 3
         invalid_properties.push('invalid value for "currency", the character length must be smaller than or equal to 3.')
       end
@@ -511,8 +509,6 @@ module Zernio
       return false if !@headline.nil? && @headline.to_s.length < 1
       return false if !@body.nil? && @body.to_s.length < 1
       return false if !@creatives.nil? && @creatives.length < 1
-      return false if @budget_amount.nil?
-      return false if @budget_type.nil?
       budget_type_validator = EnumAttributeValidator.new('String', ["daily", "lifetime"])
       return false unless budget_type_validator.valid?(@budget_type)
       return false if !@currency.nil? && @currency.to_s.length > 3
@@ -622,16 +618,6 @@ module Zernio
       @creatives = creatives
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] budget_amount Value to be assigned
-    def budget_amount=(budget_amount)
-      if budget_amount.nil?
-        fail ArgumentError, 'budget_amount cannot be nil'
-      end
-
-      @budget_amount = budget_amount
-    end
-
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] budget_type Object to be assigned
     def budget_type=(budget_type)
@@ -787,6 +773,7 @@ module Zernio
           image_url == o.image_url &&
           video == o.video &&
           creatives == o.creatives &&
+          ad_set_id == o.ad_set_id &&
           budget_amount == o.budget_amount &&
           budget_type == o.budget_type &&
           currency == o.currency &&
@@ -822,7 +809,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_messaging_ad_request.rb

@@ -38,9 +38,13 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. 
+    # 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. 
+    attr_accessor :ad_set_id
+
+    # 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. 
     attr_accessor :budget_amount
 
+    # Required unless `adSetId` is set.
     attr_accessor :budget_type
 
     # ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted. 
@@ -135,6 +139,7 @@ module Zernio
         :'image_url' => :'imageUrl',
         :'video' => :'video',
         :'creatives' => :'creatives',
+        :'ad_set_id' => :'adSetId',
         :'budget_amount' => :'budgetAmount',
         :'budget_type' => :'budgetType',
         :'currency' => :'currency',
@@ -182,6 +187,7 @@ module Zernio
         :'image_url' => :'String',
         :'video' => :'CtwaAdRequestBodyVideo',
         :'creatives' => :'Array<CtwaAdRequestBodyCreativesInner>',
+        :'ad_set_id' => :'String',
         :'budget_amount' => :'Float',
         :'budget_type' => :'String',
         :'currency' => :'String',
@@ -277,16 +283,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'ad_set_id')
+        self.ad_set_id = attributes[:'ad_set_id']
+      end
+
       if attributes.key?(:'budget_amount')
         self.budget_amount = attributes[:'budget_amount']
-      else
-        self.budget_amount = nil
       end
 
       if attributes.key?(:'budget_type')
         self.budget_type = attributes[:'budget_type']
-      else
-        self.budget_type = nil
       end
 
       if attributes.key?(:'currency')
@@ -435,14 +441,6 @@ module Zernio
         invalid_properties.push('invalid value for "creatives", number of items must be greater than or equal to 1.')
       end
 
-      if @budget_amount.nil?
-        invalid_properties.push('invalid value for "budget_amount", budget_amount cannot be nil.')
-      end
-
-      if @budget_type.nil?
-        invalid_properties.push('invalid value for "budget_type", budget_type cannot be nil.')
-      end
-
       if !@currency.nil? && @currency.to_s.length > 3
         invalid_properties.push('invalid value for "currency", the character length must be smaller than or equal to 3.')
       end
@@ -496,8 +494,6 @@ module Zernio
       return false if !@headline.nil? && @headline.to_s.length < 1
       return false if !@body.nil? && @body.to_s.length < 1
       return false if !@creatives.nil? && @creatives.length < 1
-      return false if @budget_amount.nil?
-      return false if @budget_type.nil?
       budget_type_validator = EnumAttributeValidator.new('String', ["daily", "lifetime"])
       return false unless budget_type_validator.valid?(@budget_type)
       return false if !@currency.nil? && @currency.to_s.length > 3
@@ -608,16 +604,6 @@ module Zernio
       @creatives = creatives
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] budget_amount Value to be assigned
-    def budget_amount=(budget_amount)
-      if budget_amount.nil?
-        fail ArgumentError, 'budget_amount cannot be nil'
-      end
-
-      @budget_amount = budget_amount
-    end
-
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] budget_type Object to be assigned
     def budget_type=(budget_type)
@@ -763,6 +749,7 @@ module Zernio
           image_url == o.image_url &&
           video == o.video &&
           creatives == o.creatives &&
+          ad_set_id == o.ad_set_id &&
           budget_amount == o.budget_amount &&
           budget_type == o.budget_type &&
           currency == o.currency &&
@@ -797,7 +784,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, destination].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, destination].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/ctwa_ad_request_body.rb

@@ -39,9 +39,13 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. 
+    # 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. 
+    attr_accessor :ad_set_id
+
+    # 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. 
     attr_accessor :budget_amount
 
+    # Required unless `adSetId` is set.
     attr_accessor :budget_type
 
     # ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted. 
@@ -133,6 +137,7 @@ module Zernio
         :'image_url' => :'imageUrl',
         :'video' => :'video',
         :'creatives' => :'creatives',
+        :'ad_set_id' => :'adSetId',
         :'budget_amount' => :'budgetAmount',
         :'budget_type' => :'budgetType',
         :'currency' => :'currency',
@@ -179,6 +184,7 @@ module Zernio
         :'image_url' => :'String',
         :'video' => :'CtwaAdRequestBodyVideo',
         :'creatives' => :'Array<CtwaAdRequestBodyCreativesInner>',
+        :'ad_set_id' => :'String',
         :'budget_amount' => :'Float',
         :'budget_type' => :'String',
         :'currency' => :'String',
@@ -266,16 +272,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'ad_set_id')
+        self.ad_set_id = attributes[:'ad_set_id']
+      end
+
       if attributes.key?(:'budget_amount')
         self.budget_amount = attributes[:'budget_amount']
-      else
-        self.budget_amount = nil
       end
 
       if attributes.key?(:'budget_type')
         self.budget_type = attributes[:'budget_type']
-      else
-        self.budget_type = nil
       end
 
       if attributes.key?(:'currency')
@@ -418,14 +424,6 @@ module Zernio
         invalid_properties.push('invalid value for "creatives", number of items must be greater than or equal to 1.')
       end
 
-      if @budget_amount.nil?
-        invalid_properties.push('invalid value for "budget_amount", budget_amount cannot be nil.')
-      end
-
-      if @budget_type.nil?
-        invalid_properties.push('invalid value for "budget_type", budget_type cannot be nil.')
-      end
-
       if !@currency.nil? && @currency.to_s.length > 3
         invalid_properties.push('invalid value for "currency", the character length must be smaller than or equal to 3.')
       end
@@ -475,8 +473,6 @@ module Zernio
       return false if !@headline.nil? && @headline.to_s.length < 1
       return false if !@body.nil? && @body.to_s.length < 1
       return false if !@creatives.nil? && @creatives.length < 1
-      return false if @budget_amount.nil?
-      return false if @budget_type.nil?
       budget_type_validator = EnumAttributeValidator.new('String', ["daily", "lifetime"])
       return false unless budget_type_validator.valid?(@budget_type)
       return false if !@currency.nil? && @currency.to_s.length > 3
@@ -584,16 +580,6 @@ module Zernio
       @creatives = creatives
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] budget_amount Value to be assigned
-    def budget_amount=(budget_amount)
-      if budget_amount.nil?
-        fail ArgumentError, 'budget_amount cannot be nil'
-      end
-
-      @budget_amount = budget_amount
-    end
-
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] budget_type Object to be assigned
     def budget_type=(budget_type)
@@ -729,6 +715,7 @@ module Zernio
           image_url == o.image_url &&
           video == o.video &&
           creatives == o.creatives &&
+          ad_set_id == o.ad_set_id &&
           budget_amount == o.budget_amount &&
           budget_type == o.budget_type &&
           currency == o.currency &&
@@ -762,7 +749,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.694'
+  VERSION = '0.0.696'
 end

data/openapi.yaml

@@ -752,7 +752,7 @@ components:
         expiresAt: { type: [string, "null"], description: "When the reservation's locked price expires (set after reserving)." }
     CtwaAdRequestBody:
       type: object
-      required: [accountId, adAccountId, name, budgetAmount, budgetType]
+      required: [accountId, adAccountId, name]
       description: |
         In addition to the `required` list, the request must use
         EXACTLY ONE of the two shapes:
@@ -862,15 +862,26 @@ components:
                 description: |
                   Video creative. Mutually exclusive with this entry's
                   `imageUrl`. Required if `imageUrl` is not supplied.
+        adSetId:
+          type: string
+          description: |
+            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.
         budgetAmount:
           type: number
           exclusiveMinimum: 0
           description: |
             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.
         budgetType:
           type: string
           enum: [daily, lifetime]
+          description: Required unless `adSetId` is set.
         currency:
           type: string
           minLength: 3
@@ -16304,7 +16315,7 @@ paths:
                   selectedLocationName: "My Coffee Shop"
                   selectedLocationId: "9281089117903930794"
         '400':
-          description: "Missing required fields (profileId, locationId, or tempToken)"
+          description: 'Missing required fields (profileId, locationId, or tempToken), or the provided accountId is not one of the accounts this connection manages'
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: User does not have access to the specified profile
@@ -20829,7 +20840,7 @@ paths:
                 selectedLocation:
                   id: "12345678901234567890"
                   name: "My Business Location"
-        '400': { description: Location not in available locations }
+        '400': { description: 'Location not in available locations, or the provided googleAccountId is not one of the accounts this connection manages' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Account not found }
 
@@ -20909,7 +20920,7 @@ paths:
                   isActive: true
                   selectedLocationName: "Snap Fitness Dianella"
                   selectedLocationId: "12345678901234567890"
-        '400': { description: 'Invalid body, or selected location not found under the Google account' }
+        '400': { description: 'Invalid body, selected location not found under the Google account, or the provided googleAccountId is not one of the accounts this connection manages' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403': { description: 'Payment required, or target profile exceeds plan limit' }
         '404': { description: Source Google Business account not found }
@@ -39424,7 +39435,19 @@ paths:
       tags: ["Ad Campaigns"]
       x-platforms: ["meta"]
       summary: Boost post as ad
-      description: Creates a paid ad campaign from an existing published post. Creates the full platform campaign hierarchy (campaign, ad set, ad).
+      description: |
+        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.
       security:
         - bearerAuth: []
       requestBody:
@@ -39433,7 +39456,7 @@ paths:
           application/json:
             schema:
               type: object
-              required: [accountId, adAccountId, name, goal, budget]
+              required: [accountId, adAccountId, name, goal]
               properties:
                 postId: { type: string, description: Zernio post ID (provide this or platformPostId) }
                 platformPostId: { type: string, description: Platform post ID (alternative to postId) }
@@ -39441,12 +39464,16 @@ paths:
                 adAccountId: { type: string, description: Platform ad account ID }
                 name: { type: string, maxLength: 255 }
                 goal: { type: string, enum: [engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion], description: "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." }
+                adSetId: { type: string, description: "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." }
                 budget:
                   type: object
+                  description: "Required unless adSetId is set."
                   required: [amount, type]
                   properties:
                     amount: { type: number, description: "Minimum varies: TikTok=$20, Pinterest=$5, others=$1" }
                     type: { type: string, enum: [daily, lifetime] }
+                instagramAccountId: { type: string, description: "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." }
+                destinationType: { type: string, enum: [INSTAGRAM_PROFILE, WEBSITE, ON_AD, MESSENGER, WHATSAPP], description: "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." }
                 currency: { type: string, example: USD }
                 schedule:
                   type: object
@@ -39601,19 +39628,31 @@ paths:
                   type: string
                   format: uri
                   description: |
-                    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.
                 callToAction:
                   type: string
                   description: |
-                    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".
                 sparkAuthCode:
                   type: string
                   description: |
@@ -43018,6 +43057,8 @@ paths:
 
         - **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.
       security:
         - bearerAuth: []

data/spec/api/ad_campaigns_api_spec.rb

@@ -34,7 +34,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for boost_post
   # 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. 
   # @param boost_post_request 
   # @param [Hash] opts the optional parameters
   # @return [UpdateAd200Response]

data/spec/api/messaging_ads_api_spec.rb

@@ -46,7 +46,7 @@ describe 'MessagingAdsApi' do
 
   # unit tests for create_ctwa_ad
   # Create Click-to-WhatsApp ad (deprecated)
-  # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.  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.
+  # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **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.
   # @param ctwa_ad_request_body 
   # @param [Hash] opts the optional parameters
   # @return [CreateCtwaAd201Response]

data/spec/models/boost_post_request_spec.rb

@@ -67,12 +67,34 @@ describe Zernio::BoostPostRequest do
     end
   end
 
+  describe 'test attribute "ad_set_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "budget"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
+  describe 'test attribute "instagram_account_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "destination_type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["INSTAGRAM_PROFILE", "WEBSITE", "ON_AD", "MESSENGER", "WHATSAPP"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.destination_type = value }.not_to raise_error
+      # end
+    end
+  end
+
   describe 'test attribute "currency"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_call_ad_request_spec.rb

@@ -75,6 +75,12 @@ describe Zernio::CreateCallAdRequest do
     end
   end
 
+  describe 'test attribute "ad_set_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "budget_amount"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_messaging_ad_request_spec.rb

@@ -75,6 +75,12 @@ describe Zernio::CreateMessagingAdRequest do
     end
   end
 
+  describe 'test attribute "ad_set_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "budget_amount"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/ctwa_ad_request_body_spec.rb

@@ -75,6 +75,12 @@ describe Zernio::CtwaAdRequestBody do
     end
   end
 
+  describe 'test attribute "ad_set_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "budget_amount"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.694
+  version: 0.0.696
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -5024,7 +5024,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.694.gem
+- zernio-sdk-0.0.696.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: