late-sdk 0.0.817 → 0.0.819

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d29b0cbbf50db66d905333a2e8fab599ca23fecd7969776b71fb4d807438b96f
-  data.tar.gz: 438af5ae30990214dd632d4755009c50bc48515c6a9dbb67ded13fbfc378d0f0
+  metadata.gz: 48642ee1a05e3aba045bae3b8576d01c44f9634ce367147070d3a0a52ea7659e
+  data.tar.gz: 5a8367a4fc6adbb050901860aab845ac2de7c0502df4b2ab32cc87e14244d9ec
 SHA512:
-  metadata.gz: 0bb4b19f6b93a0ba4bdb64c50fa4b1dc5492abb6b34053eb8bd84a15ec1645ded030723a811d066825d7f01213bbbabc8909c29040f586770235d4e69055c71c
-  data.tar.gz: c51f482669a348335381d23a6a1d995359a208959bd0e35c978936201fa22cf6d3492ed771869cacce6b2c409e512e98c9e47a530ed2716756668d0a6e7bdda6
+  metadata.gz: 5092c3e4bebde157d4d8277d2614b9b194a7b858eebdef066217e2e65f79bc9746809753c0e0cd0857dced691e86447c8a2471a5445aa320f62b0e6aa75c006f
+  data.tar.gz: 5227df00afbc3c6e75fada2691b0b7783fcba69eeff894064dcd38e3f1eb15f6162717858ec2c2a8807e2994545c033621f15d6daf35143e30308b9299d86beb

data/docs/AdCampaignsApi.md

@@ -249,7 +249,7 @@ end
 
 Create a standalone campaign
 
-Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
 
 ### Examples
 

data/docs/CreateAdCampaignRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** |  |  |
 | **goal** | **String** | Mapped to the ODAX objective (same mapping as POST /v1/ads/create). |  |
 | **special_ad_categories** | **Array<String>** |  | [optional] |

data/docs/CreateAdCreativeRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **headline** | **String** |  |  |
 | **body** | **String** | Primary text |  |
 | **description** | **String** | Link description below the headline; omitted = Meta scrapes the destination's OG description. | [optional] |

data/docs/CreateCustomConversionRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** | Also the reuse key, together with pixelId. |  |
 | **pixel_id** | **String** | Meta pixel id (event_source_id). From GET /v1/accounts/{accountId}/tracking-tags. |  |
 | **custom_event_type** | **String** | Meta custom_event_type, e.g. LEAD, PURCHASE, OTHER. |  |

data/docs/CreateRfPredictionRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id (posting or ads variant). |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **budget_amount** | **Float** | Whole currency units. Exactly one of budgetAmount / reach. | [optional] |
 | **reach** | **Integer** | Target unique reach. Exactly one of budgetAmount / reach. | [optional] |
 | **start_date** | **Time** | Campaign window start (must be in the future). |  |

data/docs/CreateValueRuleSetRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** |  |  |
 | **rules** | [**Array<ValueRule>**](ValueRule.md) | Evaluated in order; the first matching rule wins. |  |
 

data/docs/GenerateAdPreviewsRequest.md

@@ -5,7 +5,7 @@
 | 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>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **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] |

data/docs/UpdateAdCreativeRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
 | **name** | **String** |  |  |
 
 ## Example

data/docs/UpdateValueRuleSetRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
 | **name** | **String** | Required: the update replaces the whole set. |  |
 | **rules** | [**Array<ValueRule>**](ValueRule.md) | The COMPLETE rule list. Omitting a rule deletes it on Meta. |  |
 

data/docs/UploadAdImageRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **image_base64** | **String** | Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped). |  |
 | **filename** | **String** | Optional filename shown in Meta's image library. Defaults to ad_image.jpg. | [optional] |
 

data/docs/UploadAdVideoRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **video_url** | **String** | Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64. | [optional] |
 | **video_base64** | **String** | Raw base64 video bytes, or a full data URL (the data:video/...;base64, prefix is stripped). Capped by Vercel's body limit (~4.5 MB payload). Provide exactly one of videoUrl or videoBase64. | [optional] |
 | **filename** | **String** | Optional filename shown alongside the upload session. Applied only when uploading via videoBase64. | [optional] |

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

@@ -237,7 +237,7 @@ module Zernio
     end
 
     # Create a standalone campaign
-    # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_campaign_request [CreateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
@@ -248,7 +248,7 @@ module Zernio
     end
 
     # Create a standalone campaign
-    # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_campaign_request [CreateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class CreateAdCampaignRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :name

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :headline

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class CreateCustomConversionRequest < ApiModelBase
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Also the reuse key, together with pixelId.

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id (posting or ads variant).
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Whole currency units. Exactly one of budgetAmount / reach.

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class CreateValueRuleSetRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :name

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id used to resolve the Meta token.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Meta ad_format values, one preview per format. Defaults to [DESKTOP_FEED_STANDARD].

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class UpdateAdCreativeRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
     attr_accessor :name

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class UpdateValueRuleSetRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
     # Required: the update replaces the whole set.

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class UploadAdImageRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped).

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class UploadAdVideoRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64.

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -40605,14 +40605,19 @@ paths:
       x-resource-group: "ads"
       operationId: createAdCampaign
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "google", "linkedin", "tiktok", "x", "pinterest", "openai"]
       summary: Create a standalone campaign
       description: |-
-        Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it
-        later via `existingCampaignId` on the create endpoints. A budget here is campaign-level
-        (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
-        `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
-        next sync discovery pass.
+        Creates a campaign WITHOUT its first ad set / ad, on the platform of the given
+        `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints.
+        Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it
+        for ABO (each ad set carries its own budget), and `specialAdCategories` /
+        `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget
+        (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the
+        campaign GROUP (our campaign level) and rejects a budget, which lives on the
+        campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are
+        created without a status and report `ENABLE`. Created `PAUSED` unless
+        `status: ACTIVE` where the platform supports it.
 
         **Idempotency:** send an `Idempotency-Key` header to make retries safe.
       security:
@@ -40636,8 +40641,8 @@ paths:
               type: object
               required: [accountId, adAccountId, name, goal]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, maxLength: 255 }
                 goal:
                   type: string
@@ -40722,6 +40727,8 @@ paths:
         '400':
           description: Invalid input or campaign spans multiple social accounts
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404':
           description: No ads found for this campaign
 
@@ -40805,6 +40812,8 @@ paths:
                   platformSpecificData: { type: object }
         '400': { description: "Invalid input, or a field the resolved platform does not support at the campaign level (see the support table)" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Campaign not found }
         '409': { description: "Campaign is ABO — route to /v1/ads/ad-sets/{adSetId} instead" }
         '501': { description: Operation not supported on this platform }
@@ -40914,6 +40923,8 @@ paths:
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
   /v1/ads/campaigns/{campaignId}/duplicate:
     post:
       x-resource-group: "ads"
@@ -41008,6 +41019,8 @@ paths:
                     description: Platform-native response from the copy endpoint (Meta includes ad_object_ids for child copies)
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Source campaign not found }
         '501': { description: Operation not supported on this platform }
 
@@ -41069,6 +41082,8 @@ paths:
                   raw: { type: object, description: Meta's native copy response (includes ad_object_ids for child copies) }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Source ad set not found }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
@@ -41124,6 +41139,8 @@ paths:
                   raw: { type: object }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad not found }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
@@ -41311,6 +41328,8 @@ paths:
                   platformSpecificData: { type: object }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad set not found }
         '409': { description: "Campaign is CBO — route to /v1/ads/campaigns/{campaignId} instead" }
         '422': { description: "bidStrategy is LOWEST_COST_WITH_MIN_ROAS on OpenAI (unsupported: no ROAS-based bidding)" }
@@ -41406,6 +41425,8 @@ paths:
                   message: { type: string, description: 'Present only where the platform has no ad-set switch and no child ad was actionable' }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad set not found }
 
   /v1/ads/tree:
@@ -41692,6 +41713,8 @@ paths:
         '400':
           description: 'Invalid status transition, budget below minimum, or a LinkedIn creative update without imageUrl or videoUrl'
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { $ref: '#/components/responses/NotFound' }
         '501': { description: "targeting or creative not supported on the platform (supported on Meta, TikTok, and LinkedIn)" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -41762,6 +41785,8 @@ paths:
                   message: { type: string, description: "Human-readable summary (present only when skipped)" }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad not found }
 
   /v1/ads/campaigns/{campaignId}/assets:
@@ -41842,6 +41867,8 @@ paths:
                   structuredSnippetAssetResourceNames: { type: array, items: { type: string } }
         '400': { description: "Invalid input, Google rejected the assets, an unknown customerId (not one of this connection's Google Ads accounts), or a required customerId missing when the connection has multiple Google Ads accounts" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '422': { description: "No Google Ads customer accounts on this connection. Reconnect Google Ads." }
         '501': { description: Only supported on Google Ads }
 
@@ -41933,7 +41960,7 @@ paths:
               required: [accountId, adAccountId]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 formats:
                   type: array
                   minItems: 1
@@ -42488,6 +42515,8 @@ paths:
       responses:
         '200': { description: "Updated" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: "Ad not found" }
         '405': { description: "Platform has no click-URL tracking surface" }
         '422': { description: "Meta creative cannot be rebuilt (e.g. placement-customized/asset-feed/dark creative)" }
@@ -42698,7 +42727,7 @@ paths:
               required: [accountId, adAccountId, startDate, endDate]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant)." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 budgetAmount: { type: number, description: "Whole currency units. Exactly one of budgetAmount / reach." }
                 reach: { type: integer, description: "Target unique reach. Exactly one of budgetAmount / reach." }
                 startDate: { type: string, format: date-time, description: "Campaign window start (must be in the future)." }
@@ -43072,7 +43101,7 @@ paths:
               required: [accountId, adAccountId, headline, body, linkUrl]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 headline: { type: string, maxLength: 255 }
                 body: { type: string, description: Primary text }
                 description: { type: string, maxLength: 255, description: "Link description below the headline; omitted = Meta scrapes the destination's OG description." }
@@ -43168,7 +43197,7 @@ paths:
               type: object
               required: [accountId, name]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
                 name: { type: string, maxLength: 255 }
       responses:
         '200':
@@ -43311,8 +43340,8 @@ paths:
               type: object
               required: [accountId, adAccountId, name, rules]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, minLength: 1, maxLength: 255 }
                 rules:
                   type: array
@@ -43402,7 +43431,7 @@ paths:
               type: object
               required: [accountId, name, rules]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
                 name: { type: string, minLength: 1, maxLength: 255, description: "Required: the update replaces the whole set." }
                 rules:
                   type: array
@@ -44012,7 +44041,7 @@ paths:
           description: Missing required fields or invalid values
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+          description: 'Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '409':
           description: |
             An identical boost request is already in progress (with or without
@@ -45069,7 +45098,7 @@ paths:
           description: 'Missing required fields, invalid values, non-Meta platform used with creatives[] / adSetId, or a Meta validateOnly validation failure (verbatim)'
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+          description: 'Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '422':
           description: Platform ads connection required (TikTok Ads, X Ads) or missing linked account
         '502':
@@ -45468,8 +45497,8 @@ paths:
               type: object
               required: [accountId, adAccountId, imageBase64]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 imageBase64: { type: string, description: "Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped)." }
                 filename: { type: string, description: "Optional filename shown in Meta's image library. Defaults to ad_image.jpg." }
       responses:
@@ -45560,8 +45589,8 @@ paths:
               type: object
               required: [accountId, adAccountId]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 videoUrl: { type: string, description: "Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64." }
                 videoBase64: { type: string, description: "Raw base64 video bytes, or a full data URL (the data:video/...;base64, prefix is stripped). Capped by Vercel's body limit (~4.5 MB payload). Provide exactly one of videoUrl or videoBase64." }
                 filename: { type: string, description: "Optional filename shown alongside the upload session. Applied only when uploading via videoBase64." }
@@ -47759,6 +47788,8 @@ paths:
           description: Ad(s) created and submitted for review
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Account not found }
         '422': { description: "No Facebook Page resolved for the account" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -47799,6 +47830,8 @@ paths:
           description: Ad(s) created and submitted for review
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Account not found }
         '422': { description: "No Facebook Page resolved for the account" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -47861,7 +47894,8 @@ paths:
                     multi: '#/components/schemas/CtwaMultiResponse'
         '400': { description: Invalid body. }
         '401': { $ref: '#/components/responses/Unauthorized' }
-        '403': { description: "Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans." }
+        '403':
+          description: 'Forbidden. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: SocialAccount not found. }
         '422':
           description: Page is not connected to a verified WhatsApp number.
@@ -47929,7 +47963,7 @@ paths:
               type: object
               required: [adAccountId, name, pixelId, customEventType, rule]
               properties:
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, maxLength: 255, description: "Also the reuse key, together with pixelId." }
                 pixelId: { type: string, description: "Meta pixel id (event_source_id). From GET /v1/accounts/{accountId}/tracking-tags." }
                 customEventType: { type: string, description: "Meta custom_event_type, e.g. LEAD, PURCHASE, OTHER." }

data/spec/api/ad_campaigns_api_spec.rb

@@ -72,7 +72,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for create_ad_campaign
   # Create a standalone campaign
-  # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+  # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
   # @param create_ad_campaign_request 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.817
+  version: 0.0.819
 platform: ruby
 authors:
 - OpenAPI-Generator
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-01 00:00:00.000000000 Z
+date: 2026-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -5557,7 +5557,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.817.gem
+- zernio-sdk-0.0.819.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: