@zernio/node 0.2.157 → 0.2.169

package/src/generated/types.gen.ts

@@ -785,6 +785,67 @@ export type BlueskyPlatformData = {
     }>;
 };
 
+/**
+ * Result of a CSV bulk upload. The same shape is returned for `200` (all rows
+ * succeeded or all failed) and `207` (mixed). Per-row outcomes live in `results`;
+ * the row's success is `ok`, and failures carry machine-readable codes in `errors`.
+ *
+ */
+export type BulkUploadResult = {
+    /**
+     * Number of data rows processed from the CSV
+     */
+    total?: number;
+    /**
+     * Count of rows that succeeded (results[].ok === true)
+     */
+    valid?: number;
+    /**
+     * Count of rows that failed (total - valid)
+     */
+    invalid?: number;
+    /**
+     * One entry per CSV data row, in row order.
+     */
+    results?: Array<{
+        /**
+         * 1-based index of the CSV data row (header excluded)
+         */
+        rowIndex?: number;
+        /**
+         * Whether the row was created successfully
+         */
+        ok?: boolean;
+        /**
+         * ID of the created post. Present only when `ok` is true and not a dry run.
+         */
+        createdPostId?: string;
+        /**
+         * Machine-readable failure codes for this row. Present only when `ok` is false.
+         * Examples: `unknown_profile:<id>`, `no_account_for_platform:<platform>`,
+         * `schedule_time_missing`, `rate_limited:<platform>:@<username>:<remaining>`.
+         *
+         */
+        errors?: Array<(string)>;
+    }>;
+    /**
+     * Top-level advisory warnings (e.g. `rows_exceed_advisory_limit:500`). Empty when none.
+     */
+    warnings?: Array<(string)>;
+    /**
+     * Present only when one or more rows targeted an account currently in cooldown.
+     * Lets callers map `rate_limited:*` row errors back to structured metadata without
+     * parsing the error strings.
+     *
+     */
+    rateLimitedAccounts?: Array<{
+        accountId?: string;
+        platform?: string;
+        username?: string;
+        rateLimitedUntil?: string;
+    }>;
+};
+
 /**
  * TikTok Business Center entity. Returned by `GET /v1/ads/business-centers`. BCs are
  * TikTok's agency container — one BC owns N advertisers (ad accounts). Most solo
@@ -1940,6 +2001,10 @@ export type MediaItem = {
      * Optional title for the media item. Used as the document title for LinkedIn PDF/carousel posts. If omitted, falls back to the post title, then the filename.
      */
     title?: string;
+    /**
+     * Accessibility alternative text for an image, applied on every platform that supports it: Instagram (feed images only, not Reels/Stories), Facebook, Threads, X/Twitter (max 1000 chars), LinkedIn, Bluesky, and Pinterest (max 500 chars). Ignored on platforms without alt-text support (TikTok, YouTube, Snapchat, Telegram, Reddit, Google Business, WhatsApp) and on video items where the platform does not accept it. Set once per image; the same value is sent to each selected platform.
+     */
+    altText?: string;
     filename?: string;
     /**
      * Optional file size in bytes
@@ -2625,6 +2690,169 @@ export type SocialAccount = {
 
 export type platform5 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
 
+/**
+ * Normalized, platform-agnostic ad-targeting spec. Every field is optional, an
+ * empty object targets the platform's default broadest audience. Field names are
+ * camelCase and identical across `POST /v1/ads/create` (the `targeting` object),
+ * `POST /v1/ads/targeting/reach-estimate`, and `saved_targeting` audiences, so a
+ * spec resolved once can be reused verbatim.
+ *
+ * Entity ids (`regions[].key`, `cities[].key`, `zips[].key`, `metros[].key`,
+ * `interests[].id`, `behaviors[].id`) are the platform's opaque identifiers
+ * resolved via `GET /v1/ads/targeting/search`. A spec is therefore meaningful only
+ * for the platform it was built against, except the portable fields (`countries`,
+ * `ageMin`/`ageMax`, `gender`, `incomeTier`, `languages`) which carry across
+ * platforms. Fields a platform cannot honour are rejected at create time with
+ * `INVALID_FIELD_VALUE` naming the offending field (not silently dropped).
+ *
+ */
+export type TargetingSpec = {
+    /**
+     * ISO 3166-1 alpha-2 country codes (e.g. ['US']).
+     */
+    countries?: Array<(string)>;
+    /**
+     * Region/state targeting. `key` is the platform location ID from /v1/ads/targeting/search?dimension=geo&geoType=region.
+     */
+    regions?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    /**
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     */
+    cities?: Array<{
+        key: string;
+        name?: string;
+        /**
+         * Radius around the city. Requires distanceUnit.
+         */
+        radius?: number;
+        /**
+         * Required if radius is set.
+         */
+        distanceUnit?: 'mile' | 'kilometer';
+    }>;
+    /**
+     * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
+     */
+    zips?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    /**
+     * DMA / metro-area targeting. `key` is the platform's metro ID (e.g. Meta `DMA:807`).
+     */
+    metros?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    /**
+     * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured only where the capability map allows radius (Meta).
+     */
+    customLocations?: Array<{
+        latitude: number;
+        longitude: number;
+        /**
+         * Positive radius around the point.
+         */
+        radius: number;
+        distanceUnit: 'mile' | 'kilometer';
+        name?: string;
+        address?: string;
+    }>;
+    /**
+     * Geo to exclude from the audience. A subset of the inclusion geo shape.
+     */
+    excludedLocations?: {
+        countries?: Array<(string)>;
+        regions?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        cities?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        zips?: Array<{
+            key: string;
+            name?: string;
+        }>;
+    };
+    ageMin?: number;
+    ageMax?: number;
+    /**
+     * Restrict by gender. 'all' (default) targets everyone.
+     */
+    gender?: 'all' | 'male' | 'female';
+    /**
+     * Normalized household-income tier (ZIP/percentile based). Meta and TikTok
+     * express all four. Google maps only `top_10` (its INCOME_RANGE_90_UP); other
+     * tiers on Google, and any income tier on LinkedIn / X / Pinterest, are rejected.
+     * On Meta, income/zip targeting requires the relevant `specialAdCategories` to be
+     * unset (housing/employment/credit ads cannot use it).
+     *
+     */
+    incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
+    /**
+     * Language codes (e.g. ['en']).
+     */
+    languages?: Array<(string)>;
+    /**
+     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id.
+     */
+    interests?: Array<{
+        id: string;
+        name?: string;
+    }>;
+    /**
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok.
+     */
+    behaviors?: Array<{
+        id: string;
+        name?: string;
+    }>;
+    /**
+     * LinkedIn B2B only. Industry URN id fragments.
+     */
+    industries?: Array<(string)>;
+    /**
+     * LinkedIn B2B only.
+     */
+    companySizes?: Array<(string)>;
+    /**
+     * LinkedIn B2B only.
+     */
+    seniorities?: Array<(string)>;
+    /**
+     * LinkedIn B2B only.
+     */
+    jobFunctions?: Array<(string)>;
+    /**
+     * Platform audience IDs to include.
+     */
+    audienceInclude?: Array<(string)>;
+    /**
+     * Platform audience IDs to exclude.
+     */
+    audienceExclude?: Array<(string)>;
+};
+
+/**
+ * Restrict by gender. 'all' (default) targets everyone.
+ */
+export type gender = 'all' | 'male' | 'female';
+
+/**
+ * Normalized household-income tier (ZIP/percentile based). Meta and TikTok
+ * express all four. Google maps only `top_10` (its INCOME_RANGE_90_UP); other
+ * tiers on Google, and any income tier on LinkedIn / X / Pinterest, are rejected.
+ * On Meta, income/zip targeting requires the relevant `specialAdCategories` to be
+ * unset (housing/employment/credit ads cannot use it).
+ *
+ */
+export type incomeTier = 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
+
 /**
  * Text, images (up to 10), videos (up to 10), and mixed media albums. Captions up to 1024 chars for media, 4096 for text-only.
  */
@@ -3097,7 +3325,7 @@ export type Webhook = {
     /**
      * Events subscribed to
      */
-    events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
+    events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -4101,6 +4329,71 @@ export type WebhookPayloadPostPlatform = {
 
 export type event12 = 'post.platform.published' | 'post.platform.failed';
 
+/**
+ * Webhook payload for reaction received events (WhatsApp, Telegram)
+ */
+export type WebhookPayloadReaction = {
+    /**
+     * Stable webhook event ID
+     */
+    id: string;
+    event: 'reaction.received';
+    reaction: {
+        /**
+         * The emoji reacted with. May be an empty string when `action` is
+         * `removed` on WhatsApp (Meta does not report which emoji was removed).
+         *
+         */
+        emoji: string;
+        action: 'added' | 'removed';
+        /**
+         * Internal Zernio message ID of the reacted-to message, when resolvable from the platform ID.
+         */
+        messageId?: string;
+        /**
+         * Platform-native ID of the reacted-to message (e.g. WhatsApp wamid).
+         */
+        platformMessageId: string;
+        /**
+         * The participant who added or removed the reaction.
+         */
+        sender: {
+            id: string;
+            name?: string;
+            username?: string;
+            picture?: string;
+            /**
+             * WhatsApp only. Sender's phone number in E.164 format (with leading `+`), when available.
+             */
+            phoneNumber?: (string) | null;
+        };
+        reactedAt: string;
+    };
+    conversation: {
+        id: string;
+        platformConversationId: string;
+        participantId?: string;
+        participantName?: string;
+        participantUsername?: string;
+        participantPicture?: string;
+        status: 'active' | 'archived';
+    };
+    account: {
+        /**
+         * Social account ID
+         */
+        id: string;
+        platform: string;
+        username: string;
+        displayName?: string;
+    };
+    timestamp: string;
+};
+
+export type event13 = 'reaction.received';
+
+export type action = 'added' | 'removed';
+
 /**
  * Webhook payload for the review.new event (new review posted on a connected account).
  */
@@ -4119,7 +4412,7 @@ export type WebhookPayloadReviewNew = {
     timestamp: string;
 };
 
-export type event13 = 'review.new';
+export type event14 = 'review.new';
 
 /**
  * Webhook payload for the review.updated event. Fired when the reviewer edits
@@ -4143,7 +4436,7 @@ export type WebhookPayloadReviewUpdated = {
     timestamp: string;
 };
 
-export type event14 = 'review.updated';
+export type event15 = 'review.updated';
 
 /**
  * Webhook payload for test deliveries
@@ -4161,7 +4454,7 @@ export type WebhookPayloadTest = {
     timestamp: string;
 };
 
-export type event15 = 'webhook.test';
+export type event16 = 'webhook.test';
 
 /**
  * Webhook payload for the `whatsapp.template.status_updated` event.
@@ -4216,7 +4509,7 @@ export type WebhookPayloadWhatsAppTemplateStatusUpdated = {
     timestamp: string;
 };
 
-export type event16 = 'whatsapp.template.status_updated';
+export type event17 = 'whatsapp.template.status_updated';
 
 export type platform8 = 'whatsapp';
 
@@ -4573,18 +4866,12 @@ export type ValidatePostData = {
             platformSpecificData?: {
                 [key: string]: unknown;
             };
-            customMedia?: Array<{
-                url?: string;
-                type?: 'image' | 'video';
-            }>;
+            customMedia?: Array<MediaItem>;
         }>;
         /**
          * Root media items shared across platforms
          */
-        mediaItems?: Array<{
-            url?: string;
-            type?: 'image' | 'video';
-        }>;
+        mediaItems?: Array<MediaItem>;
     };
 };
 
@@ -5769,10 +6056,7 @@ export type CreatePostData = {
          * Post caption/text. Optional when media is attached or all platforms have customContent. Required for text-only posts.
          */
         content?: string;
-        mediaItems?: Array<{
-            type?: 'image' | 'video' | 'gif' | 'document';
-            url?: string;
-        }>;
+        mediaItems?: Array<MediaItem>;
         /**
          * Target platforms and accounts for this post. Required for non-draft posts (returns 400 if empty). Drafts can omit platforms.
          */
@@ -5783,10 +6067,7 @@ export type CreatePostData = {
              * Platform-specific text override. When set, this content is used instead of the top-level post content for this platform. Useful for tailoring captions per platform (e.g. keeping tweets under 280 characters).
              */
             customContent?: string;
-            customMedia?: Array<{
-                type?: 'image' | 'video' | 'gif' | 'document';
-                url?: string;
-            }>;
+            customMedia?: Array<MediaItem>;
             /**
              * Optional per-platform scheduled time override. When omitted, the top-level scheduledFor is used.
              */
@@ -5923,17 +6204,7 @@ export type BulkUploadPostsData = {
     };
 };
 
-export type BulkUploadPostsResponse = ({
-    success?: boolean;
-    totalRows?: number;
-    created?: number;
-    failed?: number;
-    errors?: Array<{
-        row?: number;
-        error?: string;
-    }>;
-    posts?: Array<Post>;
-} | unknown);
+export type BulkUploadPostsResponse = (BulkUploadResult);
 
 export type BulkUploadPostsError = (unknown | {
     error?: string;
@@ -7202,7 +7473,7 @@ export type GetGoogleBusinessReviewsError = (ErrorResponse | {
     error?: string;
 });
 
-export type GetGoogleBusinessFoodMenusData = {
+export type GetGoogleBusinessVerificationsData = {
     path: {
         /**
          * The Zernio account ID (from /v1/accounts)
@@ -7217,31 +7488,80 @@ export type GetGoogleBusinessFoodMenusData = {
     };
 };
 
-export type GetGoogleBusinessFoodMenusResponse = ({
+export type GetGoogleBusinessVerificationsResponse = ({
     success?: boolean;
     accountId?: string;
     locationId?: string;
     /**
-     * Resource name of the food menus
+     * Raw Voice of Merchant state from Google.
      */
-    name?: string;
-    menus?: Array<FoodMenu>;
+    voiceOfMerchantState?: {
+        /**
+         * True when the listing is verified and published (eligible to surface reviews
+         */
+        hasVoiceOfMerchant?: boolean;
+        /**
+         * True when the authenticated user has owner/manager authority over the listing.
+         */
+        hasBusinessAuthority?: boolean;
+        /**
+         * Present when verification is the path to Voice of Merchant.
+         */
+        verify?: {
+            /**
+             * True when a verification is already in progress.
+             */
+            hasPendingVerification?: boolean;
+        };
+    };
+    /**
+     * Verification history, newest first. Empty when none exist.
+     */
+    verifications?: Array<{
+        /**
+         * Resource name, e.g. "locations/123/verifications/0T1776879124712". The last segment is the verificationId.
+         */
+        name?: string;
+        /**
+         * Method used (omitted on some entries).
+         */
+        method?: 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER';
+        state?: 'PENDING' | 'COMPLETED' | 'FAILED';
+        createTime?: string;
+    }>;
 });
 
-export type GetGoogleBusinessFoodMenusError = (ErrorResponse | {
+export type GetGoogleBusinessVerificationsError = (ErrorResponse | {
     error?: string;
 });
 
-export type UpdateGoogleBusinessFoodMenusData = {
+export type StartGoogleBusinessVerificationData = {
     body: {
         /**
-         * Array of food menus to set
+         * The verification method. Selects which method-specific field below is required.
          */
-        menus: Array<FoodMenu>;
+        method: 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER';
+        languageCode?: string;
         /**
-         * Field mask for partial updates (e.g. "menus")
+         * For PHONE_CALL / SMS.
          */
-        updateMask?: string;
+        phoneNumber?: string;
+        /**
+         * For EMAIL.
+         */
+        emailAddress?: string;
+        /**
+         * For ADDRESS (postcard) verification.
+         */
+        mailerContact?: {
+            [key: string]: unknown;
+        };
+        /**
+         * ServiceBusinessContext (e.g. service address). Required for service-area businesses.
+         */
+        context?: {
+            [key: string]: unknown;
+        };
     };
     path: {
         /**
@@ -7251,25 +7571,178 @@ export type UpdateGoogleBusinessFoodMenusData = {
     };
     query?: {
         /**
-         * Override which location to target. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.
+         * Override which location to target. If omitted, uses the account's selected location.
          */
         locationId?: string;
     };
 };
 
-export type UpdateGoogleBusinessFoodMenusResponse = ({
+export type StartGoogleBusinessVerificationResponse = ({
     success?: boolean;
     accountId?: string;
     locationId?: string;
-    name?: string;
-    menus?: Array<FoodMenu>;
+    verification?: {
+        name?: string;
+        method?: 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER';
+        state?: 'PENDING' | 'COMPLETED' | 'FAILED';
+        createTime?: string;
+    };
 });
 
-export type UpdateGoogleBusinessFoodMenusError = (ErrorResponse | {
+export type StartGoogleBusinessVerificationError = (ErrorResponse | {
     error?: string;
 });
 
-export type GetGoogleBusinessLocationDetailsData = {
+export type FetchGoogleBusinessVerificationOptionsData = {
+    body: {
+        languageCode: string;
+        /**
+         * ServiceBusinessContext. Required for service-area businesses (must include the service address).
+         */
+        context?: {
+            [key: string]: unknown;
+        };
+    };
+    path: {
+        /**
+         * The Zernio account ID (from /v1/accounts)
+         */
+        accountId: string;
+    };
+    query?: {
+        /**
+         * Override which location to query. If omitted, uses the account's selected location.
+         */
+        locationId?: string;
+    };
+};
+
+export type FetchGoogleBusinessVerificationOptionsResponse = ({
+    success?: boolean;
+    accountId?: string;
+    locationId?: string;
+    options?: Array<{
+        verificationMethod?: 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER';
+        /**
+         * Present for PHONE_CALL / SMS.
+         */
+        phoneNumber?: string;
+    }>;
+});
+
+export type FetchGoogleBusinessVerificationOptionsError = (ErrorResponse | {
+    error?: string;
+});
+
+export type CompleteGoogleBusinessVerificationData = {
+    body: {
+        /**
+         * The code Google sent to the business.
+         */
+        pin: string;
+    };
+    path: {
+        /**
+         * The Zernio account ID (from /v1/accounts)
+         */
+        accountId: string;
+        /**
+         * The last segment of a verification `name` from GET /gmb-verifications.
+         */
+        verificationId: string;
+    };
+    query?: {
+        /**
+         * Override which location to target. If omitted, uses the account's selected location.
+         */
+        locationId?: string;
+    };
+};
+
+export type CompleteGoogleBusinessVerificationResponse = ({
+    success?: boolean;
+    accountId?: string;
+    locationId?: string;
+    verification?: {
+        name?: string;
+        method?: 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER';
+        state?: 'PENDING' | 'COMPLETED' | 'FAILED';
+        createTime?: string;
+    };
+});
+
+export type CompleteGoogleBusinessVerificationError = (ErrorResponse | {
+    error?: string;
+});
+
+export type GetGoogleBusinessFoodMenusData = {
+    path: {
+        /**
+         * The Zernio account ID (from /v1/accounts)
+         */
+        accountId: string;
+    };
+    query?: {
+        /**
+         * Override which location to query. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.
+         */
+        locationId?: string;
+    };
+};
+
+export type GetGoogleBusinessFoodMenusResponse = ({
+    success?: boolean;
+    accountId?: string;
+    locationId?: string;
+    /**
+     * Resource name of the food menus
+     */
+    name?: string;
+    menus?: Array<FoodMenu>;
+});
+
+export type GetGoogleBusinessFoodMenusError = (ErrorResponse | {
+    error?: string;
+});
+
+export type UpdateGoogleBusinessFoodMenusData = {
+    body: {
+        /**
+         * Array of food menus to set
+         */
+        menus: Array<FoodMenu>;
+        /**
+         * Field mask for partial updates (e.g. "menus")
+         */
+        updateMask?: string;
+    };
+    path: {
+        /**
+         * The Zernio account ID (from /v1/accounts)
+         */
+        accountId: string;
+    };
+    query?: {
+        /**
+         * Override which location to target. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.
+         */
+        locationId?: string;
+    };
+};
+
+export type UpdateGoogleBusinessFoodMenusResponse = ({
+    success?: boolean;
+    accountId?: string;
+    locationId?: string;
+    name?: string;
+    menus?: Array<FoodMenu>;
+});
+
+export type UpdateGoogleBusinessFoodMenusError = (ErrorResponse | {
+    error?: string;
+});
+
+export type GetGoogleBusinessLocationDetailsData = {
     path: {
         /**
          * The Zernio account ID (from /v1/accounts)
@@ -9692,7 +10165,7 @@ export type CreateWebhookSettingsData = {
         /**
          * Events to subscribe to (at least one required)
          */
-        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -9736,7 +10209,7 @@ export type UpdateWebhookSettingsData = {
         /**
          * Events to subscribe to. Must contain at least one event if provided.
          */
-        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -10695,6 +11168,33 @@ export type SendTypingIndicatorError = ({
     error?: string;
 } | unknown);
 
+export type MarkConversationReadData = {
+    body: {
+        /**
+         * Social account ID
+         */
+        accountId: string;
+    };
+    path: {
+        /**
+         * The conversation ID
+         */
+        conversationId: string;
+    };
+};
+
+export type MarkConversationReadResponse = ({
+    success?: boolean;
+    /**
+     * Number of messages marked read by this call
+     */
+    markedCount?: number;
+});
+
+export type MarkConversationReadError = ({
+    error?: string;
+} | unknown);
+
 export type AddMessageReactionData = {
     body: {
         /**
@@ -11130,6 +11630,63 @@ export type GetInboxPostCommentsResponse = ({
          */
         rootCid?: (string) | null;
     }>;
+    /**
+     * (Reddit only) Metadata for the target post, returned alongside the comments in Reddit's
+     * single round-trip. Lets integrators render a preview of the post the user is commenting on
+     * without an additional request. Absent for non-Reddit platforms and when the upstream
+     * response is missing the post listing (deleted post, malformed response).
+     *
+     */
+    post?: {
+        /**
+         * Reddit post base36 id (e.g. "1tjtj26")
+         */
+        id?: string;
+        /**
+         * Fullname with type prefix (e.g. "t3_1tjtj26")
+         */
+        fullname?: string;
+        title?: string;
+        /**
+         * Body text for self-posts (empty for link posts)
+         */
+        selftext?: string;
+        /**
+         * Reddit username
+         */
+        author?: string;
+        /**
+         * Subreddit name
+         */
+        subreddit?: string;
+        /**
+         * Absolute URL to the post on reddit.com
+         */
+        permalink?: string;
+        /**
+         * For link posts
+         */
+        url?: string;
+        /**
+         * Net upvotes (upvotes minus downvotes)
+         */
+        score?: number;
+        numComments?: number;
+        /**
+         * Unix timestamp in seconds
+         */
+        createdUtc?: number;
+        over18?: boolean;
+        stickied?: boolean;
+        /**
+         * Link flair text if any
+         */
+        flairText?: (string) | null;
+        /**
+         * True if the post is a Reddit gallery (multiple images)
+         */
+        isGallery?: boolean;
+    } | null;
     pagination?: {
         hasMore?: boolean;
         cursor?: (string) | null;
@@ -13301,6 +13858,18 @@ export type CreateBroadcastData = {
             name?: string;
             language?: string;
             components?: unknown[];
+            /**
+             * Maps template variable positions ("1", "2") to contact fields or static values. Resolved per recipient at send time.
+             */
+            variableMapping?: {
+                [key: string]: {
+                    field?: 'name' | 'phone' | 'email' | 'company' | 'custom';
+                    /**
+                     * Static value used when field is "custom"
+                     */
+                    customValue?: string;
+                };
+            };
         };
         segmentFilters?: {
             tags?: Array<(string)>;
@@ -15141,9 +15710,13 @@ export type CreateStandaloneAdData = {
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
-         * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`.
+         * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination).
          */
         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`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization are derived automatically from the goal.
+         */
+        leadGenFormId?: string;
         /**
          * Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627).
          */
@@ -15268,6 +15841,63 @@ export type CreateStandaloneAdData = {
             id: string;
             name: string;
         }>;
+        /**
+         * Postal/ZIP geo targeting. `key` is the platform's postal location ID from /v1/ads/targeting/search?dimension=geo&geoType=zip. Supported on Meta, Google, TikTok, Pinterest, X.
+         */
+        zips?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * DMA / metro-area geo targeting. `key` is the platform's metro ID from /v1/ads/targeting/search?dimension=geo&geoType=metro.
+         */
+        metros?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * Point-radius (lat/lng) geo targeting. Meta only (custom_locations). Rejected on platforms without radius support.
+         */
+        customLocations?: Array<{
+            latitude: number;
+            longitude: number;
+            radius: number;
+            distanceUnit: 'mile' | 'kilometer';
+            name?: string;
+            address?: string;
+        }>;
+        /**
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
+         */
+        behaviors?: Array<{
+            id: string;
+            name?: string;
+        }>;
+        /**
+         * Normalized household-income tier. Meta and TikTok express all four; Google maps only
+         * `top_10`; rejected on LinkedIn, X, and Pinterest. On Meta, income targeting is incompatible
+         * with housing/employment/credit `specialAdCategories`.
+         *
+         */
+        incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
+        /**
+         * Language codes (e.g. ['en']). Restricts the audience by language.
+         */
+        languages?: Array<(string)>;
+        /**
+         * ID of a `saved_targeting` audience (created via POST /v1/ads/audiences). When set, its stored
+         * TargetingSpec is expanded as the base targeting; inline fields on this body merge on top. Lets you
+         * reuse a named targeting preset without re-sending every field.
+         *
+         */
+        savedTargetingId?: string;
+        /**
+         * Meta only. Declares the ad's special category, required for housing, employment, credit, or
+         * political/social-issue ads (Meta enforces restricted targeting for these). Note: setting a special
+         * category disables income/zip targeting on Meta.
+         *
+         */
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
         /**
          * Required for lifetime budgets
          */
@@ -15480,6 +16110,249 @@ export type CreateStandaloneAdError = (unknown | {
     error?: string;
 });
 
+export type ListLeadsData = {
+    query?: {
+        /**
+         * Filter to a single connected account.
+         */
+        accountId?: string;
+        /**
+         * Keyset cursor from a previous response's pagination.cursor.
+         */
+        cursor?: string;
+        /**
+         * Filter to a single lead form.
+         */
+        formId?: string;
+        limit?: number;
+        /**
+         * Unix seconds; only leads created at/after this Meta timestamp.
+         */
+        since?: number;
+    };
+};
+
+export type ListLeadsResponse = ({
+    status?: string;
+    leads?: Array<{
+        /**
+         * Zernio lead id.
+         */
+        id?: string;
+        /**
+         * Meta lead id.
+         */
+        leadgenId?: string;
+        formId?: string;
+        formName?: (string) | null;
+        accountId?: string;
+        adId?: (string) | null;
+        adsetId?: (string) | null;
+        campaignId?: (string) | null;
+        isOrganic?: boolean;
+        /**
+         * ISO 8601.
+         */
+        createdTime?: (string) | null;
+        /**
+         * Question key → answer.
+         */
+        fields?: {
+            [key: string]: (string);
+        };
+        /**
+         * Raw Meta field_data.
+         */
+        fieldData?: Array<{
+            [key: string]: unknown;
+        }>;
+    }>;
+    pagination?: {
+        hasMore?: boolean;
+        cursor?: (string) | null;
+    };
+});
+
+export type ListLeadsError = ({
+    error?: string;
+} | unknown);
+
+export type ListLeadFormsData = {
+    query: {
+        /**
+         * Connected facebook account id.
+         */
+        accountId: string;
+        cursor?: string;
+        limit?: number;
+    };
+};
+
+export type ListLeadFormsResponse = ({
+    status?: string;
+    forms?: Array<{
+        [key: string]: unknown;
+    }>;
+    pagination?: {
+        hasMore?: boolean;
+        cursor?: (string) | null;
+    };
+});
+
+export type ListLeadFormsError = ({
+    error?: string;
+} | unknown);
+
+export type CreateLeadFormData = {
+    body: {
+        accountId: string;
+        name: string;
+        questions: Array<{
+            /**
+             * EMAIL, PHONE, FULL_NAME, FIRST_NAME, LAST_NAME, CUSTOM, …
+             */
+            type: string;
+            /**
+             * CUSTOM questions only.
+             */
+            key?: string;
+            /**
+             * CUSTOM questions only.
+             */
+            label?: string;
+            options?: Array<{
+                key?: string;
+                value?: string;
+            }>;
+            inline_context?: string;
+        }>;
+        privacyPolicyUrl: string;
+        privacyPolicyLinkText?: string;
+        followUpActionUrl?: string;
+        locale?: string;
+        thankYouTitle?: string;
+        thankYouBody?: string;
+        thankYouButtonText?: string;
+        thankYouButtonType?: string;
+        thankYouWebsiteUrl?: string;
+        isOptimizedForQuality?: boolean;
+    };
+};
+
+export type CreateLeadFormResponse = ({
+    status?: string;
+    form?: {
+        id?: string;
+        name?: string;
+    };
+});
+
+export type CreateLeadFormError = ({
+    error?: string;
+} | unknown);
+
+export type GetLeadFormData = {
+    path: {
+        formId: string;
+    };
+    query: {
+        accountId: string;
+    };
+};
+
+export type GetLeadFormResponse = ({
+    status?: string;
+    form?: {
+        [key: string]: unknown;
+    };
+});
+
+export type GetLeadFormError = ({
+    error?: string;
+});
+
+export type ArchiveLeadFormData = {
+    path: {
+        formId: string;
+    };
+    query: {
+        accountId: string;
+    };
+};
+
+export type ArchiveLeadFormResponse = ({
+    status?: string;
+    formId?: string;
+    archived?: boolean;
+});
+
+export type ArchiveLeadFormError = ({
+    error?: string;
+});
+
+export type ListFormLeadsData = {
+    path: {
+        formId: string;
+    };
+    query: {
+        accountId: string;
+        cursor?: string;
+        limit?: number;
+        /**
+         * Unix seconds.
+         */
+        since?: number;
+    };
+};
+
+export type ListFormLeadsResponse = ({
+    status?: string;
+    leads?: Array<{
+        id?: string;
+        createdTime?: (string) | null;
+        adId?: (string) | null;
+        formId?: string;
+        fields?: {
+            [key: string]: (string);
+        };
+        fieldData?: Array<{
+            [key: string]: unknown;
+        }>;
+    }>;
+    pagination?: {
+        hasMore?: boolean;
+        cursor?: (string) | null;
+    };
+});
+
+export type ListFormLeadsError = ({
+    error?: string;
+});
+
+export type CreateTestLeadData = {
+    body: {
+        accountId: string;
+        fieldData: Array<{
+            name: string;
+            values: Array<(string)>;
+        }>;
+    };
+    path: {
+        formId: string;
+    };
+};
+
+export type CreateTestLeadResponse = ({
+    status?: string;
+    testLead?: {
+        id?: string;
+    };
+});
+
+export type CreateTestLeadError = ({
+    error?: string;
+});
+
 export type SearchAdInterestsData = {
     query: {
         /**
@@ -15505,58 +16378,112 @@ export type SearchAdInterestsError = ({
     error?: string;
 } | unknown);
 
-export type SearchAdTargetingLocationsData = {
+export type SearchAdTargetingData = {
     query: {
         /**
-         * Social account ID (must be a connected Facebook or Instagram account).
+         * Social account ID (a connected account on the target ad platform).
          */
         accountId: string;
         /**
-         * ISO 3166-1 alpha-2 country code (e.g. NL) to scope the search.
+         * ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
          */
         countryCode?: string;
+        /**
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options. Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         */
+        dimension?: 'geo' | 'interest' | 'behavior' | 'income';
+        /**
+         * Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`.
+         */
+        geoType?: 'country' | 'region' | 'city' | 'zip' | 'metro';
         /**
          * Maximum results to return.
          */
         limit?: number;
         /**
-         * Location name. Locality only — no region/country suffix.
+         * Search query. For geo, the locality name only (no region/country suffix).
          */
         q: string;
-        /**
-         * Type of location to search. Defaults to city.
-         */
-        type?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'zip' | 'metro_area' | 'geo_market';
     };
 };
 
-export type SearchAdTargetingLocationsResponse = ({
+export type SearchAdTargetingResponse = ({
     results?: Array<{
         /**
-         * Meta's opaque location ID. Use this in targeting.cities[].key / regions[].key.
+         * The platform's opaque id. Use as a geo `key` (regions/cities/zips/metros) or an entity `id` (interests/behaviors) in TargetingSpec.
+         */
+        id: string;
+        /**
+         * Human-readable label.
          */
-        key: string;
         name: string;
         /**
-         * Location type as returned by Meta (city, region, country, etc.).
+         * What the result is (e.g. city, region, country, zip, metro, interest, behavior, income).
          */
         type: string;
-        countryCode?: string;
-        countryName?: string;
         /**
-         * Parent region/state name (cities only).
+         * Optional breadcrumb of parent labels (e.g. ['United States', 'California', 'Los Angeles']). Disambiguates same-named results.
          */
-        region?: string;
+        path?: Array<(string)>;
         /**
-         * Parent region ID (cities only).
+         * Optional estimated reachable users for this option, when the platform returns it.
          */
-        regionId?: (string | number);
-        supportsRegion?: boolean;
-        supportsCity?: boolean;
+        audienceSize?: (number) | null;
     }>;
 });
 
-export type SearchAdTargetingLocationsError = (unknown | {
+export type SearchAdTargetingError = (unknown | {
+    error?: string;
+});
+
+export type EstimateAdReachData = {
+    body: {
+        /**
+         * Social account ID on the target ad platform.
+         */
+        accountId: string;
+        /**
+         * The targeting spec to estimate. Same shape used by POST /v1/ads/create.
+         */
+        spec: (TargetingSpec);
+        /**
+         * Optional. The optimization goal the estimate should assume (platform's
+         * own vocabulary, e.g. Meta `REACH`, `LINK_CLICKS`, `OFFSITE_CONVERSIONS`).
+         * Some platforms vary the estimate by goal; omit to use the platform default.
+         *
+         */
+        optimizationGoal?: string;
+    };
+};
+
+export type EstimateAdReachResponse = ({
+    /**
+     * Whether a pre-flight estimate is available on this platform. False for Google and TikTok.
+     */
+    available: boolean;
+    /**
+     * Lower bound of the estimated reachable audience. Present only when available.
+     */
+    lower?: (number) | null;
+    /**
+     * Upper bound of the estimated reachable audience. Present only when available.
+     */
+    upper?: (number) | null;
+    /**
+     * Optional estimated daily reach/results at the given budget, when the platform returns it.
+     */
+    daily?: (number) | null;
+    /**
+     * Currency of any monetary fields in the estimate, when applicable.
+     */
+    currency?: (string) | null;
+    /**
+     * Meta only. False when Meta is still computing the estimate (the audience is too new); retry shortly.
+     */
+    estimateReady?: (boolean) | null;
+});
+
+export type EstimateAdReachError = (unknown | {
     error?: string;
 });
 
@@ -15570,7 +16497,11 @@ export type ListAdAudiencesData = {
          * Platform ad account ID
          */
         adAccountId: string;
-        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'pinterest';
+        platform?: 'facebook' | 'instagram' | 'googleads' | 'tiktok' | 'tiktokads' | 'pinterest' | 'linkedin' | 'linkedinads' | 'twitter' | 'xads';
+        /**
+         * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences (each item carries a `spec`); the other types return uploaded/derived audiences.
+         */
+        type?: 'customer_list' | 'website' | 'lookalike' | 'saved_targeting';
     };
 };
 
@@ -15580,7 +16511,11 @@ export type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'website' | 'lookalike';
+        type?: 'customer_list' | 'website' | 'lookalike' | 'saved_targeting';
+        /**
+         * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
+         */
+        spec?: ((TargetingSpec) | null);
         platform?: string;
         size?: number;
         status?: string;
@@ -15592,46 +16527,58 @@ export type ListAdAudiencesError = ({
 } | unknown);
 
 export type CreateAdAudienceData = {
-    body: {
-        accountId: string;
-        /**
-         * Must start with act_
-         */
-        adAccountId: string;
-        name: string;
-        description?: string;
-        type: 'customer_list' | 'website' | 'lookalike';
-        /**
-         * Required for website audiences
-         */
-        pixelId?: string;
-        /**
-         * Required for website audiences
-         */
-        retentionDays?: number;
-        /**
-         * Required for lookalike audiences
-         */
-        sourceAudienceId?: string;
-        /**
-         * 2-letter code, required for lookalike audiences
-         */
-        country?: string;
-        /**
-         * Required for lookalike audiences
-         */
-        ratio?: number;
-        /**
-         * Pixel event rule for website audiences (optional)
-         */
-        rule?: {
-            [key: string]: unknown;
-        };
-        /**
-         * Data source declaration for GDPR compliance (customer_list only)
-         */
-        customerFileSource?: string;
+    body: ({
+    accountId: string;
+    /**
+     * Platform ad account ID. Must start with act_ for Meta; bare platform id for others (Google customer id, X/TikTok/LinkedIn/Pinterest account id).
+     */
+    adAccountId: string;
+    name: string;
+    description?: string;
+    type: 'customer_list' | 'website' | 'lookalike';
+    /**
+     * Required for website audiences
+     */
+    pixelId?: string;
+    /**
+     * Required for website audiences
+     */
+    retentionDays?: number;
+    /**
+     * Required for lookalike audiences
+     */
+    sourceAudienceId?: string;
+    /**
+     * 2-letter code, required for lookalike audiences
+     */
+    country?: string;
+    /**
+     * Required for lookalike audiences
+     */
+    ratio?: number;
+    /**
+     * Pixel event rule for website audiences (optional)
+     */
+    rule?: {
+        [key: string]: unknown;
     };
+    /**
+     * Data source declaration for GDPR compliance (customer_list only)
+     */
+    customerFileSource?: string;
+} | {
+    type: 'saved_targeting';
+    /**
+     * Social account ID on the target ad platform.
+     */
+    accountId: string;
+    name: string;
+    description?: string;
+    /**
+     * The targeting spec to store.
+     */
+    spec: (TargetingSpec);
+});
 };
 
 export type CreateAdAudienceResponse = ({