@getlatedev/node 0.2.258 → 0.2.260

package/README.md

@@ -382,7 +382,7 @@ try {
 | `ads.listFormLeads()` | List leads for a single form |
 | `ads.listLeadForms()` | List Lead Gen (Instant) forms |
 | `ads.listLeads()` | List submitted leads (cross-form CRM view) |
-| `ads.createConversionDestination()` | Create a conversion destination (LinkedIn) |
+| `ads.createConversionDestination()` | Create a conversion destination (LinkedIn, Google Ads) |
 | `ads.createCtwaAd()` | Create Click-to-WhatsApp ad(s) |
 | `ads.createLeadForm()` | Create a Lead Gen (Instant) form |
 | `ads.createStandaloneAd()` | Create standalone ad |

package/dist/index.d.mts

@@ -15347,7 +15347,7 @@ type GetWhatsAppNumberKycFormResponse = ({
         localTo?: (string) | null;
     }>;
     /**
-     * Present when this account already has an approved verification for the country that can be reused (skip the form).
+     * Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
      */
     reusable?: {
         available?: boolean;
@@ -15359,6 +15359,16 @@ type GetWhatsAppNumberKycFormResponse = ({
             label?: string;
             value?: string;
         }>;
+        /**
+         * One entry per distinct approved verification, newest first.
+         */
+        options?: Array<{
+            fromPhoneNumber?: string;
+            details?: Array<{
+                label?: string;
+                value?: string;
+            }>;
+        }>;
     } | null;
 });
 type GetWhatsAppNumberKycFormError = (unknown | {
@@ -15376,6 +15386,10 @@ type SubmitWhatsAppNumberKycData = {
          * Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
          */
         reuse?: boolean;
+        /**
+         * Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+         */
+        reuseFrom?: string;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -20462,44 +20476,54 @@ type ListConversionDestinationsError = (unknown | {
 type CreateConversionDestinationData = {
     body: {
         /**
-         * Sponsored ad account ID. Numeric (e.g. "5123456") or
-         * full `urn:li:sponsoredAccount:{id}` URN.
+         * Ad account ID. For LinkedIn: numeric (e.g. "5123456") or
+         * full `urn:li:sponsoredAccount:{id}` URN. For Google: numeric
+         * customer ID (e.g. "1234567890") or `customers/{id}` form.
          *
          */
         adAccountId: string;
         name: string;
         /**
-         * Either a unified standard event name (e.g. "Purchase",
-         * "Lead", "AddToCart") or a LinkedIn rule type enum value
-         * (e.g. "PURCHASE", "QUALIFIED_LEAD"). The API maps
-         * standard names to LinkedIn enum values automatically.
+         * Conversion type. For LinkedIn: a unified standard event name
+         * (e.g. "Purchase", "Lead", "AddToCart") or a LinkedIn rule
+         * type enum (e.g. "PURCHASE", "QUALIFIED_LEAD"). For Google:
+         * a unified standard event name (Purchase, Subscribe,
+         * CompleteRegistration, Lead, Schedule) or a Google
+         * ConversionActionCategory enum value directly (e.g.
+         * "PURCHASE", "SUBSCRIBE_PAID", "SIGNUP", "IMPORTED_LEAD",
+         * "BOOK_APPOINTMENT"). Unknown values pass through to the
+         * platform.
          *
          */
         type: string;
+        /**
+         * LinkedIn only.
+         */
         attributionType?: 'LAST_TOUCH_BY_CAMPAIGN' | 'LAST_TOUCH_BY_CONVERSION';
         /**
-         * Default 30. 365 only allowed for LEAD, PURCHASE,
-         * ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION rule
-         * types — the API rejects other combinations locally.
+         * LinkedIn only. Default 30. 365 only allowed for LEAD,
+         * PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION
+         * rule types; the API rejects other combinations locally.
          *
          */
         postClickAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * Default 7. Same 365-day-window type restriction applies
-         * as `postClickAttributionWindowSize`.
+         * LinkedIn only. Default 7. Same 365-day-window type
+         * restriction applies as `postClickAttributionWindowSize`.
          *
          */
         viewThroughAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * DYNAMIC (default) uses the per-event `value` from
-         * `sendConversions`. FIXED uses the rule's `value` field.
+         * LinkedIn only. DYNAMIC (default) uses the per-event `value`
+         * from `sendConversions`. FIXED uses the rule's `value` field.
          * NO_VALUE drops monetary value entirely.
          *
          */
         valueType?: 'DYNAMIC' | 'FIXED' | 'NO_VALUE';
         /**
-         * Static conversion value. Used when `valueType=FIXED`.
-         * The currency should match the ad account's currency.
+         * LinkedIn only. Static conversion value. Used when
+         * `valueType=FIXED`. The currency should match the ad
+         * account's currency.
          *
          */
         value?: {
@@ -20513,7 +20537,8 @@ type CreateConversionDestinationData = {
             amount: string;
         };
         /**
-         * Controls campaign association at rule-creation time:
+         * LinkedIn only. Controls campaign association at rule-creation
+         * time:
          * - ALL_CAMPAIGNS: associate the rule with every active,
          * paused, and draft campaign in the ad account
          * - OBJECTIVE_BASED: associate only campaigns whose
@@ -20526,16 +20551,31 @@ type CreateConversionDestinationData = {
          *
          */
         autoAssociationType?: 'ALL_CAMPAIGNS' | 'OBJECTIVE_BASED' | 'NONE';
+        /**
+         * Google Ads only. Whether to count multiple conversions from
+         * the same click (MANY_PER_CLICK) or at most one
+         * (ONE_PER_CLICK). Defaults to MANY_PER_CLICK if omitted.
+         *
+         */
+        countingType?: 'MANY_PER_CLICK' | 'ONE_PER_CLICK';
+        /**
+         * Google Ads only. When true, the conversion action is marked
+         * as primary and immediately influences Smart Bidding. Defaults
+         * to false (secondary, record-only) to avoid unintentionally
+         * steering the customer's campaigns on creation.
+         *
+         */
+        primaryForGoal?: boolean;
     };
     path: {
         /**
-         * SocialAccount ID (linkedinads).
+         * SocialAccount ID (linkedinads or googleads).
          */
         accountId: string;
     };
 };
 type CreateConversionDestinationResponse = ({
-    platform?: 'linkedinads';
+    platform?: 'linkedinads' | 'googleads';
     destination?: ConversionDestination;
 });
 type CreateConversionDestinationError = (unknown | {

package/dist/index.d.ts

@@ -15347,7 +15347,7 @@ type GetWhatsAppNumberKycFormResponse = ({
         localTo?: (string) | null;
     }>;
     /**
-     * Present when this account already has an approved verification for the country that can be reused (skip the form).
+     * Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
      */
     reusable?: {
         available?: boolean;
@@ -15359,6 +15359,16 @@ type GetWhatsAppNumberKycFormResponse = ({
             label?: string;
             value?: string;
         }>;
+        /**
+         * One entry per distinct approved verification, newest first.
+         */
+        options?: Array<{
+            fromPhoneNumber?: string;
+            details?: Array<{
+                label?: string;
+                value?: string;
+            }>;
+        }>;
     } | null;
 });
 type GetWhatsAppNumberKycFormError = (unknown | {
@@ -15376,6 +15386,10 @@ type SubmitWhatsAppNumberKycData = {
          * Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
          */
         reuse?: boolean;
+        /**
+         * Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+         */
+        reuseFrom?: string;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -20462,44 +20476,54 @@ type ListConversionDestinationsError = (unknown | {
 type CreateConversionDestinationData = {
     body: {
         /**
-         * Sponsored ad account ID. Numeric (e.g. "5123456") or
-         * full `urn:li:sponsoredAccount:{id}` URN.
+         * Ad account ID. For LinkedIn: numeric (e.g. "5123456") or
+         * full `urn:li:sponsoredAccount:{id}` URN. For Google: numeric
+         * customer ID (e.g. "1234567890") or `customers/{id}` form.
          *
          */
         adAccountId: string;
         name: string;
         /**
-         * Either a unified standard event name (e.g. "Purchase",
-         * "Lead", "AddToCart") or a LinkedIn rule type enum value
-         * (e.g. "PURCHASE", "QUALIFIED_LEAD"). The API maps
-         * standard names to LinkedIn enum values automatically.
+         * Conversion type. For LinkedIn: a unified standard event name
+         * (e.g. "Purchase", "Lead", "AddToCart") or a LinkedIn rule
+         * type enum (e.g. "PURCHASE", "QUALIFIED_LEAD"). For Google:
+         * a unified standard event name (Purchase, Subscribe,
+         * CompleteRegistration, Lead, Schedule) or a Google
+         * ConversionActionCategory enum value directly (e.g.
+         * "PURCHASE", "SUBSCRIBE_PAID", "SIGNUP", "IMPORTED_LEAD",
+         * "BOOK_APPOINTMENT"). Unknown values pass through to the
+         * platform.
          *
          */
         type: string;
+        /**
+         * LinkedIn only.
+         */
         attributionType?: 'LAST_TOUCH_BY_CAMPAIGN' | 'LAST_TOUCH_BY_CONVERSION';
         /**
-         * Default 30. 365 only allowed for LEAD, PURCHASE,
-         * ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION rule
-         * types — the API rejects other combinations locally.
+         * LinkedIn only. Default 30. 365 only allowed for LEAD,
+         * PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION
+         * rule types; the API rejects other combinations locally.
          *
          */
         postClickAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * Default 7. Same 365-day-window type restriction applies
-         * as `postClickAttributionWindowSize`.
+         * LinkedIn only. Default 7. Same 365-day-window type
+         * restriction applies as `postClickAttributionWindowSize`.
          *
          */
         viewThroughAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * DYNAMIC (default) uses the per-event `value` from
-         * `sendConversions`. FIXED uses the rule's `value` field.
+         * LinkedIn only. DYNAMIC (default) uses the per-event `value`
+         * from `sendConversions`. FIXED uses the rule's `value` field.
          * NO_VALUE drops monetary value entirely.
          *
          */
         valueType?: 'DYNAMIC' | 'FIXED' | 'NO_VALUE';
         /**
-         * Static conversion value. Used when `valueType=FIXED`.
-         * The currency should match the ad account's currency.
+         * LinkedIn only. Static conversion value. Used when
+         * `valueType=FIXED`. The currency should match the ad
+         * account's currency.
          *
          */
         value?: {
@@ -20513,7 +20537,8 @@ type CreateConversionDestinationData = {
             amount: string;
         };
         /**
-         * Controls campaign association at rule-creation time:
+         * LinkedIn only. Controls campaign association at rule-creation
+         * time:
          * - ALL_CAMPAIGNS: associate the rule with every active,
          * paused, and draft campaign in the ad account
          * - OBJECTIVE_BASED: associate only campaigns whose
@@ -20526,16 +20551,31 @@ type CreateConversionDestinationData = {
          *
          */
         autoAssociationType?: 'ALL_CAMPAIGNS' | 'OBJECTIVE_BASED' | 'NONE';
+        /**
+         * Google Ads only. Whether to count multiple conversions from
+         * the same click (MANY_PER_CLICK) or at most one
+         * (ONE_PER_CLICK). Defaults to MANY_PER_CLICK if omitted.
+         *
+         */
+        countingType?: 'MANY_PER_CLICK' | 'ONE_PER_CLICK';
+        /**
+         * Google Ads only. When true, the conversion action is marked
+         * as primary and immediately influences Smart Bidding. Defaults
+         * to false (secondary, record-only) to avoid unintentionally
+         * steering the customer's campaigns on creation.
+         *
+         */
+        primaryForGoal?: boolean;
     };
     path: {
         /**
-         * SocialAccount ID (linkedinads).
+         * SocialAccount ID (linkedinads or googleads).
          */
         accountId: string;
     };
 };
 type CreateConversionDestinationResponse = ({
-    platform?: 'linkedinads';
+    platform?: 'linkedinads' | 'googleads';
     destination?: ConversionDestination;
 });
 type CreateConversionDestinationError = (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.258",
+  version: "0.2.260",
   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.258",
+  version: "0.2.260",
   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.258",
+  "version": "0.2.260",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -5324,11 +5324,15 @@ export const listConversionDestinations = <ThrowOnError extends boolean = false>
 };
 
 /**
- * Create a conversion destination (LinkedIn)
- * Create a new conversion rule on the platform. LinkedIn-only today;
- * other platforms manage destinations in their own UIs and return 405.
+ * Create a conversion destination (LinkedIn, Google Ads)
+ * Create a new conversion destination on the platform. Supported for
+ * LinkedIn (conversion rule) and Google Ads (conversion action). Meta
+ * manages destinations in its own UI and returns 405.
  *
- * For LinkedIn, the rule is created with `conversionMethod=CONVERSIONS_API`
+ * **WARNING: creation is NOT idempotent.** A retry creates a second
+ * destination. Deduplicate before retrying.
+ *
+ * **LinkedIn:** the rule is created with `conversionMethod=CONVERSIONS_API`
  * and (by default) auto-associated with all of the ad account's campaigns
  * via `autoAssociationType=ALL_CAMPAIGNS`. Pass `autoAssociationType: NONE`
  * to opt out and manage associations explicitly via the associations
@@ -5338,6 +5342,17 @@ export const listConversionDestinations = <ThrowOnError extends boolean = false>
  * `PURCHASE`, `ADD_TO_CART`, `QUALIFIED_LEAD`, and `LEAD` rule types;
  * the API rejects other combinations locally.
  *
+ * **Google Ads:** the conversion action is created with
+ * `type=UPLOAD_CLICKS` (required for API-uploaded offline conversions,
+ * immutable after creation). The `type` field carries the Google
+ * `ConversionActionCategory` enum value, e.g. `PURCHASE`,
+ * `SUBSCRIBE_PAID`, `SIGNUP`, `IMPORTED_LEAD`, `BOOK_APPOINTMENT`.
+ * Unified standard event names (e.g. `Purchase`, `Subscribe`,
+ * `CompleteRegistration`, `Lead`, `Schedule`) are resolved to their
+ * Google category equivalents automatically. The action defaults to
+ * secondary (non-primary) to avoid immediately steering Smart Bidding;
+ * pass `primaryForGoal: true` to opt in.
+ *
  */
 export const createConversionDestination = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateConversionDestinationData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateConversionDestinationResponse, CreateConversionDestinationError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -15526,7 +15526,7 @@ export type GetWhatsAppNumberKycFormResponse = ({
         localTo?: (string) | null;
     }>;
     /**
-     * Present when this account already has an approved verification for the country that can be reused (skip the form).
+     * Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
      */
     reusable?: {
         available?: boolean;
@@ -15538,6 +15538,16 @@ export type GetWhatsAppNumberKycFormResponse = ({
             label?: string;
             value?: string;
         }>;
+        /**
+         * One entry per distinct approved verification, newest first.
+         */
+        options?: Array<{
+            fromPhoneNumber?: string;
+            details?: Array<{
+                label?: string;
+                value?: string;
+            }>;
+        }>;
     } | null;
 });
 
@@ -15557,6 +15567,10 @@ export type SubmitWhatsAppNumberKycData = {
          * Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
          */
         reuse?: boolean;
+        /**
+         * Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+         */
+        reuseFrom?: string;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -21032,44 +21046,54 @@ export type ListConversionDestinationsError = (unknown | {
 export type CreateConversionDestinationData = {
     body: {
         /**
-         * Sponsored ad account ID. Numeric (e.g. "5123456") or
-         * full `urn:li:sponsoredAccount:{id}` URN.
+         * Ad account ID. For LinkedIn: numeric (e.g. "5123456") or
+         * full `urn:li:sponsoredAccount:{id}` URN. For Google: numeric
+         * customer ID (e.g. "1234567890") or `customers/{id}` form.
          *
          */
         adAccountId: string;
         name: string;
         /**
-         * Either a unified standard event name (e.g. "Purchase",
-         * "Lead", "AddToCart") or a LinkedIn rule type enum value
-         * (e.g. "PURCHASE", "QUALIFIED_LEAD"). The API maps
-         * standard names to LinkedIn enum values automatically.
+         * Conversion type. For LinkedIn: a unified standard event name
+         * (e.g. "Purchase", "Lead", "AddToCart") or a LinkedIn rule
+         * type enum (e.g. "PURCHASE", "QUALIFIED_LEAD"). For Google:
+         * a unified standard event name (Purchase, Subscribe,
+         * CompleteRegistration, Lead, Schedule) or a Google
+         * ConversionActionCategory enum value directly (e.g.
+         * "PURCHASE", "SUBSCRIBE_PAID", "SIGNUP", "IMPORTED_LEAD",
+         * "BOOK_APPOINTMENT"). Unknown values pass through to the
+         * platform.
          *
          */
         type: string;
+        /**
+         * LinkedIn only.
+         */
         attributionType?: 'LAST_TOUCH_BY_CAMPAIGN' | 'LAST_TOUCH_BY_CONVERSION';
         /**
-         * Default 30. 365 only allowed for LEAD, PURCHASE,
-         * ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION rule
-         * types — the API rejects other combinations locally.
+         * LinkedIn only. Default 30. 365 only allowed for LEAD,
+         * PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION
+         * rule types; the API rejects other combinations locally.
          *
          */
         postClickAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * Default 7. Same 365-day-window type restriction applies
-         * as `postClickAttributionWindowSize`.
+         * LinkedIn only. Default 7. Same 365-day-window type
+         * restriction applies as `postClickAttributionWindowSize`.
          *
          */
         viewThroughAttributionWindowSize?: 1 | 7 | 30 | 90 | 365;
         /**
-         * DYNAMIC (default) uses the per-event `value` from
-         * `sendConversions`. FIXED uses the rule's `value` field.
+         * LinkedIn only. DYNAMIC (default) uses the per-event `value`
+         * from `sendConversions`. FIXED uses the rule's `value` field.
          * NO_VALUE drops monetary value entirely.
          *
          */
         valueType?: 'DYNAMIC' | 'FIXED' | 'NO_VALUE';
         /**
-         * Static conversion value. Used when `valueType=FIXED`.
-         * The currency should match the ad account's currency.
+         * LinkedIn only. Static conversion value. Used when
+         * `valueType=FIXED`. The currency should match the ad
+         * account's currency.
          *
          */
         value?: {
@@ -21083,7 +21107,8 @@ export type CreateConversionDestinationData = {
             amount: string;
         };
         /**
-         * Controls campaign association at rule-creation time:
+         * LinkedIn only. Controls campaign association at rule-creation
+         * time:
          * - ALL_CAMPAIGNS: associate the rule with every active,
          * paused, and draft campaign in the ad account
          * - OBJECTIVE_BASED: associate only campaigns whose
@@ -21096,17 +21121,32 @@ export type CreateConversionDestinationData = {
          *
          */
         autoAssociationType?: 'ALL_CAMPAIGNS' | 'OBJECTIVE_BASED' | 'NONE';
+        /**
+         * Google Ads only. Whether to count multiple conversions from
+         * the same click (MANY_PER_CLICK) or at most one
+         * (ONE_PER_CLICK). Defaults to MANY_PER_CLICK if omitted.
+         *
+         */
+        countingType?: 'MANY_PER_CLICK' | 'ONE_PER_CLICK';
+        /**
+         * Google Ads only. When true, the conversion action is marked
+         * as primary and immediately influences Smart Bidding. Defaults
+         * to false (secondary, record-only) to avoid unintentionally
+         * steering the customer's campaigns on creation.
+         *
+         */
+        primaryForGoal?: boolean;
     };
     path: {
         /**
-         * SocialAccount ID (linkedinads).
+         * SocialAccount ID (linkedinads or googleads).
          */
         accountId: string;
     };
 };
 
 export type CreateConversionDestinationResponse = ({
-    platform?: 'linkedinads';
+    platform?: 'linkedinads' | 'googleads';
     destination?: ConversionDestination;
 });