@zernio/node 0.2.134 → 0.2.136

package/dist/index.d.mts

@@ -14082,7 +14082,7 @@ type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted).
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted). TikTok-specific: `conversions` (website-conversion ad group) requires `promotedObject.pixelId` (your TikTok Pixel ID) and accepts an optional `promotedObject.customEventType` (a TikTok `optimization_event` code like `ON_WEB_ORDER`, `INITIATE_ORDER`, `ON_WEB_REGISTER`, `FORM`); to inherit a pixel + event from an existing ad group, pass `adSetId` instead. LinkedIn-specific: `engagement`, `traffic`, `awareness`, and `video_views` are supported for standalone ads (creates a Direct Sponsored Content single image or single video ad). `traffic` requires `linkUrl`; `video_views` requires the `video` field. For `lead_generation` / `conversions` on LinkedIn — or to promote an existing post — use `POST /v1/ads/boost`.
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
         /**
@@ -14095,27 +14095,27 @@ type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * 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.
+         * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
          */
         headline?: string;
         /**
-         * Google Display only. Defaults to `headline` if omitted.
+         * Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided.
          */
         longHeadline?: string;
         /**
-         * 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.
+         * 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). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
-        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
-         * Required on legacy + attach shapes. Skip for multi-creative.
+         * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`.
          */
         linkUrl?: string;
         /**
-         * 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
+         * Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627).
          */
         imageUrl?: string;
         /**
@@ -14132,17 +14132,17 @@ type CreateStandaloneAdData = {
             square?: 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.
+         * Meta (facebook, instagram) and LinkedIn. When set, creates a VIDEO ad on the legacy (or, for Meta, attach) shape. Mutually exclusive with `imageUrl`. For Meta multi-creative, set `video` per entry inside `creatives[]` instead. For LinkedIn the video is uploaded to LinkedIn under the authoring Company Page (see `organizationId`) and the campaign format is set to SINGLE_VIDEO; LinkedIn ignores `thumbnailUrl` (it auto-generates the poster frame) — supply MP4 H.264/AAC, 3s-30min, 75KB-500MB.
          */
         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'.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
              */
             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.
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
-            thumbnailUrl: string;
+            thumbnailUrl?: string;
         };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
@@ -14192,7 +14192,11 @@ type CreateStandaloneAdData = {
          */
         boardId?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided.
+         * LinkedIn only. The Company Page that authors the Direct Sponsored Content ("dark") post backing the ad — accepts a numeric organization ID or a full `urn:li:organization:N` URN. Required unless the resolved `accountId` is a connected LinkedIn Company-Page account (defaults to that page) or the LinkedIn ad account is org-owned (defaults to the account's owning organization). The authenticated member must be an ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER of this page (and the page must be associated with the ad account), or LinkedIn returns 403. Ignored by every other platform.
+         */
+        organizationId?: string;
+        /**
+         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided. (LinkedIn currently honours country-level targeting only.)
          */
         countries?: Array<(string)>;
         /**
@@ -14262,6 +14266,22 @@ type CreateStandaloneAdData = {
          * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
          */
         advantageAudience?: 0 | 1;
+        /**
+         * Meta only. Conversion attribution window for the ad set — maps 1:1 to Meta's
+         * ad-set `attribution_spec`. Only honored for conversion goals (`conversions`,
+         * `lead_generation`, `app_promotion`); ignored for awareness/traffic/engagement.
+         * Omit to use Meta's default (`7-day click` + `1-day view`). Meta enforces the
+         * valid combinations: `VIEW_THROUGH` only allows `windowDays: 1` (7d/28d view
+         * windows were removed Jan 2026); `ENGAGED_VIDEO_VIEW` only `1` and only alongside
+         * `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos
+         * surface as a Meta 400.
+         * Example: `[{ "eventType": "CLICK_THROUGH", "windowDays": 7 }, { "eventType": "VIEW_THROUGH", "windowDays": 1 }]`
+         *
+         */
+        attributionSpec?: Array<{
+            eventType: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+            windowDays: 1 | 7 | 28;
+        }>;
         /**
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
@@ -14340,27 +14360,49 @@ type CreateStandaloneAdData = {
          */
         identityType?: 'TT_USER' | 'CUSTOMIZED_USER';
         /**
-         * Meta only. Forwarded to the ad set's `promoted_object` (snake-cased).
+         * What the ad optimises against. Behaviour depends on the platform.
          *
+         * **Meta**: forwarded to the ad set's `promoted_object` (snake-cased).
          * Required for goals whose ad-set optimization_goal points at a specific
-         * event/page/app — without it Meta rejects the ad-set create with
-         * `error_subcode: 1815430` "Please select a promoted object for your ad set":
-         * - `goal: conversions` (OFFSITE_CONVERSIONS) — requires `pixelId` + `customEventType`
-         * - `goal: app_promotion` (APP_INSTALLS) — requires `applicationId` + `objectStoreUrl`
-         * - `goal: lead_generation` (LEAD_GENERATION) — `pageId` is auto-filled from the connected Page when omitted
+         * event/page/app (without it Meta rejects the ad-set create with
+         * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
+         * - `goal: conversions` (OFFSITE_CONVERSIONS): requires `pixelId` + `customEventType`
+         * - `goal: app_promotion` (APP_INSTALLS): requires `applicationId` + `objectStoreUrl`
+         * - `goal: lead_generation` (LEAD_GENERATION): `pageId` is auto-filled from the connected Page when omitted
+         *
+         * Other Meta goals (engagement, traffic, awareness, video_views) ignore this field.
+         *
+         * **TikTok**: only `goal: conversions` uses it.
+         * - `pixelId` maps to the ad group's `pixel_id`. Required: a TikTok website-conversion
+         * ad group without a pixel is rejected with `40002: Please select a pixel`.
+         * - `customEventType` maps to the ad group's `optimization_event` (the pixel event to
+         * optimise for). Optional: TikTok accepts a pixel-only auto-bid conversion ad group.
+         * See the `customEventType` field below for the valid TikTok codes.
          *
-         * Other goals (engagement, traffic, awareness, video_views) ignore this field.
+         * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
+         * Meta and TikTok ignore `promotedObject` entirely.
          *
          */
         promotedObject?: {
             /**
-             * Facebook Pixel ID. Required for `goal: conversions`.
+             * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
+             * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             *
              */
             pixelId?: string;
             /**
-             * Standard event the campaign optimises against, e.g. `PURCHASE`, `LEAD`,
-             * `COMPLETE_REGISTRATION`, `ADD_TO_CART`. Uppercased internally so callers
-             * can pass any case. Required for `goal: conversions`.
+             * The event the campaign/ad group optimises against.
+             *
+             * **Meta:** standard event like `PURCHASE`, `LEAD`, `COMPLETE_REGISTRATION`,
+             * `ADD_TO_CART`. Uppercased internally so callers can pass any case. Required
+             * for `goal: conversions`.
+             *
+             * **TikTok:** an `optimization_event` code (UPPER_SNAKE, not Meta's vocabulary
+             * and not PascalCase), e.g. `ON_WEB_ORDER` (Complete Payment), `INITIATE_ORDER`
+             * (Place an Order), `ON_WEB_CART` (Add to Cart), `ON_WEB_REGISTER` (Complete
+             * Registration), `FORM` (Submit Form), `ON_WEB_DETAIL` (View Content). Must be
+             * one of the events your TikTok Pixel is configured to track; passed through
+             * verbatim and validated by TikTok. Optional for `goal: conversions`.
              *
              */
             customEventType?: string;

package/dist/index.d.ts

@@ -14082,7 +14082,7 @@ type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted).
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted). TikTok-specific: `conversions` (website-conversion ad group) requires `promotedObject.pixelId` (your TikTok Pixel ID) and accepts an optional `promotedObject.customEventType` (a TikTok `optimization_event` code like `ON_WEB_ORDER`, `INITIATE_ORDER`, `ON_WEB_REGISTER`, `FORM`); to inherit a pixel + event from an existing ad group, pass `adSetId` instead. LinkedIn-specific: `engagement`, `traffic`, `awareness`, and `video_views` are supported for standalone ads (creates a Direct Sponsored Content single image or single video ad). `traffic` requires `linkUrl`; `video_views` requires the `video` field. For `lead_generation` / `conversions` on LinkedIn — or to promote an existing post — use `POST /v1/ads/boost`.
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
         /**
@@ -14095,27 +14095,27 @@ type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * 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.
+         * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
          */
         headline?: string;
         /**
-         * Google Display only. Defaults to `headline` if omitted.
+         * Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided.
          */
         longHeadline?: string;
         /**
-         * 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.
+         * 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). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
-        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
-         * Required on legacy + attach shapes. Skip for multi-creative.
+         * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`.
          */
         linkUrl?: string;
         /**
-         * 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
+         * Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627).
          */
         imageUrl?: string;
         /**
@@ -14132,17 +14132,17 @@ type CreateStandaloneAdData = {
             square?: 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.
+         * Meta (facebook, instagram) and LinkedIn. When set, creates a VIDEO ad on the legacy (or, for Meta, attach) shape. Mutually exclusive with `imageUrl`. For Meta multi-creative, set `video` per entry inside `creatives[]` instead. For LinkedIn the video is uploaded to LinkedIn under the authoring Company Page (see `organizationId`) and the campaign format is set to SINGLE_VIDEO; LinkedIn ignores `thumbnailUrl` (it auto-generates the poster frame) — supply MP4 H.264/AAC, 3s-30min, 75KB-500MB.
          */
         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'.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
              */
             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.
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
-            thumbnailUrl: string;
+            thumbnailUrl?: string;
         };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
@@ -14192,7 +14192,11 @@ type CreateStandaloneAdData = {
          */
         boardId?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided.
+         * LinkedIn only. The Company Page that authors the Direct Sponsored Content ("dark") post backing the ad — accepts a numeric organization ID or a full `urn:li:organization:N` URN. Required unless the resolved `accountId` is a connected LinkedIn Company-Page account (defaults to that page) or the LinkedIn ad account is org-owned (defaults to the account's owning organization). The authenticated member must be an ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER of this page (and the page must be associated with the ad account), or LinkedIn returns 403. Ignored by every other platform.
+         */
+        organizationId?: string;
+        /**
+         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided. (LinkedIn currently honours country-level targeting only.)
          */
         countries?: Array<(string)>;
         /**
@@ -14262,6 +14266,22 @@ type CreateStandaloneAdData = {
          * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
          */
         advantageAudience?: 0 | 1;
+        /**
+         * Meta only. Conversion attribution window for the ad set — maps 1:1 to Meta's
+         * ad-set `attribution_spec`. Only honored for conversion goals (`conversions`,
+         * `lead_generation`, `app_promotion`); ignored for awareness/traffic/engagement.
+         * Omit to use Meta's default (`7-day click` + `1-day view`). Meta enforces the
+         * valid combinations: `VIEW_THROUGH` only allows `windowDays: 1` (7d/28d view
+         * windows were removed Jan 2026); `ENGAGED_VIDEO_VIEW` only `1` and only alongside
+         * `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos
+         * surface as a Meta 400.
+         * Example: `[{ "eventType": "CLICK_THROUGH", "windowDays": 7 }, { "eventType": "VIEW_THROUGH", "windowDays": 1 }]`
+         *
+         */
+        attributionSpec?: Array<{
+            eventType: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+            windowDays: 1 | 7 | 28;
+        }>;
         /**
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
@@ -14340,27 +14360,49 @@ type CreateStandaloneAdData = {
          */
         identityType?: 'TT_USER' | 'CUSTOMIZED_USER';
         /**
-         * Meta only. Forwarded to the ad set's `promoted_object` (snake-cased).
+         * What the ad optimises against. Behaviour depends on the platform.
          *
+         * **Meta**: forwarded to the ad set's `promoted_object` (snake-cased).
          * Required for goals whose ad-set optimization_goal points at a specific
-         * event/page/app — without it Meta rejects the ad-set create with
-         * `error_subcode: 1815430` "Please select a promoted object for your ad set":
-         * - `goal: conversions` (OFFSITE_CONVERSIONS) — requires `pixelId` + `customEventType`
-         * - `goal: app_promotion` (APP_INSTALLS) — requires `applicationId` + `objectStoreUrl`
-         * - `goal: lead_generation` (LEAD_GENERATION) — `pageId` is auto-filled from the connected Page when omitted
+         * event/page/app (without it Meta rejects the ad-set create with
+         * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
+         * - `goal: conversions` (OFFSITE_CONVERSIONS): requires `pixelId` + `customEventType`
+         * - `goal: app_promotion` (APP_INSTALLS): requires `applicationId` + `objectStoreUrl`
+         * - `goal: lead_generation` (LEAD_GENERATION): `pageId` is auto-filled from the connected Page when omitted
+         *
+         * Other Meta goals (engagement, traffic, awareness, video_views) ignore this field.
+         *
+         * **TikTok**: only `goal: conversions` uses it.
+         * - `pixelId` maps to the ad group's `pixel_id`. Required: a TikTok website-conversion
+         * ad group without a pixel is rejected with `40002: Please select a pixel`.
+         * - `customEventType` maps to the ad group's `optimization_event` (the pixel event to
+         * optimise for). Optional: TikTok accepts a pixel-only auto-bid conversion ad group.
+         * See the `customEventType` field below for the valid TikTok codes.
          *
-         * Other goals (engagement, traffic, awareness, video_views) ignore this field.
+         * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
+         * Meta and TikTok ignore `promotedObject` entirely.
          *
          */
         promotedObject?: {
             /**
-             * Facebook Pixel ID. Required for `goal: conversions`.
+             * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
+             * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             *
              */
             pixelId?: string;
             /**
-             * Standard event the campaign optimises against, e.g. `PURCHASE`, `LEAD`,
-             * `COMPLETE_REGISTRATION`, `ADD_TO_CART`. Uppercased internally so callers
-             * can pass any case. Required for `goal: conversions`.
+             * The event the campaign/ad group optimises against.
+             *
+             * **Meta:** standard event like `PURCHASE`, `LEAD`, `COMPLETE_REGISTRATION`,
+             * `ADD_TO_CART`. Uppercased internally so callers can pass any case. Required
+             * for `goal: conversions`.
+             *
+             * **TikTok:** an `optimization_event` code (UPPER_SNAKE, not Meta's vocabulary
+             * and not PascalCase), e.g. `ON_WEB_ORDER` (Complete Payment), `INITIATE_ORDER`
+             * (Place an Order), `ON_WEB_CART` (Add to Cart), `ON_WEB_REGISTER` (Complete
+             * Registration), `FORM` (Submit Form), `ON_WEB_DETAIL` (View Content). Must be
+             * one of the events your TikTok Pixel is configured to track; passed through
+             * verbatim and validated by TikTok. Optional for `goal: conversions`.
              *
              */
             customEventType?: string;

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3561,7 +3561,7 @@ export const boostPost = <ThrowOnError extends boolean = false>(options: Options
 
 /**
  * Create standalone ad
- * Creates a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, and X/Twitter. Supports three mutually-exclusive request shapes selected by the body, a legacy single-creative shape (all platforms, default), a Meta-only multi-creative shape via the creatives array (one ad set with N ads sharing budget and targeting), and a Meta-only attach shape via adSetId (adds one new ad to an existing ad set). Per-platform required fields, budget minimums, and video-ad rules (Meta only) are documented on each property below.
+ * Creates a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X/Twitter, and LinkedIn. Supports three mutually-exclusive request shapes selected by the body, a legacy single-creative shape (all platforms, default), a Meta-only multi-creative shape via the creatives array (one ad set with N ads sharing budget and targeting), and a Meta-only attach shape via adSetId (adds one new ad to an existing ad set). Per-platform required fields, budget minimums, and video-ad rules are documented on each property below. LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content "dark post" authored by a Company Page (see `organizationId`); supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.
  */
 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

@@ -14413,7 +14413,7 @@ export type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted).
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform. Meta-specific: `conversions` requires `promotedObject.pixelId` + `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` + `promotedObject.objectStoreUrl`; `lead_generation` accepts an optional `promotedObject.pageId` (auto-filled from the connected Page when omitted). TikTok-specific: `conversions` (website-conversion ad group) requires `promotedObject.pixelId` (your TikTok Pixel ID) and accepts an optional `promotedObject.customEventType` (a TikTok `optimization_event` code like `ON_WEB_ORDER`, `INITIATE_ORDER`, `ON_WEB_REGISTER`, `FORM`); to inherit a pixel + event from an existing ad group, pass `adSetId` instead. LinkedIn-specific: `engagement`, `traffic`, `awareness`, and `video_views` are supported for standalone ads (creates a Direct Sponsored Content single image or single video ad). `traffic` requires `linkUrl`; `video_views` requires the `video` field. For `lead_generation` / `conversions` on LinkedIn — or to promote an existing post — use `POST /v1/ads/boost`.
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
         /**
@@ -14426,27 +14426,27 @@ export type CreateStandaloneAdData = {
         budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * 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.
+         * Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title.
          */
         headline?: string;
         /**
-         * Google Display only. Defaults to `headline` if omitted.
+         * Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided.
          */
         longHeadline?: string;
         /**
-         * 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.
+         * 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). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
-        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
-         * Required on legacy + attach shapes. Skip for multi-creative.
+         * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`.
          */
         linkUrl?: string;
         /**
-         * 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
+         * Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. 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. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627).
          */
         imageUrl?: string;
         /**
@@ -14463,17 +14463,17 @@ export type CreateStandaloneAdData = {
             square?: 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.
+         * Meta (facebook, instagram) and LinkedIn. When set, creates a VIDEO ad on the legacy (or, for Meta, attach) shape. Mutually exclusive with `imageUrl`. For Meta multi-creative, set `video` per entry inside `creatives[]` instead. For LinkedIn the video is uploaded to LinkedIn under the authoring Company Page (see `organizationId`) and the campaign format is set to SINGLE_VIDEO; LinkedIn ignores `thumbnailUrl` (it auto-generates the poster frame) — supply MP4 H.264/AAC, 3s-30min, 75KB-500MB.
          */
         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'.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
              */
             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.
+             * Public URL of a still-image thumbnail for the video. Required by Meta on every video creative (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
-            thumbnailUrl: string;
+            thumbnailUrl?: string;
         };
         /**
          * Meta-only. When present, switches to the multi-creative shape:
@@ -14523,7 +14523,11 @@ export type CreateStandaloneAdData = {
          */
         boardId?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided.
+         * LinkedIn only. The Company Page that authors the Direct Sponsored Content ("dark") post backing the ad — accepts a numeric organization ID or a full `urn:li:organization:N` URN. Required unless the resolved `accountId` is a connected LinkedIn Company-Page account (defaults to that page) or the LinkedIn ad account is org-owned (defaults to the account's owning organization). The authenticated member must be an ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER of this page (and the page must be associated with the ad account), or LinkedIn returns 403. Ignored by every other platform.
+         */
+        organizationId?: string;
+        /**
+         * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no `cities` or `regions` are provided. (LinkedIn currently honours country-level targeting only.)
          */
         countries?: Array<(string)>;
         /**
@@ -14593,6 +14597,22 @@ export type CreateStandaloneAdData = {
          * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
          */
         advantageAudience?: 0 | 1;
+        /**
+         * Meta only. Conversion attribution window for the ad set — maps 1:1 to Meta's
+         * ad-set `attribution_spec`. Only honored for conversion goals (`conversions`,
+         * `lead_generation`, `app_promotion`); ignored for awareness/traffic/engagement.
+         * Omit to use Meta's default (`7-day click` + `1-day view`). Meta enforces the
+         * valid combinations: `VIEW_THROUGH` only allows `windowDays: 1` (7d/28d view
+         * windows were removed Jan 2026); `ENGAGED_VIDEO_VIEW` only `1` and only alongside
+         * `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos
+         * surface as a Meta 400.
+         * Example: `[{ "eventType": "CLICK_THROUGH", "windowDays": 7 }, { "eventType": "VIEW_THROUGH", "windowDays": 1 }]`
+         *
+         */
+        attributionSpec?: Array<{
+            eventType: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+            windowDays: 1 | 7 | 28;
+        }>;
         /**
          * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
          */
@@ -14671,27 +14691,49 @@ export type CreateStandaloneAdData = {
          */
         identityType?: 'TT_USER' | 'CUSTOMIZED_USER';
         /**
-         * Meta only. Forwarded to the ad set's `promoted_object` (snake-cased).
+         * What the ad optimises against. Behaviour depends on the platform.
          *
+         * **Meta**: forwarded to the ad set's `promoted_object` (snake-cased).
          * Required for goals whose ad-set optimization_goal points at a specific
-         * event/page/app — without it Meta rejects the ad-set create with
-         * `error_subcode: 1815430` "Please select a promoted object for your ad set":
-         * - `goal: conversions` (OFFSITE_CONVERSIONS) — requires `pixelId` + `customEventType`
-         * - `goal: app_promotion` (APP_INSTALLS) — requires `applicationId` + `objectStoreUrl`
-         * - `goal: lead_generation` (LEAD_GENERATION) — `pageId` is auto-filled from the connected Page when omitted
+         * event/page/app (without it Meta rejects the ad-set create with
+         * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
+         * - `goal: conversions` (OFFSITE_CONVERSIONS): requires `pixelId` + `customEventType`
+         * - `goal: app_promotion` (APP_INSTALLS): requires `applicationId` + `objectStoreUrl`
+         * - `goal: lead_generation` (LEAD_GENERATION): `pageId` is auto-filled from the connected Page when omitted
+         *
+         * Other Meta goals (engagement, traffic, awareness, video_views) ignore this field.
+         *
+         * **TikTok**: only `goal: conversions` uses it.
+         * - `pixelId` maps to the ad group's `pixel_id`. Required: a TikTok website-conversion
+         * ad group without a pixel is rejected with `40002: Please select a pixel`.
+         * - `customEventType` maps to the ad group's `optimization_event` (the pixel event to
+         * optimise for). Optional: TikTok accepts a pixel-only auto-bid conversion ad group.
+         * See the `customEventType` field below for the valid TikTok codes.
          *
-         * Other goals (engagement, traffic, awareness, video_views) ignore this field.
+         * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
+         * Meta and TikTok ignore `promotedObject` entirely.
          *
          */
         promotedObject?: {
             /**
-             * Facebook Pixel ID. Required for `goal: conversions`.
+             * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
+             * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             *
              */
             pixelId?: string;
             /**
-             * Standard event the campaign optimises against, e.g. `PURCHASE`, `LEAD`,
-             * `COMPLETE_REGISTRATION`, `ADD_TO_CART`. Uppercased internally so callers
-             * can pass any case. Required for `goal: conversions`.
+             * The event the campaign/ad group optimises against.
+             *
+             * **Meta:** standard event like `PURCHASE`, `LEAD`, `COMPLETE_REGISTRATION`,
+             * `ADD_TO_CART`. Uppercased internally so callers can pass any case. Required
+             * for `goal: conversions`.
+             *
+             * **TikTok:** an `optimization_event` code (UPPER_SNAKE, not Meta's vocabulary
+             * and not PascalCase), e.g. `ON_WEB_ORDER` (Complete Payment), `INITIATE_ORDER`
+             * (Place an Order), `ON_WEB_CART` (Add to Cart), `ON_WEB_REGISTER` (Complete
+             * Registration), `FORM` (Submit Form), `ON_WEB_DETAIL` (View Content). Must be
+             * one of the events your TikTok Pixel is configured to track; passed through
+             * verbatim and validated by TikTok. Optional for `goal: conversions`.
              *
              */
             customEventType?: string;