@zernio/node 0.2.81 → 0.2.82

package/dist/index.d.mts

@@ -12179,15 +12179,15 @@ type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
+         * Required for Meta, Google, and Pinterest on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100.
          */
         headline?: string;
         /**
-         * Google Display only
+         * Google Display only. Defaults to `headline` if omitted.
          */
         longHeadline?: string;
         /**
-         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
@@ -12199,9 +12199,22 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Required on legacy + attach shapes. Not required for Google Search campaigns.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
          */
         imageUrl?: string;
+        /**
+         * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
+         */
+        video?: {
+            /**
+             * Public URL of the video. Uploaded to Meta via chunked transfer on /act_X/advideos; then the request blocks on Meta's transcoding until status.video_status === 'ready'.
+             */
+            url: string;
+            /**
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative. Uploaded to Meta as an ad image and referenced as the thumbnail in object_story_spec.video_data.
+             */
+            thumbnailUrl: string;
+        };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
          * creates 1 campaign + 1 ad set + N ads (one per entry here).
@@ -12212,7 +12225,17 @@ type CreateStandaloneAdData = {
         creatives?: Array<{
             headline: string;
             body: string;
-            imageUrl: string;
+            /**
+             * Image creative. Mutually exclusive with `video`.
+             */
+            imageUrl?: string;
+            /**
+             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             */
+            video?: {
+                url: string;
+                thumbnailUrl: string;
+            };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         }>;

package/dist/index.d.ts

@@ -12179,15 +12179,15 @@ type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
+         * Required for Meta, Google, and Pinterest on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100.
          */
         headline?: string;
         /**
-         * Google Display only
+         * Google Display only. Defaults to `headline` if omitted.
          */
         longHeadline?: string;
         /**
-         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
@@ -12199,9 +12199,22 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Required on legacy + attach shapes. Not required for Google Search campaigns.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
          */
         imageUrl?: string;
+        /**
+         * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
+         */
+        video?: {
+            /**
+             * Public URL of the video. Uploaded to Meta via chunked transfer on /act_X/advideos; then the request blocks on Meta's transcoding until status.video_status === 'ready'.
+             */
+            url: string;
+            /**
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative. Uploaded to Meta as an ad image and referenced as the thumbnail in object_story_spec.video_data.
+             */
+            thumbnailUrl: string;
+        };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
          * creates 1 campaign + 1 ad set + N ads (one per entry here).
@@ -12212,7 +12225,17 @@ type CreateStandaloneAdData = {
         creatives?: Array<{
             headline: string;
             body: string;
-            imageUrl: string;
+            /**
+             * Image creative. Mutually exclusive with `video`.
+             */
+            imageUrl?: string;
+            /**
+             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             */
+            video?: {
+                url: string;
+                thumbnailUrl: string;
+            };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.81",
+  "version": "0.2.82",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -3188,6 +3188,18 @@ export const boostPost = <ThrowOnError extends boolean = false>(options: Options
  *
  * `creatives[]` and `adSetId` are mutually exclusive; specifying both returns 400.
  *
+ * **Per-platform required fields** (the platform is inferred from `accountId`):
+ * - **Meta (facebook, instagram)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `imageUrl`, `linkUrl`, `callToAction`.
+ * - **Google Ads (Display)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `linkUrl`, `imageUrl`, `businessName`. `longHeadline` defaults to `headline` if omitted (max 90 chars).
+ * - **Google Ads (Search)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `linkUrl`, `businessName`. `imageUrl` is NOT required for Search. Set `campaignType: "search"`.
+ * - **TikTok**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `body`, `linkUrl`, `imageUrl` (this field **carries the VIDEO URL** for TikTok; the TikTok ads endpoint is video-only and the field is named `imageUrl` for cross-platform consistency).
+ * - **Pinterest**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `imageUrl`, `linkUrl`. Optional `boardId` (auto-creates "Zernio Ads" board if omitted).
+ * - **X / Twitter**: `accountId` (the posting account, internally resolved to the linked X Ads credential), `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `body` (the tweet text, max 280 chars with `linkUrl` adding ~24). `headline`, `imageUrl`, `callToAction`, and targeting fields are ignored. Requires a connected X Ads account (`/v1/connect/twitter/ads`); otherwise 422.
+ *
+ * **Budget minimums** are enforced per platform in USD: TikTok=$20, Pinterest=$5, all others=$1. If you pass `currency` other than USD, this minimum is currently still evaluated as USD. Pass the ad account's native currency on every request so Meta-side amount conversion is correct.
+ *
+ * **Video ads (Meta only).** Meta (facebook, instagram) supports video creatives on all three shapes (legacy, multi-creative via `creatives[].video`, attach). Set `video: { url, thumbnailUrl }` at the request root (for legacy/attach) or per-entry inside `creatives[]` (for multi-creative). `video` and `imageUrl` are mutually exclusive per creative; supply exactly one. `video.thumbnailUrl` is required because Meta requires a thumbnail on every video creative. The video is uploaded to Meta via chunked transfer and the request blocks on Meta's transcoding (`status.video_status === 'ready'`). This path can take several minutes for longer videos; this endpoint is configured with `maxDuration = 800` on Vercel (13 min) to cover it, but your HTTP client should allow for the same. If transcoding hasn't finished within 10 minutes, the request fails with a `platform_error`. Video on non-Meta platforms is NOT supported here: TikTok uses its own flow (pass the video URL via `imageUrl`); other platforms are image-only.
+ *
  */
 export const createStandaloneAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateStandaloneAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateStandaloneAdResponse, CreateStandaloneAdError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -12489,15 +12489,15 @@ export type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
+         * Required for Meta, Google, and Pinterest on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100.
          */
         headline?: string;
         /**
-         * Google Display only
+         * Google Display only. Defaults to `headline` if omitted.
          */
         longHeadline?: string;
         /**
-         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
@@ -12509,9 +12509,22 @@ export type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Required on legacy + attach shapes. Not required for Google Search campaigns.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
          */
         imageUrl?: string;
+        /**
+         * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
+         */
+        video?: {
+            /**
+             * Public URL of the video. Uploaded to Meta via chunked transfer on /act_X/advideos; then the request blocks on Meta's transcoding until status.video_status === 'ready'.
+             */
+            url: string;
+            /**
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative. Uploaded to Meta as an ad image and referenced as the thumbnail in object_story_spec.video_data.
+             */
+            thumbnailUrl: string;
+        };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
          * creates 1 campaign + 1 ad set + N ads (one per entry here).
@@ -12522,7 +12535,17 @@ export type CreateStandaloneAdData = {
         creatives?: Array<{
             headline: string;
             body: string;
-            imageUrl: string;
+            /**
+             * Image creative. Mutually exclusive with `video`.
+             */
+            imageUrl?: string;
+            /**
+             * Video creative for this entry. Mutually exclusive with `imageUrl`.
+             */
+            video?: {
+                url: string;
+                thumbnailUrl: string;
+            };
             linkUrl: string;
             callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         }>;