@getlatedev/node 0.2.933 → 0.2.935

package/dist/index.d.mts

@@ -1776,7 +1776,7 @@ type Ad = {
      */
     status?: (AdStatus);
     /**
-     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`: ACTIVE / PAUSED), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta ads synced after this field was added.
+     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`, ChatGPT (OpenAI) ad `status`: ACTIVE / PAUSED, plus ARCHIVED on OpenAI), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta and OpenAI ads synced after this field was added.
      */
     configuredStatus?: (string) | null;
     /**
@@ -2172,7 +2172,7 @@ type AdCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`).
+     * Raw platform-level campaign status (Meta `effective_status`; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived).
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -2676,7 +2676,7 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * 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"):
@@ -2696,8 +2696,13 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 type AdPromotedObject = {
@@ -2733,6 +2738,17 @@ type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -2886,7 +2902,7 @@ type AdsTimelineResponse = {
     }>;
 };
 /**
- * Meta only. Attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel.
+ * Meta, plus `urlTags` on ChatGPT (OpenAI). Meta: attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel. ChatGPT (OpenAI): `urlTags` becomes the ad's `landing_page_configuration.query_string_template`, which OpenAI appends to `linkUrl` on click.
  */
 type AdTracking = {
     /**
@@ -2894,7 +2910,7 @@ type AdTracking = {
      */
     pixelId?: string;
     /**
-     * Click-URL params stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
+     * Click-URL params. Meta: stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded. ChatGPT (OpenAI): the same encoding, with OpenAI's macros `{campaign_id}`, `{ad_group_id}`, `{ad_id}` and `{oppref}` (click id) passed through raw. OpenAI expands macros here, not inside `linkUrl`.
      */
     urlTags?: Array<{
         key: string;
@@ -3022,7 +3038,7 @@ type AdTreeCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES). Distinct from per-ad `platformStatus`.
+     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived, independent of the delivery `status`). Distinct from per-ad `platformStatus`.
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -35180,7 +35196,7 @@ type CreateAdCampaignData = {
          */
         buyingType?: 'AUCTION' | 'RESERVED';
         /**
-         * Meta only. Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
+         * Meta and ChatGPT (OpenAI). Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. OpenAI has no dry-run, so there Zernio checks the budget, goal and conversion event itself. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
          */
         validateOnly?: boolean;
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
@@ -36532,7 +36548,7 @@ type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap. A daily cap cannot go back to lifetime (422).
              */
             type?: 'daily' | 'lifetime';
         };
@@ -40366,7 +40382,7 @@ type CreateStandaloneAdData = {
          * - 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.
+         * - 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 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -40403,15 +40419,15 @@ type CreateStandaloneAdData = {
          */
         aiDisclosure?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. ChatGPT (OpenAI) has no platform dry-run: Zernio runs every check it knows (creative lengths, budget, bid strategy, targeting) plus live lookups of the conversion event and target countries, and uploads or creates nothing. OpenAI's own write-time checks (image fetch, currency-specific minimums, ad review) still run only on a real create. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
          */
         validateOnly?: boolean;
         /**
-         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads: in the ad account currency, minimum 1; OpenAI can require a higher daily minimum for some currencies and names it in the error.
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts both as the campaign's single spend cap. A lifetime cap can later switch to daily with PUT /v1/ads/campaigns/{campaignId}, but OpenAI never switches a daily cap back to lifetime (422). Automatic bidding (Maximize Results) needs a daily budget.
          */
         budgetType?: 'daily' | 'lifetime';
         /**
@@ -41261,7 +41277,7 @@ type CreateStandaloneAdData = {
          *
          * Meta bid strategy applied to the ad set.
          *
-         * OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.
+         * OpenAI Ads: sent via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` with `bidAmount` sets a fixed bid (`fixed_bid`, the CPA bid on `conversions`). Omitted or `LOWEST_COST_WITHOUT_CAP` bids automatically with OpenAI's Maximize Results (`maximize_clicks` for `traffic`, `maximize_conversions` for `conversions`), which needs `budgetType: daily`; on a lifetime budget or the `awareness` goal it returns 400.
          *
          * Google (not deprecated there, this shared flat field is Google's only shape): applied to the campaign this call creates. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. Omitted, the campaign falls back to a goal-based default.
          *
@@ -43540,6 +43556,30 @@ type ListConversionDestinationsResponse = ({
          *
          */
         adAccountId?: string;
+        /**
+         * OpenAI Ads only: the conversion event settings wired
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
+         *
+         */
+        conversionEvents?: Array<{
+            id?: string;
+            name?: string;
+            /**
+             * OpenAI event type, e.g. order_created, lead_created, or custom.
+             */
+            eventType?: (string) | null;
+            customEventName?: (string) | null;
+            archived?: boolean;
+            /**
+             * Active and standard (not custom). Only these can be a conversions campaign's optimization event.
+             */
+            optimizable?: boolean;
+        }>;
     }>;
 });
 type ListConversionDestinationsError = (unknown | {

package/dist/index.d.ts

@@ -1776,7 +1776,7 @@ type Ad = {
      */
     status?: (AdStatus);
     /**
-     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`: ACTIVE / PAUSED), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta ads synced after this field was added.
+     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`, ChatGPT (OpenAI) ad `status`: ACTIVE / PAUSED, plus ARCHIVED on OpenAI), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta and OpenAI ads synced after this field was added.
      */
     configuredStatus?: (string) | null;
     /**
@@ -2172,7 +2172,7 @@ type AdCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`).
+     * Raw platform-level campaign status (Meta `effective_status`; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived).
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -2676,7 +2676,7 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * 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"):
@@ -2696,8 +2696,13 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 type AdPromotedObject = {
@@ -2733,6 +2738,17 @@ type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -2886,7 +2902,7 @@ type AdsTimelineResponse = {
     }>;
 };
 /**
- * Meta only. Attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel.
+ * Meta, plus `urlTags` on ChatGPT (OpenAI). Meta: attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel. ChatGPT (OpenAI): `urlTags` becomes the ad's `landing_page_configuration.query_string_template`, which OpenAI appends to `linkUrl` on click.
  */
 type AdTracking = {
     /**
@@ -2894,7 +2910,7 @@ type AdTracking = {
      */
     pixelId?: string;
     /**
-     * Click-URL params stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
+     * Click-URL params. Meta: stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded. ChatGPT (OpenAI): the same encoding, with OpenAI's macros `{campaign_id}`, `{ad_group_id}`, `{ad_id}` and `{oppref}` (click id) passed through raw. OpenAI expands macros here, not inside `linkUrl`.
      */
     urlTags?: Array<{
         key: string;
@@ -3022,7 +3038,7 @@ type AdTreeCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES). Distinct from per-ad `platformStatus`.
+     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived, independent of the delivery `status`). Distinct from per-ad `platformStatus`.
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -35180,7 +35196,7 @@ type CreateAdCampaignData = {
          */
         buyingType?: 'AUCTION' | 'RESERVED';
         /**
-         * Meta only. Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
+         * Meta and ChatGPT (OpenAI). Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. OpenAI has no dry-run, so there Zernio checks the budget, goal and conversion event itself. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
          */
         validateOnly?: boolean;
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
@@ -36532,7 +36548,7 @@ type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap. A daily cap cannot go back to lifetime (422).
              */
             type?: 'daily' | 'lifetime';
         };
@@ -40366,7 +40382,7 @@ type CreateStandaloneAdData = {
          * - 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.
+         * - 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 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -40403,15 +40419,15 @@ type CreateStandaloneAdData = {
          */
         aiDisclosure?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. ChatGPT (OpenAI) has no platform dry-run: Zernio runs every check it knows (creative lengths, budget, bid strategy, targeting) plus live lookups of the conversion event and target countries, and uploads or creates nothing. OpenAI's own write-time checks (image fetch, currency-specific minimums, ad review) still run only on a real create. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
          */
         validateOnly?: boolean;
         /**
-         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads: in the ad account currency, minimum 1; OpenAI can require a higher daily minimum for some currencies and names it in the error.
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts both as the campaign's single spend cap. A lifetime cap can later switch to daily with PUT /v1/ads/campaigns/{campaignId}, but OpenAI never switches a daily cap back to lifetime (422). Automatic bidding (Maximize Results) needs a daily budget.
          */
         budgetType?: 'daily' | 'lifetime';
         /**
@@ -41261,7 +41277,7 @@ type CreateStandaloneAdData = {
          *
          * Meta bid strategy applied to the ad set.
          *
-         * OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.
+         * OpenAI Ads: sent via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` with `bidAmount` sets a fixed bid (`fixed_bid`, the CPA bid on `conversions`). Omitted or `LOWEST_COST_WITHOUT_CAP` bids automatically with OpenAI's Maximize Results (`maximize_clicks` for `traffic`, `maximize_conversions` for `conversions`), which needs `budgetType: daily`; on a lifetime budget or the `awareness` goal it returns 400.
          *
          * Google (not deprecated there, this shared flat field is Google's only shape): applied to the campaign this call creates. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. Omitted, the campaign falls back to a goal-based default.
          *
@@ -43540,6 +43556,30 @@ type ListConversionDestinationsResponse = ({
          *
          */
         adAccountId?: string;
+        /**
+         * OpenAI Ads only: the conversion event settings wired
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
+         *
+         */
+        conversionEvents?: Array<{
+            id?: string;
+            name?: string;
+            /**
+             * OpenAI event type, e.g. order_created, lead_created, or custom.
+             */
+            eventType?: (string) | null;
+            customEventName?: (string) | null;
+            archived?: boolean;
+            /**
+             * Active and standard (not custom). Only these can be a conversions campaign's optimization event.
+             */
+            optimizable?: boolean;
+        }>;
     }>;
 });
 type ListConversionDestinationsError = (unknown | {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.933",
+  version: "0.2.935",
   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: "@getlatedev/node",
-  version: "0.2.933",
+  version: "0.2.935",
   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": "@getlatedev/node",
-  "version": "0.2.933",
+  "version": "0.2.935",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -8722,8 +8722,9 @@ export const listAdCampaigns = <ThrowOnError extends boolean = false>(options?:
  * for ABO (each ad set carries its own budget), and `specialAdCategories` is Meta-only
  * (400 elsewhere); `bidStrategy` is Meta and Google (400 elsewhere), and Google also
  * accepts `portfolioBidStrategyId` instead. Google, X and OpenAI require a budget
- * (422 without one; OpenAI accepts only `budgetType: lifetime`, Google only
- * `budgetType: daily`). LinkedIn creates the
+ * (422 without one; OpenAI accepts daily or lifetime, Google only
+ * `budgetType: daily`). On OpenAI `goal` sets the campaign objective, and
+ * `conversions` needs an active standard conversion event on the account. 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
@@ -8896,7 +8897,8 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
  *
  * OpenAI Ads campaigns carry exactly one spend cap: `budget.type` daily or lifetime
  * replaces whichever cap the campaign had, with a minimum of 1 in the ad account's
- * currency (422 below it).
+ * currency (422 below it). Lifetime can switch to daily, but OpenAI never switches a
+ * daily cap back to lifetime (422).
  *
  * `accountId` forwards the update straight to Meta for a campaign with zero ads,
  * which would otherwise 404; the response then carries `updated: 0`.

package/src/generated/types.gen.ts

@@ -92,7 +92,7 @@ export type Ad = {
      */
     status?: (AdStatus);
     /**
-     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`: ACTIVE / PAUSED), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta ads synced after this field was added.
+     * The ad's own on/off toggle as configured on the platform (Meta `configured_status`, ChatGPT (OpenAI) ad `status`: ACTIVE / PAUSED, plus ARCHIVED on OpenAI), unaffected by ancestor (ad set / campaign) pauses. Distinct from `status`, which is the ancestor-cascaded delivery status. Only present for Meta and OpenAI ads synced after this field was added.
      */
     configuredStatus?: (string) | null;
     /**
@@ -496,7 +496,7 @@ export type AdCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`).
+     * Raw platform-level campaign status (Meta `effective_status`; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived).
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -1017,7 +1017,7 @@ export type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * 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"):
@@ -1037,8 +1037,13 @@ export type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 export type AdPromotedObject = {
@@ -1074,6 +1079,17 @@ export type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -1236,7 +1252,7 @@ export type AdsTimelineResponse = {
 };
 
 /**
- * Meta only. Attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel.
+ * Meta, plus `urlTags` on ChatGPT (OpenAI). Meta: attaches pixel measurement to the ad regardless of the optimization goal (the "Website events" tracking row in Ads Manager). `pixelId` becomes the ad's `tracking_specs` (offsite_conversion + fb_pixel); `urlTags` is stored on the new creative as `url_tags` and retained on the ad for compatibility. Applied on the legacy single-creative shape, every ad of the multi-creative shape, and the attach shape. NOTE: tracking lives on the AD object and is not inherited from the ad set, so pass it on EVERY attach call that should carry the pixel. ChatGPT (OpenAI): `urlTags` becomes the ad's `landing_page_configuration.query_string_template`, which OpenAI appends to `linkUrl` on click.
  */
 export type AdTracking = {
     /**
@@ -1244,7 +1260,7 @@ export type AdTracking = {
      */
     pixelId?: string;
     /**
-     * Click-URL params stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
+     * Click-URL params. Meta: stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded. ChatGPT (OpenAI): the same encoding, with OpenAI's macros `{campaign_id}`, `{ad_group_id}`, `{ad_id}` and `{oppref}` (click id) passed through raw. OpenAI expands macros here, not inside `linkUrl`.
      */
     urlTags?: Array<{
         key: string;
@@ -1374,7 +1390,7 @@ export type AdTreeCampaign = {
      */
     reviewStatus?: (AdReviewStatus | null);
     /**
-     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES). Distinct from per-ad `platformStatus`.
+     * Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES; ChatGPT (OpenAI): the campaign's own switch, active / paused / archived, independent of the delivery `status`). Distinct from per-ad `platformStatus`.
      */
     platformCampaignStatus?: (string) | null;
     /**
@@ -35517,7 +35533,7 @@ export type CreateAdCampaignData = {
          */
         buyingType?: 'AUCTION' | 'RESERVED';
         /**
-         * Meta only. Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
+         * Meta and ChatGPT (OpenAI). Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. OpenAI has no dry-run, so there Zernio checks the budget, goal and conversion event itself. `true` on any other platform returns 501 `feature_not_available` (same as POST /v1/ads/create); `false` is ignored.
          */
         validateOnly?: boolean;
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
@@ -36944,7 +36960,7 @@ export type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap. A daily cap cannot go back to lifetime (422).
              */
             type?: 'daily' | 'lifetime';
         };
@@ -41024,7 +41040,7 @@ export type CreateStandaloneAdData = {
          * - 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.
+         * - 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 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -41061,15 +41077,15 @@ export type CreateStandaloneAdData = {
          */
         aiDisclosure?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. ChatGPT (OpenAI) has no platform dry-run: Zernio runs every check it knows (creative lengths, budget, bid strategy, targeting) plus live lookups of the conversion event and target countries, and uploads or creates nothing. OpenAI's own write-time checks (image fetch, currency-specific minimums, ad review) still run only on a real create. Any other platform, or a Google campaignType other than pmax, returns 501 `feature_not_available`.
          */
         validateOnly?: boolean;
         /**
-         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads: in the ad account currency, minimum 1; OpenAI can require a higher daily minimum for some currencies and names it in the error.
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts both as the campaign's single spend cap. A lifetime cap can later switch to daily with PUT /v1/ads/campaigns/{campaignId}, but OpenAI never switches a daily cap back to lifetime (422). Automatic bidding (Maximize Results) needs a daily budget.
          */
         budgetType?: 'daily' | 'lifetime';
         /**
@@ -41919,7 +41935,7 @@ export type CreateStandaloneAdData = {
          *
          * Meta bid strategy applied to the ad set.
          *
-         * OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.
+         * OpenAI Ads: sent via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` with `bidAmount` sets a fixed bid (`fixed_bid`, the CPA bid on `conversions`). Omitted or `LOWEST_COST_WITHOUT_CAP` bids automatically with OpenAI's Maximize Results (`maximize_clicks` for `traffic`, `maximize_conversions` for `conversions`), which needs `budgetType: daily`; on a lifetime budget or the `awareness` goal it returns 400.
          *
          * Google (not deprecated there, this shared flat field is Google's only shape): applied to the campaign this call creates. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. Omitted, the campaign falls back to a goal-based default.
          *
@@ -44352,6 +44368,30 @@ export type ListConversionDestinationsResponse = ({
          *
          */
         adAccountId?: string;
+        /**
+         * OpenAI Ads only: the conversion event settings wired
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
+         *
+         */
+        conversionEvents?: Array<{
+            id?: string;
+            name?: string;
+            /**
+             * OpenAI event type, e.g. order_created, lead_created, or custom.
+             */
+            eventType?: (string) | null;
+            customEventName?: (string) | null;
+            archived?: boolean;
+            /**
+             * Active and standard (not custom). Only these can be a conversions campaign's optimization event.
+             */
+            optimizable?: boolean;
+        }>;
     }>;
 });