zernio-sdk 0.0.528 → 0.0.530

data/docs/CreateMessagingAdRequest.md

@@ -0,0 +1,78 @@
+# Zernio::CreateMessagingAdRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Facebook or Instagram SocialAccount ID. |  |
+| **ad_account_id** | **String** | Meta ad account ID, e.g. `act_123456789`. |  |
+| **name** | **String** | Ad display name. Used to derive campaign / ad set names. On the multi-creative shape, each ad's Meta name gets a \" #N\" suffix (1-indexed) so Ads Manager shows them as a numbered batch.  |  |
+| **headline** | **String** | Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
+| **body** | **String** | Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
+| **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** |  |  |
+| **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] |
+| **cities** | [**Array<CtwaAdRequestBodyCitiesInner>**](CtwaAdRequestBodyCitiesInner.md) | City-level geo targeting for local CTWA campaigns. Each entry maps to Meta's TargetingGeoLocationCity. `key` is Meta's city ID. `radius` and `distance_unit` are coupled: set both or neither. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).  | [optional] |
+| **regions** | [**Array<CtwaAdRequestBodyRegionsInner>**](CtwaAdRequestBodyRegionsInner.md) | Region / state-level geo targeting. `key` is Meta's region ID (lookupable via GET /v1/ads/targeting/search?type=region).  | [optional] |
+| **zips** | [**Array<CtwaAdRequestBodyZipsInner>**](CtwaAdRequestBodyZipsInner.md) | ZIP / postal-code geo targeting. `key` is the platform's postal id resolved via /v1/ads/targeting/search.  | [optional] |
+| **metros** | [**Array<CtwaAdRequestBodyZipsInner>**](CtwaAdRequestBodyZipsInner.md) | DMA / metro-area geo targeting. `key` is Meta's metro id (e.g. `DMA:807`).  | [optional] |
+| **custom_locations** | [**Array<CreateStandaloneAdRequestCustomLocationsInner>**](CreateStandaloneAdRequestCustomLocationsInner.md) | Point-radius geo (Meta `geo_locations.custom_locations`). Use for targeting a radius around a specific lat/long when no Meta city/region key fits. `distanceUnit` is required.  | [optional] |
+| **age_min** | **Integer** |  | [optional] |
+| **age_max** | **Integer** |  | [optional] |
+| **interests** | [**Array<CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md) |  | [optional] |
+| **audience_id** | **String** | Custom audience ID to target. | [optional] |
+| **placements** | [**CtwaAdRequestBodyPlacements**](CtwaAdRequestBodyPlacements.md) |  | [optional] |
+| **advantage_audience** | **Integer** | Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it).  | [optional] |
+| **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
+| **bid_strategy** | **String** | Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent.  | [optional] |
+| **bid_amount** | **Float** | Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise.  | [optional] |
+| **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [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] |
+| **destination** | **String** | Where the conversation opens when the ad is tapped. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateMessagingAdRequest.new(
+  account_id: null,
+  ad_account_id: null,
+  name: null,
+  headline: null,
+  body: null,
+  image_url: null,
+  video: null,
+  creatives: null,
+  budget_amount: null,
+  budget_type: null,
+  currency: null,
+  end_date: null,
+  countries: null,
+  cities: null,
+  regions: null,
+  zips: null,
+  metros: null,
+  custom_locations: null,
+  age_min: null,
+  age_max: null,
+  interests: null,
+  audience_id: null,
+  placements: null,
+  advantage_audience: null,
+  objective: null,
+  bid_strategy: null,
+  bid_amount: null,
+  roas_average_floor: null,
+  dsa_beneficiary: null,
+  dsa_payor: null,
+  destination: null
+)
+```
+

data/docs/CreateStandaloneAdRequest.md

@@ -57,6 +57,7 @@
 | **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we auto-resolve the IG account linked to the connected Facebook Page (the existing default). Useful when a Page has more than one eligible IG account.  | [optional] |
 | **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
+| **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`.  | [optional] |
 | **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID for targeting | [optional] |
 | **campaign_type** | **String** | Google only | [optional][default to 'display'] |
@@ -135,6 +136,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   start_date: null,
   instagram_account_id: null,
   dynamic_creative: null,
+  carousel_cards: null,
   placement_assets: null,
   audience_id: null,
   campaign_type: null,

data/docs/CreateStandaloneAdRequestCarouselCardsInner.md

@@ -0,0 +1,26 @@
+# Zernio::CreateStandaloneAdRequestCarouselCardsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image_url** | **String** | Card image; uploaded to the ad account and referenced by hash. |  |
+| **link_url** | **String** | Card destination URL. Defaults to the top-level linkUrl. | [optional] |
+| **headline** | **String** | Card headline, shown below the card image. | [optional] |
+| **description** | **String** | Card description, shown under the headline. | [optional] |
+| **call_to_action** | **String** | Card CTA override. Defaults to the top-level callToAction; same enum. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCarouselCardsInner.new(
+  image_url: null,
+  link_url: null,
+  headline: null,
+  description: null,
+  call_to_action: null
+)
+```
+

data/docs/{CreateCtwaAdRequest.md → CtwaAdRequestBody.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequest
+# Zernio::CtwaAdRequestBody
 
 ## Properties
 
@@ -10,25 +10,25 @@
 | **headline** | **String** | Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
 | **body** | **String** | Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
 | **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** | [**CreateCtwaAdRequestVideo**](CreateCtwaAdRequestVideo.md) |  | [optional] |
-| **creatives** | [**Array<CreateCtwaAdRequestCreativesInner>**](CreateCtwaAdRequestCreativesInner.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] |
+| **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** |  |  |
 | **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] |
-| **cities** | [**Array<CreateCtwaAdRequestCitiesInner>**](CreateCtwaAdRequestCitiesInner.md) | City-level geo targeting for local CTWA campaigns (e.g. 25km radius around Milan). Each entry maps to Meta's TargetingGeoLocationCity. `key` is Meta's city ID (lookupable via GET /v1/ads/targeting/search). `radius` and `distance_unit` are coupled: set both or neither. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).  | [optional] |
-| **regions** | [**Array<CreateCtwaAdRequestRegionsInner>**](CreateCtwaAdRequestRegionsInner.md) | Region / state-level geo targeting. `key` is Meta's region ID (lookupable via GET /v1/ads/targeting/search?type=region).  | [optional] |
-| **zips** | [**Array<CreateCtwaAdRequestZipsInner>**](CreateCtwaAdRequestZipsInner.md) | ZIP / postal-code geo targeting. `key` is the platform's postal id resolved via /v1/ads/targeting/search.  | [optional] |
-| **metros** | [**Array<CreateCtwaAdRequestZipsInner>**](CreateCtwaAdRequestZipsInner.md) | DMA / metro-area geo targeting. `key` is Meta's metro id (e.g. `DMA:807`).  | [optional] |
+| **cities** | [**Array<CtwaAdRequestBodyCitiesInner>**](CtwaAdRequestBodyCitiesInner.md) | City-level geo targeting for local CTWA campaigns. Each entry maps to Meta's TargetingGeoLocationCity. `key` is Meta's city ID. `radius` and `distance_unit` are coupled: set both or neither. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).  | [optional] |
+| **regions** | [**Array<CtwaAdRequestBodyRegionsInner>**](CtwaAdRequestBodyRegionsInner.md) | Region / state-level geo targeting. `key` is Meta's region ID (lookupable via GET /v1/ads/targeting/search?type=region).  | [optional] |
+| **zips** | [**Array<CtwaAdRequestBodyZipsInner>**](CtwaAdRequestBodyZipsInner.md) | ZIP / postal-code geo targeting. `key` is the platform's postal id resolved via /v1/ads/targeting/search.  | [optional] |
+| **metros** | [**Array<CtwaAdRequestBodyZipsInner>**](CtwaAdRequestBodyZipsInner.md) | DMA / metro-area geo targeting. `key` is Meta's metro id (e.g. `DMA:807`).  | [optional] |
 | **custom_locations** | [**Array<CreateStandaloneAdRequestCustomLocationsInner>**](CreateStandaloneAdRequestCustomLocationsInner.md) | Point-radius geo (Meta `geo_locations.custom_locations`). Use for targeting a radius around a specific lat/long when no Meta city/region key fits. `distanceUnit` is required.  | [optional] |
 | **age_min** | **Integer** |  | [optional] |
 | **age_max** | **Integer** |  | [optional] |
 | **interests** | [**Array<CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID to target. | [optional] |
-| **placements** | [**CreateCtwaAdRequestPlacements**](CreateCtwaAdRequestPlacements.md) |  | [optional] |
+| **placements** | [**CtwaAdRequestBodyPlacements**](CtwaAdRequestBodyPlacements.md) |  | [optional] |
 | **advantage_audience** | **Integer** | Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it).  | [optional] |
-| **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT` (the broadly-supported CTWA objective). `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
+| **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
 | **bid_strategy** | **String** | Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent.  | [optional] |
 | **bid_amount** | **Float** | Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise.  | [optional] |
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
@@ -40,7 +40,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequest.new(
+instance = Zernio::CtwaAdRequestBody.new(
   account_id: null,
   ad_account_id: null,
   name: null,

data/docs/{CreateCtwaAdRequestCitiesInner.md → CtwaAdRequestBodyCitiesInner.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestCitiesInner
+# Zernio::CtwaAdRequestBodyCitiesInner
 
 ## Properties
 
@@ -13,7 +13,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestCitiesInner.new(
+instance = Zernio::CtwaAdRequestBodyCitiesInner.new(
   key: null,
   radius: null,
   distance_unit: null

data/docs/{CreateCtwaAdRequestCreativesInner.md → CtwaAdRequestBodyCreativesInner.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestCreativesInner
+# Zernio::CtwaAdRequestBodyCreativesInner
 
 ## Properties
 
@@ -7,14 +7,14 @@
 | **headline** | **String** |  |  |
 | **body** | **String** | Primary text shown above the image / video. |  |
 | **image_url** | **String** | Image asset. Mutually exclusive with this entry's `video`. Required if `video` is not supplied.  | [optional] |
-| **video** | [**CreateCtwaAdRequestCreativesInnerVideo**](CreateCtwaAdRequestCreativesInnerVideo.md) |  | [optional] |
+| **video** | [**CtwaAdRequestBodyCreativesInnerVideo**](CtwaAdRequestBodyCreativesInnerVideo.md) |  | [optional] |
 
 ## Example
 
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestCreativesInner.new(
+instance = Zernio::CtwaAdRequestBodyCreativesInner.new(
   headline: null,
   body: null,
   image_url: null,

data/docs/{CreateCtwaAdRequestCreativesInnerVideo.md → CtwaAdRequestBodyCreativesInnerVideo.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestCreativesInnerVideo
+# Zernio::CtwaAdRequestBodyCreativesInnerVideo
 
 ## Properties
 
@@ -12,7 +12,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestCreativesInnerVideo.new(
+instance = Zernio::CtwaAdRequestBodyCreativesInnerVideo.new(
   url: null,
   thumbnail_url: null
 )

data/docs/{CreateCtwaAdRequestPlacements.md → CtwaAdRequestBodyPlacements.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestPlacements
+# Zernio::CtwaAdRequestBodyPlacements
 
 ## Properties
 
@@ -18,7 +18,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestPlacements.new(
+instance = Zernio::CtwaAdRequestBodyPlacements.new(
   publisher_platforms: null,
   facebook_positions: null,
   instagram_positions: null,

data/docs/{CreateCtwaAdRequestRegionsInner.md → CtwaAdRequestBodyRegionsInner.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestRegionsInner
+# Zernio::CtwaAdRequestBodyRegionsInner
 
 ## Properties
 
@@ -11,7 +11,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestRegionsInner.new(
+instance = Zernio::CtwaAdRequestBodyRegionsInner.new(
   key: null
 )
 ```

data/docs/{CreateCtwaAdRequestVideo.md → CtwaAdRequestBodyVideo.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestVideo
+# Zernio::CtwaAdRequestBodyVideo
 
 ## Properties
 
@@ -12,7 +12,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestVideo.new(
+instance = Zernio::CtwaAdRequestBodyVideo.new(
   url: null,
   thumbnail_url: null
 )

data/docs/{CreateCtwaAdRequestZipsInner.md → CtwaAdRequestBodyZipsInner.md}

@@ -1,4 +1,4 @@
-# Zernio::CreateCtwaAdRequestZipsInner
+# Zernio::CtwaAdRequestBodyZipsInner
 
 ## Properties
 
@@ -12,7 +12,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::CreateCtwaAdRequestZipsInner.new(
+instance = Zernio::CtwaAdRequestBodyZipsInner.new(
   key: null,
   name: null
 )

data/docs/GenerateAdPreviews200Response.md

@@ -0,0 +1,18 @@
+# Zernio::GenerateAdPreviews200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **previews** | [**Array<GenerateAdPreviews200ResponsePreviewsInner>**](GenerateAdPreviews200ResponsePreviewsInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GenerateAdPreviews200Response.new(
+  previews: null
+)
+```
+

data/docs/GenerateAdPreviews200ResponsePreviewsInner.md

@@ -0,0 +1,20 @@
+# Zernio::GenerateAdPreviews200ResponsePreviewsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **format** | **String** |  | [optional] |
+| **html** | **String** | Meta's <iframe> snippet; null when Meta returned no preview for the format. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GenerateAdPreviews200ResponsePreviewsInner.new(
+  format: null,
+  html: null
+)
+```
+

data/docs/GenerateAdPreviewsRequest.md

@@ -0,0 +1,26 @@
+# Zernio::GenerateAdPreviewsRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio SocialAccount id used to resolve the Meta token. |  |
+| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **formats** | **Array<String>** | Meta ad_format values, one preview per format. Defaults to [DESKTOP_FEED_STANDARD]. | [optional] |
+| **existing_creative_id** | **String** | Preview an existing ad-account creative by id. Mutually exclusive with creativeSpec. | [optional] |
+| **creative_spec** | **Hash<String, Object>** | Raw Meta creative spec forwarded verbatim to /generatepreviews. Mutually exclusive with existingCreativeId. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GenerateAdPreviewsRequest.new(
+  account_id: null,
+  ad_account_id: null,
+  formats: null,
+  existing_creative_id: null,
+  creative_spec: null
+)
+```
+

data/docs/GetAdPreviews200Response.md

@@ -0,0 +1,20 @@
+# Zernio::GetAdPreviews200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_id** | **String** |  | [optional] |
+| **previews** | [**Array<GenerateAdPreviews200ResponsePreviewsInner>**](GenerateAdPreviews200ResponsePreviewsInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdPreviews200Response.new(
+  ad_id: null,
+  previews: null
+)
+```
+