@zernio/node 0.2.675 → 0.2.677

package/dist/index.d.mts

@@ -2770,7 +2770,7 @@ type BulkUploadResult = {
         errors?: Array<(string)>;
     }>;
     /**
-     * Top-level advisory warnings (e.g. `rows_exceed_advisory_limit:500`). Empty when none.
+     * Top-level advisory warnings, e.g. `rows_exceed_advisory_limit:500` or `unknown_columns:<a,b,c>` (comma-separated unrecognized CSV column names). Empty when none.
      */
     warnings?: Array<(string)>;
     /**
@@ -5989,6 +5989,10 @@ type PostAnalytics = {
 type PostCreateResponse = {
     message?: string;
     post?: Post;
+    /**
+     * Advisory notices about a post that was still created: media truncated for a platform, a recycling caveat, or a field that was ignored because it sat outside platforms[].platformSpecificData. Absent when there are none.
+     */
+    warnings?: Array<(string)>;
 };
 type PostDeleteResponse = {
     message?: string;
@@ -30084,8 +30088,8 @@ type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
-         * Pinterest / X / LinkedIn return 501.
+         * Meta + TikTok (demographics/interests), Google (keyword edits only),
+         * and LinkedIn (geo countries). Pinterest / X return 501.
          *
          */
         targeting?: {
@@ -30119,7 +30123,7 @@ type UpdateAdData = {
             advantage_audience?: 0 | 1;
         };
         /**
-         * Replace the ad's creative. Meta + TikTok only.
+         * Replace the ad's creative. Meta, TikTok, and LinkedIn.
          *
          * - **Meta**: requires `headline`, `body`, `callToAction`, `linkUrl`, `imageUrl`. The
          * ad's existing creative is replaced via a new `/act_X/adcreatives` upload + ad
@@ -30127,6 +30131,9 @@ type UpdateAdData = {
          * - **TikTok**: patch-style. Pass any subset; `headline` is ignored (TikTok creatives
          * have no headline slot). `body` becomes the in-feed `ad_text`; `linkUrl` becomes
          * `landing_page_url`; `videoUrl` triggers a fresh upload.
+         * - **LinkedIn**: uploads new media (image via `imageUrl` or video via `videoUrl`),
+         * creates a new inline media creative on the same campaign, and pauses the old
+         * creative (best-effort). The old creative is retained for historical reporting.
          *
          */
         creative?: {
@@ -32037,6 +32044,14 @@ type BoostPostData = {
          *
          */
         dsaPayor?: string;
+        /**
+         * Lead Gen form ID to attach to the boosted ad's creative. REQUIRED when `goal` is `lead_generation`. On Meta this is the leadgen_forms ID (create one via POST /v1/ads/lead-forms). On LinkedIn this is the adForm ID (create one via POST /v1/ads/lead-forms with a LinkedIn account); the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}`. Ignored for other goals.
+         */
+        leadGenFormId?: string;
+        /**
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
+         */
+        status?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. The value must be compatible
@@ -32113,8 +32128,9 @@ type CreateStandaloneAdData = {
          *
          * **LinkedIn**
          * - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`.
+         * - `lead_generation`: requires `leadGenFormId` (an adForm ID from POST /v1/ads/lead-forms). The campaign objective is set to MAX_LEAD and the creative's `leadgenCallToAction` destination is set to `urn:li:adForm:{id}`.
          * - `job_applicants` requires a `platformSpecificData.jobs` creative.
-         * - For `lead_generation` or `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
+         * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
          * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
@@ -32160,7 +32176,7 @@ type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta and TikTok. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused.
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
@@ -32208,7 +32224,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` (or `videoUrls`) entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads.
          */
         leadGenFormId?: string;
         /**

package/dist/index.d.ts

@@ -2770,7 +2770,7 @@ type BulkUploadResult = {
         errors?: Array<(string)>;
     }>;
     /**
-     * Top-level advisory warnings (e.g. `rows_exceed_advisory_limit:500`). Empty when none.
+     * Top-level advisory warnings, e.g. `rows_exceed_advisory_limit:500` or `unknown_columns:<a,b,c>` (comma-separated unrecognized CSV column names). Empty when none.
      */
     warnings?: Array<(string)>;
     /**
@@ -5989,6 +5989,10 @@ type PostAnalytics = {
 type PostCreateResponse = {
     message?: string;
     post?: Post;
+    /**
+     * Advisory notices about a post that was still created: media truncated for a platform, a recycling caveat, or a field that was ignored because it sat outside platforms[].platformSpecificData. Absent when there are none.
+     */
+    warnings?: Array<(string)>;
 };
 type PostDeleteResponse = {
     message?: string;
@@ -30084,8 +30088,8 @@ type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
-         * Pinterest / X / LinkedIn return 501.
+         * Meta + TikTok (demographics/interests), Google (keyword edits only),
+         * and LinkedIn (geo countries). Pinterest / X return 501.
          *
          */
         targeting?: {
@@ -30119,7 +30123,7 @@ type UpdateAdData = {
             advantage_audience?: 0 | 1;
         };
         /**
-         * Replace the ad's creative. Meta + TikTok only.
+         * Replace the ad's creative. Meta, TikTok, and LinkedIn.
          *
          * - **Meta**: requires `headline`, `body`, `callToAction`, `linkUrl`, `imageUrl`. The
          * ad's existing creative is replaced via a new `/act_X/adcreatives` upload + ad
@@ -30127,6 +30131,9 @@ type UpdateAdData = {
          * - **TikTok**: patch-style. Pass any subset; `headline` is ignored (TikTok creatives
          * have no headline slot). `body` becomes the in-feed `ad_text`; `linkUrl` becomes
          * `landing_page_url`; `videoUrl` triggers a fresh upload.
+         * - **LinkedIn**: uploads new media (image via `imageUrl` or video via `videoUrl`),
+         * creates a new inline media creative on the same campaign, and pauses the old
+         * creative (best-effort). The old creative is retained for historical reporting.
          *
          */
         creative?: {
@@ -32037,6 +32044,14 @@ type BoostPostData = {
          *
          */
         dsaPayor?: string;
+        /**
+         * Lead Gen form ID to attach to the boosted ad's creative. REQUIRED when `goal` is `lead_generation`. On Meta this is the leadgen_forms ID (create one via POST /v1/ads/lead-forms). On LinkedIn this is the adForm ID (create one via POST /v1/ads/lead-forms with a LinkedIn account); the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}`. Ignored for other goals.
+         */
+        leadGenFormId?: string;
+        /**
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
+         */
+        status?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. The value must be compatible
@@ -32113,8 +32128,9 @@ type CreateStandaloneAdData = {
          *
          * **LinkedIn**
          * - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`.
+         * - `lead_generation`: requires `leadGenFormId` (an adForm ID from POST /v1/ads/lead-forms). The campaign objective is set to MAX_LEAD and the creative's `leadgenCallToAction` destination is set to `urn:li:adForm:{id}`.
          * - `job_applicants` requires a `platformSpecificData.jobs` creative.
-         * - For `lead_generation` or `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
+         * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
          * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
@@ -32160,7 +32176,7 @@ type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta and TikTok. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused.
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
@@ -32208,7 +32224,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` (or `videoUrls`) entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads.
          */
         leadGenFormId?: string;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.675",
+  version: "0.2.677",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.675",
+  version: "0.2.677",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -908,6 +908,25 @@ export const deletePost = <ThrowOnError extends boolean = false>(options: Option
 /**
  * Bulk upload from CSV
  * Create multiple posts by uploading a CSV file. Use dryRun=true to validate without creating posts.
+ *
+ * CSV columns:
+ * - Required: `platforms`, `profiles`, and a schedule (one of `schedule_time`, a `schedule_time_<platform>` override, `publish_now=true`, `use_queue=true`, or `is_draft=true`).
+ * - Content: at least one of `post_content`, `title`, or `media_urls` is required.
+ * - Aliases: a handful of columns accept the JSON field name from POST /v1/posts, since integrators infer the CSV shape from that endpoint's body. When both are present the real CSV column wins, unless it is blank for that row, in which case the alias value is used.
+ * - `content` aliases `post_content`
+ * - `timezone` aliases `tz`
+ * - `scheduledFor` aliases `schedule_time`
+ * - `mediaUrls` aliases `media_urls`
+ * - Per-platform overrides use three dynamic column prefixes, one column per platform (e.g. `schedule_time_instagram`, `custom_content_tiktok`, `custom_media_youtube`): `schedule_time_<platform>`, `custom_content_<platform>`, `custom_media_<platform>`.
+ * - Any other column is not read. It does not error, but it is reported in the response's `warnings` array as `unknown_columns:<a,b,c>` (see BulkUploadResult), so a misnamed or unsupported column is never silently dropped.
+ * - Row limits: 5000 rows is a hard cap that returns 400 above it. 500 rows is only an advisory threshold, it adds `rows_exceed_advisory_limit:500` to `warnings` and the request still processes.
+ *
+ * Example row (header + one data row):
+ * ```
+ * post_content,platforms,profiles,schedule_time,tz
+ * "Hello world",instagram,MyProfile,2026-09-01 10:00,America/New_York
+ * ```
+ *
  */
 export const bulkUploadPosts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BulkUploadPostsData, ThrowOnError>) => {
     return (options?.client ?? client).post<BulkUploadPostsResponse, BulkUploadPostsError, ThrowOnError>({
@@ -8006,7 +8025,10 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * kind on the ad group (criteria not in the list are removed); a kind left out is
  * untouched. Any other `targeting` field returns 400: Google cannot mutate broad
  * targeting post-create without recreating the campaign. `creative` returns 501.
- * - **Pinterest / X / LinkedIn / OpenAI Ads**: status + budget only. Sending
+ * - **LinkedIn**: status, budget, targeting (geo countries only, applied to the
+ * LinkedIn Campaign via PARTIAL_UPDATE), and creative (uploads new media, creates a
+ * replacement inline creative on the same campaign, pauses the old one).
+ * - **Pinterest / X / OpenAI Ads**: status + budget only. Sending
  * `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.
  * OpenAI Ads budget is lifetime-only (see `budget.type` below).
  *

package/src/generated/types.gen.ts

@@ -1478,7 +1478,7 @@ export type BulkUploadResult = {
         errors?: Array<(string)>;
     }>;
     /**
-     * Top-level advisory warnings (e.g. `rows_exceed_advisory_limit:500`). Empty when none.
+     * Top-level advisory warnings, e.g. `rows_exceed_advisory_limit:500` or `unknown_columns:<a,b,c>` (comma-separated unrecognized CSV column names). Empty when none.
      */
     warnings?: Array<(string)>;
     /**
@@ -4821,6 +4821,10 @@ export type PostAnalytics = {
 export type PostCreateResponse = {
     message?: string;
     post?: Post;
+    /**
+     * Advisory notices about a post that was still created: media truncated for a platform, a recycling caveat, or a field that was ignored because it sat outside platforms[].platformSpecificData. Absent when there are none.
+     */
+    warnings?: Array<(string)>;
 };
 
 export type PostDeleteResponse = {
@@ -30549,8 +30553,8 @@ export type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
-         * Pinterest / X / LinkedIn return 501.
+         * Meta + TikTok (demographics/interests), Google (keyword edits only),
+         * and LinkedIn (geo countries). Pinterest / X return 501.
          *
          */
         targeting?: {
@@ -30584,7 +30588,7 @@ export type UpdateAdData = {
             advantage_audience?: 0 | 1;
         };
         /**
-         * Replace the ad's creative. Meta + TikTok only.
+         * Replace the ad's creative. Meta, TikTok, and LinkedIn.
          *
          * - **Meta**: requires `headline`, `body`, `callToAction`, `linkUrl`, `imageUrl`. The
          * ad's existing creative is replaced via a new `/act_X/adcreatives` upload + ad
@@ -30592,6 +30596,9 @@ export type UpdateAdData = {
          * - **TikTok**: patch-style. Pass any subset; `headline` is ignored (TikTok creatives
          * have no headline slot). `body` becomes the in-feed `ad_text`; `linkUrl` becomes
          * `landing_page_url`; `videoUrl` triggers a fresh upload.
+         * - **LinkedIn**: uploads new media (image via `imageUrl` or video via `videoUrl`),
+         * creates a new inline media creative on the same campaign, and pauses the old
+         * creative (best-effort). The old creative is retained for historical reporting.
          *
          */
         creative?: {
@@ -32631,6 +32638,14 @@ export type BoostPostData = {
          *
          */
         dsaPayor?: string;
+        /**
+         * Lead Gen form ID to attach to the boosted ad's creative. REQUIRED when `goal` is `lead_generation`. On Meta this is the leadgen_forms ID (create one via POST /v1/ads/lead-forms). On LinkedIn this is the adForm ID (create one via POST /v1/ads/lead-forms with a LinkedIn account); the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}`. Ignored for other goals.
+         */
+        leadGenFormId?: string;
+        /**
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
+         */
+        status?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. The value must be compatible
@@ -32710,8 +32725,9 @@ export type CreateStandaloneAdData = {
          *
          * **LinkedIn**
          * - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`.
+         * - `lead_generation`: requires `leadGenFormId` (an adForm ID from POST /v1/ads/lead-forms). The campaign objective is set to MAX_LEAD and the creative's `leadgenCallToAction` destination is set to `urn:li:adForm:{id}`.
          * - `job_applicants` requires a `platformSpecificData.jobs` creative.
-         * - For `lead_generation` or `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
+         * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
          * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
@@ -32757,7 +32773,7 @@ export type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta and TikTok. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused.
+         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
@@ -32805,7 +32821,7 @@ export type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` (or `videoUrls`) entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads.
          */
         leadGenFormId?: string;
         /**