@zernio/node 0.2.612 → 0.2.641

package/src/generated/types.gen.ts

@@ -105,9 +105,9 @@ export type Ad = {
      */
     creativeType?: ('carousel' | 'video' | 'document' | 'image') | null;
     /**
-     * Available goals vary by platform. Meta (Facebook/Instagram) supports all 9 (incl. `lead_conversion` = website pixel lead optimization and `catalog_sales` = Advantage+ catalog ads). TikTok supports the 7 non-`lead_conversion` goals. LinkedIn supports all except app_promotion / lead_conversion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+     * Available goals vary by platform. Meta (Facebook/Instagram) supports all 10 (incl. `lead_conversion` = website pixel lead optimization, `catalog_sales` = Advantage+ catalog ads and `page_likes` = Page Likes conversion location under Engagement). TikTok supports engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion. LinkedIn supports all Meta goals except app_promotion / lead_conversion / catalog_sales / page_likes. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
      */
-    goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'job_applicants';
+    goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
     /**
      * True for ads synced from platform ad managers
      */
@@ -373,9 +373,9 @@ export type adType = 'boost' | 'standalone';
 export type creativeType = 'carousel' | 'video' | 'document' | 'image';
 
 /**
- * Available goals vary by platform. Meta (Facebook/Instagram) supports all 9 (incl. `lead_conversion` = website pixel lead optimization and `catalog_sales` = Advantage+ catalog ads). TikTok supports the 7 non-`lead_conversion` goals. LinkedIn supports all except app_promotion / lead_conversion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+ * Available goals vary by platform. Meta (Facebook/Instagram) supports all 10 (incl. `lead_conversion` = website pixel lead optimization, `catalog_sales` = Advantage+ catalog ads and `page_likes` = Page Likes conversion location under Engagement). TikTok supports engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion. LinkedIn supports all Meta goals except app_promotion / lead_conversion / catalog_sales / page_likes. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
  */
-export type goal = 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'job_applicants';
+export type goal = 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
 
 export type type = 'daily' | 'lifetime';
 
@@ -481,9 +481,9 @@ export type AdCampaign = {
      */
     platformObjective?: (string) | null;
     /**
-     * Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
+     * A single string when every ad set shares one optimization goal; a JSON array of the distinct goals when ad sets differ (never a comma-joined string); array element order is not guaranteed, treat it as an unordered set; the key is absent when no ad set carries a goal. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
      */
-    optimizationGoal?: (string) | null;
+    optimizationGoal?: Array<(string)>;
     /**
      * Campaign-level bid strategy. Ad sets inherit this unless they override.
      */
@@ -872,6 +872,10 @@ export type AdTreeAdSet = {
      * Derived from child ad statuses
      */
     status?: (AdStatus);
+    /**
+     * Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform — a proxy usable for sorting.
+     */
+    createdTime?: (string) | null;
     adCount?: number;
     /**
      * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
@@ -937,6 +941,10 @@ export type AdTreeCampaign = {
     platformCampaignId?: string;
     platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
     campaignName?: string;
+    /**
+     * Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced) — a campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting "most recently created" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`.
+     */
+    createdTime?: (string) | null;
     /**
      * Delivery status derived from child ad statuses. Distinct from `reviewStatus`, which reflects the platform-side review state.
      */
@@ -1009,9 +1017,9 @@ export type AdTreeCampaign = {
      */
     platformObjective?: (string) | null;
     /**
-     * Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
+     * A single string when every ad set shares one optimization goal; a JSON array of the distinct goals when ad sets differ (never a comma-joined string); array element order is not guaranteed, treat it as an unordered set; the key is absent when no ad set carries a goal. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
      */
-    optimizationGoal?: (string) | null;
+    optimizationGoal?: Array<(string)>;
     /**
      * Campaign-level bid strategy. Ad sets inherit this unless they override.
      */
@@ -2104,21 +2112,49 @@ export type CtwaAdRequestBody = {
      *
      */
     video?: {
-        url: string;
         /**
-         * Required by Meta for every video creative. Used as the
-         * ad thumbnail.
+         * Public URL of the video to upload. Provide either `url` or `id`.
+         */
+        url?: string;
+        /**
+         * Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`.
+         */
+        id?: string;
+        /**
+         * OPTIONAL: when omitted, the poster is auto-generated from
+         * Meta's own preferred video thumbnail. When Meta produces no
+         * candidate the request fails with a 502 platform_error
+         * (reason: video_thumbnail_unavailable) — retry, or supply
+         * this field to control the poster frame exactly.
          *
          */
-        thumbnailUrl: string;
+        thumbnailUrl?: string;
+    };
+    /**
+     * Custom chat welcome message (Meta's `page_welcome_message`,
+     * "Mensaje de bienvenida" / "Mensaje predefinido" in Ads Manager).
+     * Single-creative shape only; for `creatives[]` set it per entry.
+     *
+     */
+    welcomeMessage?: {
+        /**
+         * Greeting shown when the chat opens. Replaces Meta's default ("Hi! Can we help you?").
+         */
+        text: string;
+        /**
+         * Message put into the user's text input, ready to send. Replaces Meta's default ("Hi! I want more info."). Lets one ad steer the opening message toward what it promotes (e.g. a specific product).
+         */
+        prefillText: string;
     };
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
      * with the top-level single-creative fields (`headline` /
-     * `body` / `imageUrl` / `video`). Each entry must supply its
-     * own headline, body, and exactly one of `imageUrl` /
-     * `video`.
+     * `body` / `imageUrl` / `video`): setting both is a 400,
+     * unlike `POST /v1/ads/create` where the top-level fields
+     * are silently ignored in multi-creative mode. Each entry
+     * must supply its own headline, body, and exactly one of
+     * `imageUrl` / `video`.
      *
      */
     creatives?: Array<{
@@ -2139,22 +2175,44 @@ export type CtwaAdRequestBody = {
          *
          */
         video?: {
-            url: string;
             /**
-             * Required by Meta for every video creative. Used
-             * as the ad thumbnail.
+             * Public URL of the video to upload. Provide either `url` or `id`.
+             */
+            url?: string;
+            /**
+             * Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`.
+             */
+            id?: string;
+            /**
+             * OPTIONAL: when omitted, the poster is auto-generated
+             * from Meta's own preferred video thumbnail. When Meta
+             * produces no candidate the request fails with a 502
+             * platform_error (reason: video_thumbnail_unavailable).
              *
              */
-            thumbnailUrl: string;
+            thumbnailUrl?: string;
+        };
+        /**
+         * Custom chat welcome message for this entry. See the top-level `welcomeMessage` for the single-creative shape.
+         */
+        welcomeMessage?: {
+            /**
+             * Greeting shown when the chat opens. Replaces Meta's default.
+             */
+            text: string;
+            /**
+             * Message put into the user's text input, ready to send. Replaces Meta's default.
+             */
+            prefillText: string;
         };
     }>;
     /**
      * Attach the creatives to this EXISTING messaging ad set instead of
      * building a campaign, so the ad set keeps its learning phase. It then
      * owns budget, targeting and schedule, so `budgetAmount`, `budgetType`,
-     * `endDate`, `objective`, `countries`, `interests` and `audienceId` are
-     * rejected with a 400 alongside it. Its `destination_type` must match
-     * the ad's destination.
+     * `endDate`, `objective`, `countries`, `interests`, `audienceId` and
+     * `campaignStatus` are rejected with a 400 alongside it. Its
+     * `destination_type` must match the ad's destination.
      *
      */
     adSetId?: string;
@@ -2298,6 +2356,22 @@ export type CtwaAdRequestBody = {
      *
      */
     objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+    /**
+     * Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the
+     * newly created ad(s) after Meta accepts them.
+     *
+     */
+    status?: 'ACTIVE' | 'PAUSED';
+    /**
+     * Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults
+     * to `ACTIVE`. `PAUSED` holds activation at the campaign so it never
+     * spends before the advertiser reviews it, while the ad set and ad still
+     * switch on (one resume call brings the whole hierarchy live). Only
+     * meaningful when a new campaign is being created; rejected with a 400
+     * alongside `adSetId` (the attach shape reuses an existing campaign).
+     *
+     */
+    campaignStatus?: 'ACTIVE' | 'PAUSED';
     /**
      * Meta bid strategy applied to the shared ad set. Defaults to
      * `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted.
@@ -2363,6 +2437,24 @@ export type advantageAudience = 0 | 1;
  */
 export type objective = 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
 
+/**
+ * Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the
+ * newly created ad(s) after Meta accepts them.
+ *
+ */
+export type status4 = 'ACTIVE' | 'PAUSED';
+
+/**
+ * Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults
+ * to `ACTIVE`. `PAUSED` holds activation at the campaign so it never
+ * spends before the advertiser reviews it, while the ad set and ad still
+ * switch on (one resume call brings the whole hierarchy live). Only
+ * meaningful when a new campaign is being created; rejected with a 400
+ * alongside `adSetId` (the attach shape reuses an existing campaign).
+ *
+ */
+export type campaignStatus = 'ACTIVE' | 'PAUSED';
+
 /**
  * Meta bid strategy applied to the shared ad set. Defaults to
  * `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted.
@@ -2718,7 +2810,7 @@ export type privacy_level = 2;
 /**
  * 1=SCHEDULED, 2=ACTIVE, 3=COMPLETED, 4=CANCELED
  */
-export type status4 = 1 | 2 | 3 | 4;
+export type status5 = 1 | 2 | 3 | 4;
 
 /**
  * 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL
@@ -3420,7 +3512,7 @@ export type InboxWebhookConversation = {
     contactId?: string;
 };
 
-export type status5 = 'active' | 'archived';
+export type status6 = 'active' | 'archived';
 
 /**
  * The message object included in inbox webhook payloads.
@@ -3529,6 +3621,9 @@ export type InboxWebhookMessage = {
             isVerified?: (boolean) | null;
         };
     };
+    /**
+     * When the message was sent, as reported by the platform and passed through unmodified. Full ISO 8601 date-time: Instagram and Facebook carry millisecond precision, while some platforms (for example WhatsApp and Telegram) report whole seconds. Use this field as the chronological ordering key. If two messages share the same value, fetch the conversation messages with sortOrder=desc for the deterministic order.
+     */
     sentAt: string;
     isRead: boolean;
 };
@@ -4290,7 +4385,7 @@ export type LinkedInPlatformData = {
      */
     disableLinkPreview?: boolean;
     /**
-     * LinkedIn post link to repost (use the post's "Copy link to post" action), or a urn:li:share / urn:li:ugcPost / urn:li:groupPost URN. With content, the published post is a quote-reshare: your text is the commentary and the original is embedded underneath (LinkedIn's "repost with your thoughts"). Leave content empty (and omit customContent) to publish a plain repost with no text, LinkedIn's one-click "Repost". Mutually exclusive with media. Works on personal profiles and organization pages.
+     * LinkedIn post link to repost (use the post's "Copy link to post" action), or a urn:li:share / urn:li:ugcPost / urn:li:groupPost URN. The published post is always a reshare authored by your account with the original embedded underneath: with content your text is the commentary (LinkedIn's "repost with your thoughts"), and with no content it publishes as a text-free reshare. Note that a text-free reshare is NOT LinkedIn's one-click "Repost" (the feed treatment where the original author stays the author); LinkedIn's API exposes no way to create that, so the post still appears authored by you with the original embedded. Mutually exclusive with media. Works on personal profiles and organization pages.
      */
     reshareUrl?: string;
     geoRestriction?: GeoRestriction;
@@ -4463,7 +4558,7 @@ export type PlatformAnalytics = {
     errorMessage?: (string) | null;
 };
 
-export type status6 = 'published' | 'failed';
+export type status7 = 'published' | 'failed';
 
 /**
  * Sync state of analytics for this platform
@@ -4590,7 +4685,7 @@ export type Post = {
     updatedAt?: string;
 };
 
-export type status7 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+export type status8 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
 
 export type visibility = 'public' | 'private' | 'unlisted';
 
@@ -5735,7 +5830,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status8 = 'pending' | 'completed' | 'expired';
+export type status9 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -5743,7 +5838,7 @@ export type UploadTokenStatusResponse = {
     files?: Array<UploadedFile>;
     createdAt?: string;
     expiresAt?: string;
-    completedAt?: string;
+    completedAt?: (string) | null;
 };
 
 /**
@@ -6156,7 +6251,7 @@ export type Verification = {
     resend?: boolean;
 };
 
-export type status9 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+export type status10 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
 export type channel2 = 'sms';
 
@@ -6183,7 +6278,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' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
+    events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -6275,7 +6370,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status10 = 'success' | 'failed';
+export type status11 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -6387,7 +6482,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status11 = 'success' | 'failure';
+export type status12 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -6906,7 +7001,7 @@ export type WebhookPayloadComment = {
          */
         imageUrl: (string) | null;
         /**
-         * Public URL of the post. Null for posts published through Zernio that were never re-synced.
+         * Public URL of the post. Null when no URL was ever stored for it, for example a platform draft or a post recovered without one.
          */
         permalink: (string) | null;
     };
@@ -7217,6 +7312,9 @@ export type WebhookPayloadMessage = {
                 isVerified?: (boolean) | null;
             };
         };
+        /**
+         * When the message was sent, as reported by the platform and passed through unmodified. Full ISO 8601 date-time: Instagram and Facebook carry millisecond precision, while some platforms (for example WhatsApp and Telegram) report whole seconds. Use this field as the chronological ordering key. If two messages share the same value, fetch the conversation messages with sortOrder=desc for the deterministic order.
+         */
         sentAt: string;
         isRead: boolean;
     };
@@ -7253,7 +7351,8 @@ export type WebhookPayloadMessage = {
         /**
          * WhatsApp only. Which kind of interactive reply the user sent:
          * `button_reply` (tap on an interactive button), `list_reply` (tap on a
-         * list row), or `nfm_reply` (a WhatsApp Flow submission).
+         * list row), or `nfm_reply` (a WhatsApp Flow submission or an
+         * `address_message` submission, see `nfmReplyName`).
          *
          */
         interactiveType?: 'button_reply' | 'list_reply' | 'nfm_reply';
@@ -7280,12 +7379,23 @@ export type WebhookPayloadMessage = {
         /**
          * WhatsApp only. Parsed Flow response JSON. Populated when
          * `flowResponseJson` is valid JSON; otherwise omitted. Keys and
-         * value types depend on the specific Flow that was submitted.
+         * value types depend on the specific Flow that was submitted. An
+         * `address_message` submission (`nfmReplyName: address_message`) carries
+         * the address fields (`name`, `address`, `city`, `state`, `in_pin_code`,
+         * ...), either at the top level or nested under `values`; read both.
          *
          */
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. `nfm_reply.name` as Meta sent it, e.g. `flow` or
+         * `address_message`. Address submissions share the `nfm_reply`
+         * envelope with Flow submissions and are otherwise indistinguishable
+         * in `flowResponseData`; use this field to tell them apart.
+         *
+         */
+        nfmReplyName?: string;
         /**
          * WhatsApp only. Cart submitted by the user from a commerce message
          * (catalog, product, or product-list message). Meta's `order` object
@@ -7511,7 +7621,8 @@ export type event13 = 'message.received';
 /**
  * WhatsApp only. Which kind of interactive reply the user sent:
  * `button_reply` (tap on an interactive button), `list_reply` (tap on a
- * list row), or `nfm_reply` (a WhatsApp Flow submission).
+ * list row), or `nfm_reply` (a WhatsApp Flow submission or an
+ * `address_message` submission, see `nfmReplyName`).
  *
  */
 export type interactiveType = 'button_reply' | 'list_reply' | 'nfm_reply';
@@ -7697,6 +7808,9 @@ export type WebhookPayloadMessageSent = {
             username?: string;
             picture?: string;
         };
+        /**
+         * When the message was sent, as reported by the platform and passed through unmodified. Full ISO 8601 date-time: Instagram and Facebook carry millisecond precision, while some platforms (for example WhatsApp and Telegram) report whole seconds. Use this field as the chronological ordering key. If two messages share the same value, fetch the conversation messages with sortOrder=desc for the deterministic order.
+         */
         sentAt: string;
         isRead: boolean;
         /**
@@ -7864,7 +7978,7 @@ export type event19 = 'post.platform.published' | 'post.platform.failed' | 'post
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status12 = 'published' | 'failed' | 'deleted';
+export type status13 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger)
@@ -8073,6 +8187,62 @@ export type WebhookPayloadTest = {
 
 export type event24 = 'webhook.test';
 
+/**
+ * Webhook payload for the `whatsapp.account.name_status_updated` event.
+ * Fired when Meta finishes reviewing a WhatsApp display-name change on a
+ * connected number. Maps Meta's `phone_number_name_update` WABA webhook
+ * field onto our event envelope. Fires only for a review outcome
+ * (APPROVED, DECLINED, PENDING_REVIEW); a name applied without review
+ * reports `name_status: AVAILABLE_WITHOUT_REVIEW` on the phone node
+ * instead, and Meta never sends this webhook field for that case.
+ *
+ */
+export type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
+    /**
+     * Stable webhook event ID
+     */
+    id: string;
+    event: 'whatsapp.account.name_status_updated';
+    account: {
+        accountId: string;
+        profileId: string;
+        platform: 'whatsapp';
+        username: string;
+        displayName?: string;
+    };
+    name: {
+        /**
+         * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
+         */
+        status: 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+        /**
+         * The display name Meta reviewed. Null if Meta did not send one.
+         */
+        requestedName: (string) | null;
+        /**
+         * Meta's free-form decline reason. Null on approval, or when Meta sends the literal string "NONE".
+         */
+        rejectionReason: (string) | null;
+        /**
+         * The phone number this review is for, as Meta reported it.
+         */
+        displayPhoneNumber: (string) | null;
+    };
+    /**
+     * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
+     */
+    timestamp: string;
+};
+
+export type event25 = 'whatsapp.account.name_status_updated';
+
+export type platform12 = 'whatsapp';
+
+/**
+ * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
+ */
+export type status14 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+
 /**
  * Webhook payload for the `whatsapp.template.category_updated` event.
  * Fired when Meta reclassifies a template's category attached to a
@@ -8135,9 +8305,7 @@ export type WebhookPayloadWhatsAppTemplateCategoryUpdated = {
     timestamp: string;
 };
 
-export type event25 = 'whatsapp.template.category_updated';
-
-export type platform12 = 'whatsapp';
+export type event26 = 'whatsapp.template.category_updated';
 
 /**
  * `scheduled` is Meta's 24h advance notice of an upcoming
@@ -8214,7 +8382,7 @@ export type WebhookPayloadWhatsAppTemplateStatusUpdated = {
     timestamp: string;
 };
 
-export type event26 = 'whatsapp.template.status_updated';
+export type event27 = 'whatsapp.template.status_updated';
 
 /**
  * New status. Forwarded verbatim from Meta's `event` field.
@@ -8222,7 +8390,7 @@ export type event26 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status13 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status15 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -8371,7 +8539,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status14 = 'pending' | 'active';
+export type status16 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -8490,7 +8658,7 @@ export type WorkflowExecutionEvent = {
 
 export type action2 = 'execution_started' | 'execution_completed' | 'execution_exited' | 'execution_paused' | 'execution_resumed' | 'node_started' | 'node_completed' | 'node_failed' | 'node_skipped';
 
-export type status15 = 'success' | 'failed' | 'pending';
+export type status17 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -10915,7 +11083,7 @@ export type CreatePostData = {
     body: {
         title?: string;
         /**
-         * Post caption/text. Optional when media is attached, all platforms have customContent, every platform entry is an X Article (platformSpecificData.article), or every platform entry is a LinkedIn plain repost (platformSpecificData.reshareUrl with no text). Required for other text-only posts.
+         * Post caption/text. Optional when media is attached, all platforms have customContent, every platform entry is an X Article (platformSpecificData.article), or every platform entry is a LinkedIn text-free reshare (platformSpecificData.reshareUrl with no text). Required for other text-only posts.
          */
         content?: string;
         mediaItems?: Array<MediaItem>;
@@ -11477,7 +11645,10 @@ export type GetProfileError = ({
 export type UpdateProfileData = {
     body: {
         name?: string;
-        description?: string;
+        /**
+         * Set to null to clear the description.
+         */
+        description?: (string) | null;
         color?: string;
         isDefault?: boolean;
     };
@@ -12263,7 +12434,12 @@ export type HandleOAuthCallbackData = {
         profileId: string;
     };
     path: {
-        platform: string;
+        /**
+         * Social platform to complete the connect for. Discord, Slack and Telegram are absent because they are
+         * served by their own dedicated routes, documented separately.
+         *
+         */
+        platform: 'instagram' | 'twitter' | 'threads' | 'linkedin' | 'youtube' | 'tiktok' | 'reddit' | 'pinterest';
     };
 };
 
@@ -12271,6 +12447,56 @@ export type HandleOAuthCallbackResponse = (unknown);
 
 export type HandleOAuthCallbackError = (unknown | {
     error?: string;
+} | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
 });
 
 export type ConnectAdsData = {
@@ -12333,7 +12559,17 @@ export type ConnectAdsData = {
          */
         profileId: string;
         /**
-         * Custom redirect URL after OAuth completes (same-token platforms only). Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path.
+         * Custom URL the browser is sent to once the OAuth flow finishes. Honored on
+         * every ads platform, including the separate-token (`tiktok`, `twitter`) and
+         * standalone (`googleads`) flows. Accepts an http(s) URL, a custom app scheme
+         * for mobile deeplinks (e.g. myapp://callback), or a relative path. On success
+         * `tiktok`, `twitter` and `googleads` land on the URL unchanged, while the
+         * same-token platforms (`facebook`, `instagram`, `linkedin`, `pinterest`)
+         * append `connected`, `profileId`, `accountId`, `username` and, on API-key
+         * calls, `connect_token`. On failure every platform appends error details,
+         * starting with `error` and `platform`. When omitted, the browser lands on
+         * the Zernio dashboard.
+         *
          */
         redirect_url?: string;
     };
@@ -14619,6 +14855,10 @@ export type ConnectWhatsAppCredentialsResponse = ({
      * Present when the account was created but Meta rejected the Cloud API registration. The number cannot send messages until this is resolved.
      */
     registrationWarning?: string;
+    /**
+     * Present when the WABA webhook subscription (with the Zernio override callback) succeeded. Explains the delivery cutover and warns against unsubscribing the app from the WABA afterward.
+     */
+    webhookNotice?: string;
     account?: {
         accountId?: string;
         platform?: 'whatsapp';
@@ -14634,7 +14874,15 @@ export type ConnectWhatsAppCredentialsResponse = ({
         /**
          * The connected phone number
          */
-        selectedPhoneNumber?: string;
+        phoneNumber?: string;
+        /**
+         * Meta-verified business name for the phone number
+         */
+        verifiedName?: string;
+        /**
+         * Meta quality rating for the phone number (e.g. GREEN, YELLOW, RED, UNKNOWN)
+         */
+        qualityRating?: string;
     };
 });
 
@@ -14763,6 +15011,232 @@ export type CompleteWhatsAppPhoneSelectionError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type ConnectWhatsAppEmbeddedSignupData = {
+    body: {
+        /**
+         * Authorization code from the WA_EMBEDDED_SIGNUP postMessage
+         */
+        code: string;
+        profileId: string;
+        /**
+         * WhatsApp Business Account id, when the SDK reported one
+         */
+        wabaId?: string;
+        phoneNumberId?: string;
+        /**
+         * Number is also live in the WhatsApp Business app
+         */
+        isCoexistence?: boolean;
+        /**
+         * Rejects the connect when Meta returns a different number
+         */
+        expectedPhoneNumber?: string;
+    };
+};
+
+export type ConnectWhatsAppEmbeddedSignupResponse = (unknown);
+
+export type ConnectWhatsAppEmbeddedSignupError = (ErrorResponse | {
+    error?: string;
+} | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+} | unknown);
+
+export type ConnectDiscordChannelData = {
+    body: {
+        /**
+         * Discord server (guild) the channel belongs to
+         */
+        guildId: string;
+        /**
+         * Text, announcement or forum channel to publish to
+         */
+        channelId: string;
+        /**
+         * Profile to connect the channel to
+         */
+        profileId: string;
+    };
+};
+
+export type ConnectDiscordChannelResponse = (unknown);
+
+export type ConnectDiscordChannelError = (ErrorResponse | {
+    error?: string;
+} | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+} | unknown);
+
+export type ConnectSlackChannelData = {
+    body: {
+        profileId: string;
+        /**
+         * Slack channel id, C... or G...
+         */
+        channelId: string;
+        /**
+         * Nonce from the OAuth redirect. Required unless accountId is sent.
+         */
+        pendingDataToken?: string;
+        /**
+         * Existing Slack account whose workspace token is reused. Required unless pendingDataToken is sent.
+         */
+        accountId?: string;
+    };
+};
+
+export type ConnectSlackChannelResponse = (unknown);
+
+export type ConnectSlackChannelError = (ErrorResponse | {
+    error?: string;
+} | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+} | unknown);
+
 export type GetTelegramConnectStatusData = {
     query: {
         /**
@@ -16949,7 +17423,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' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -17004,7 +17478,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' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -17514,6 +17988,13 @@ export type ListInboxConversationsResponse = ({
             retryAfter?: (number) | null;
         }>;
         lastUpdated?: string;
+        /**
+         * Connected accounts that were not queried: their platform does not support this feature, or the account is not enabled for it
+         */
+        accountsSkipped?: Array<{
+            accountId?: string;
+            platform?: string;
+        }>;
     };
 });
 
@@ -18229,8 +18710,7 @@ export type SendInboxMessageData = {
          * commerce messages (single product, product list, catalog, and
          * carousel). When set, takes priority over `buttons` and
          * `quickReplies`. The shape mirrors Meta's Cloud API `interactive`
-         * object verbatim, so any payload that works against Meta directly
-         * will also work here.
+         * object for the types in the enum below.
          *
          * Use `buttons` / `quickReplies` for simple button replies
          * (WhatsApp's `interactive.type: "button"`): the abstraction caps at
@@ -18276,6 +18756,18 @@ export type SendInboxMessageData = {
          * For `catalog_message`, `action` may also be omitted (we default it
          * to `{ "name": "catalog_message" }`).
          *
+         * For `address_message`, `parameters.country` is required (Meta
+         * rejects the whole send without it); everything else in
+         * `parameters` (`values`, `saved_addresses`, `validation_errors`)
+         * is forwarded to Meta as-is. This is Meta's native structured
+         * shipping-address capture, generally available in India as of
+         * 2026-08; check Meta's documentation for current country
+         * availability before relying on it elsewhere. The submitted
+         * address arrives as an `nfm_reply` on the `message.received`
+         * webhook, same as a Flow submission, but with
+         * `metadata.nfmReplyName` set to `address_message` so you can
+         * tell the two apart.
+         *
          * Tap events come back via the `message.received` webhook with
          * `metadata.interactiveType` set to `list_reply` or `nfm_reply`.
          * Carts submitted from commerce messages arrive as `metadata.order`;
@@ -18286,7 +18778,7 @@ export type SendInboxMessageData = {
             /**
              * Which interactive layout to render.
              */
-            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'request_contact_info' | 'voice_call' | 'product' | 'product_list' | 'catalog_message' | 'carousel';
+            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'request_contact_info' | 'voice_call' | 'product' | 'product_list' | 'catalog_message' | 'carousel' | 'address_message';
             /**
              * Optional header shown above the body. Required with
              * `type: "text"` for `product_list`; not allowed for `product`
@@ -18497,6 +18989,32 @@ export type SendInboxMessageData = {
         };
         [key: string]: unknown | number | string;
     }>;
+} | {
+    name: 'address_message';
+    parameters: {
+        /**
+         * ISO 3166-1 alpha-2 country code Meta should localize the address form for (e.g. IN). Required: Meta rejects the send without it.
+         */
+        country: string;
+        /**
+         * Optional pre-filled address field values.
+         */
+        values?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Optional list of the recipient's previously saved addresses to offer as quick picks.
+         */
+        saved_addresses?: Array<{
+            [key: string]: unknown;
+        }>;
+        /**
+         * Optional per-field error messages to show when re-prompting after a failed validation.
+         */
+        validation_errors?: {
+            [key: string]: (string);
+        };
+    };
 });
         };
         /**
@@ -19182,6 +19700,13 @@ export type ListInboxCommentsResponse = ({
             retryAfter?: (number) | null;
         }>;
         lastUpdated?: string;
+        /**
+         * Connected accounts that were not queried: their platform does not support this feature, or the account is not enabled for it
+         */
+        accountsSkipped?: Array<{
+            accountId?: string;
+            platform?: string;
+        }>;
     };
 });
 
@@ -20268,6 +20793,13 @@ export type ListInboxReviewsResponse = ({
             retryAfter?: (number) | null;
         }>;
         lastUpdated?: string;
+        /**
+         * Connected accounts that were not queried: their platform does not support this feature, or the account is not enabled for it
+         */
+        accountsSkipped?: Array<{
+            accountId?: string;
+            platform?: string;
+        }>;
     };
     summary?: {
         totalReviews?: number;
@@ -20487,6 +21019,9 @@ export type UpdateWhatsAppTemplateResponse = ({
     template?: {
         id?: string;
         name?: string;
+        /**
+         * Approval state read back from Meta after the update, normally PENDING. If the state cannot be read back, the last known status is returned instead.
+         */
         status?: string;
     };
 });
@@ -22492,6 +23027,10 @@ export type ListPhoneNumbersResponse = ({
          * False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them.
          */
         hostedByZernio?: boolean;
+        /**
+         * SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.
+         */
+        sipTrunkId?: (string) | null;
         profileId?: {
             [key: string]: unknown;
         };
@@ -22583,6 +23122,10 @@ export type GetPhoneNumberResponse = ({
          */
         regulatoryDeclineReason?: (string) | null;
         provisionedAt?: string;
+        /**
+         * SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.
+         */
+        sipTrunkId?: (string) | null;
     };
 });
 
@@ -22906,6 +23449,10 @@ export type GetWhatsAppPhoneNumbersResponse = ({
          * False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them.
          */
         hostedByZernio?: boolean;
+        /**
+         * SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.
+         */
+        sipTrunkId?: (string) | null;
         profileId?: {
             [key: string]: unknown;
         };
@@ -24455,6 +25002,191 @@ export type DisableVoiceOnNumberError = ({
     error?: string;
 } | unknown);
 
+export type CreateSipTrunkData = {
+    body: {
+        /**
+         * Display name for the trunk.
+         */
+        label: string;
+        /**
+         * Fully-qualified hostname inbound calls are delivered to (e.g. sip.rtc.elevenlabs.io, sip.retellai.com).
+         */
+        sipHost: string;
+        /**
+         * Defaults to 5061 for tls, 5060 otherwise.
+         */
+        sipPort?: number;
+        /**
+         * Signaling transport toward sipHost. Default tls (with SRTP media).
+         */
+        transport?: 'tls' | 'tcp' | 'udp';
+    };
+};
+
+export type CreateSipTrunkResponse = ({
+    id?: string;
+    label?: string;
+    sipHost?: string;
+    sipPort?: number;
+    transport?: 'tls' | 'tcp' | 'udp';
+    termination?: {
+        /**
+         * Telnyx termination host the platform dials for outbound (sip.telnyx.com).
+         */
+        uri?: string;
+        /**
+         * SIP digest username.
+         */
+        username?: string;
+    };
+    numbersAttached?: number;
+    createdAt?: (string) | null;
+    /**
+     * SIP digest password, shown only in this response.
+     */
+    digestPassword?: string;
+});
+
+export type CreateSipTrunkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListSipTrunksResponse = ({
+    trunks?: Array<{
+        id?: string;
+        label?: string;
+        sipHost?: string;
+        sipPort?: number;
+        transport?: 'tls' | 'tcp' | 'udp';
+        termination?: {
+            uri?: string;
+            username?: string;
+        };
+        numbersAttached?: number;
+        createdAt?: (string) | null;
+    }>;
+    /**
+     * Whether this workspace can create SIP trunks. Managing existing trunks always works.
+     */
+    enabled?: boolean;
+});
+
+export type ListSipTrunksError = ({
+    error?: string;
+});
+
+export type GetSipTrunkData = {
+    path: {
+        id: string;
+    };
+};
+
+export type GetSipTrunkResponse = ({
+    id?: string;
+    label?: string;
+    sipHost?: string;
+    sipPort?: number;
+    transport?: 'tls' | 'tcp' | 'udp';
+    termination?: {
+        uri?: string;
+        username?: string;
+    };
+    numbersAttached?: number;
+    createdAt?: (string) | null;
+    numbers?: Array<{
+        /**
+         * Phone number record ID.
+         */
+        id?: string;
+        phoneNumber?: string;
+    }>;
+});
+
+export type GetSipTrunkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type DeleteSipTrunkData = {
+    path: {
+        id: string;
+    };
+};
+
+export type DeleteSipTrunkResponse = ({
+    deleted?: boolean;
+});
+
+export type DeleteSipTrunkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type RotateSipTrunkCredentialsData = {
+    path: {
+        id: string;
+    };
+};
+
+export type RotateSipTrunkCredentialsResponse = ({
+    termination?: {
+        /**
+         * Telnyx termination host the platform dials for outbound (sip.telnyx.com).
+         */
+        uri?: string;
+        /**
+         * SIP digest username.
+         */
+        username?: string;
+    };
+    digestPassword?: string;
+});
+
+export type RotateSipTrunkCredentialsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type AttachNumberToSipTrunkData = {
+    body: {
+        /**
+         * SIP trunk ID (from POST /v1/phone-numbers/sip-trunks).
+         */
+        trunkId: string;
+    };
+    path: {
+        /**
+         * Phone number record ID (from GET /v1/phone-numbers).
+         */
+        id: string;
+    };
+};
+
+export type AttachNumberToSipTrunkResponse = ({
+    attached?: boolean;
+    phoneNumber?: string;
+    trunkId?: string;
+});
+
+export type AttachNumberToSipTrunkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type DetachNumberFromSipTrunkData = {
+    path: {
+        id: string;
+    };
+};
+
+export type DetachNumberFromSipTrunkResponse = ({
+    /**
+     * Always false after a successful detach.
+     */
+    attached?: boolean;
+    phoneNumber?: string;
+});
+
+export type DetachNumberFromSipTrunkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type EnableSmsOnNumberData = {
     path: {
         /**
@@ -24761,6 +25493,10 @@ export type GetWhatsAppPhoneNumberResponse = ({
          */
         regulatoryDeclineReason?: (string) | null;
         provisionedAt?: string;
+        /**
+         * SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.
+         */
+        sipTrunkId?: (string) | null;
     };
 });
 
@@ -25246,6 +25982,10 @@ export type CreateWhatsAppFlowData = {
          * When cloning, true keeps the clone in cloneFlowId's version lineage (auto-numbered next version); false/absent creates an independent flow. Ignored without cloneFlowId.
          */
         asVersion?: boolean;
+        /**
+         * HTTPS-only data exchange endpoint for the flow. Settable only while the flow is in DRAFT, and the flow's uploaded Flow JSON must declare data_api_version "3.0" for the endpoint to be used.
+         */
+        endpointUri?: string;
     };
 };
 
@@ -25323,6 +26063,10 @@ export type UpdateWhatsAppFlowData = {
          */
         name?: string;
         categories?: Array<('SIGN_UP' | 'SIGN_IN' | 'APPOINTMENT_BOOKING' | 'LEAD_GENERATION' | 'CONTACT_US' | 'CUSTOMER_SUPPORT' | 'SURVEY' | 'OTHER')>;
+        /**
+         * HTTPS-only data exchange endpoint for the flow. Settable only while the flow is in DRAFT, and the flow's uploaded Flow JSON must declare data_api_version "3.0" for the endpoint to be used.
+         */
+        endpointUri?: string;
     };
     path: {
         /**
@@ -26411,6 +27155,17 @@ export type ListBroadcastRecipientsResponse = ({
         skip?: number;
         hasMore?: boolean;
     };
+    /**
+     * Delivery totals across all recipients in the broadcast, independent of pagination and status filtering.
+     */
+    summary?: {
+        total?: number;
+        pending?: number;
+        sent?: number;
+        delivered?: number;
+        read?: number;
+        failed?: number;
+    };
 });
 
 export type ListBroadcastRecipientsError = (unknown | {
@@ -28238,7 +28993,7 @@ export type CreateAdCampaignData = {
         /**
          * Mapped to the ODAX objective (same mapping as POST /v1/ads/create).
          */
-        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'job_applicants' | 'conversions' | 'app_promotion' | 'catalog_sales';
+        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'job_applicants' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes';
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
         /**
          * Campaign-level (CBO) 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. Requires budgetType.
@@ -28831,7 +29586,7 @@ export type GetAdTreeData = {
          */
         accountId?: string;
         /**
-         * Platform ad account ID
+         * One or more platform ad account IDs to scope the tree to (agency profiles connect a whole Business Manager but a workspace usually cares about a subset). Comma-separate for multiple (`?adAccountId=act_1,act_2,act_3`); single value keeps its old shape. Max 50 accounts per request; the plural aliases `adAccountIds` and `platformAdAccountIds` are rejected with a 400 to stop them from silently returning the unfiltered fleet.
          */
         adAccountId?: string;
         /**
@@ -29211,6 +29966,50 @@ export type GetAdPreviewsError = (unknown | {
     error?: string;
 });
 
+export type GetAdMediaData = {
+    path: {
+        /**
+         * Zernio ad id (24-char hex) or platform ad id.
+         */
+        adId: string;
+    };
+};
+
+export type GetAdMediaResponse = ({
+    adId?: string;
+    /**
+     * 'facebook' or 'instagram' — only Meta is supported for now.
+     */
+    platform?: string;
+    media?: Array<{
+        type?: 'image' | 'video';
+        /**
+         * Direct file URL (signed; short-lived — see description).
+         */
+        url?: string;
+        /**
+         * Video poster URL (videos only).
+         */
+        thumbnailUrl?: string;
+        /**
+         * Meta video id (videos only), reusable as video.id on the create endpoints.
+         */
+        videoId?: string;
+        /**
+         * Video length in seconds (videos only).
+         */
+        length?: number;
+        /**
+         * 0-based position for carousel children or asset_feed_spec entries.
+         */
+        index?: number;
+    }>;
+});
+
+export type GetAdMediaError = (unknown | {
+    error?: string;
+});
+
 export type GenerateKeywordIdeasData = {
     body: {
         /**
@@ -31039,6 +31838,7 @@ export type CreateStandaloneAdData = {
          * - `lead_generation`: OUTCOME_LEADS with instant forms. Requires `leadGenFormId`. `promotedObject.pageId` is optional and auto-filled from the connected Page.
          * - `app_promotion`: requires `promotedObject.applicationId` and `promotedObject.objectStoreUrl`.
          * - `catalog_sales`: Advantage+ catalog ads, for example vehicle inventory. Requires `promotedObject.productSetId`, `promotedObject.pixelId` and `promotedObject.customEventType`. Builds a catalog TEMPLATE creative from the copy fields, which may carry template tags like {{product.name}} or {{vehicle.make}}. No imageUrl or video is sent; Meta renders the visuals per catalog item. Discover catalogs via GET /v1/ads/catalogs and product sets via GET /v1/ads/catalogs/{catalogId}/product-sets. Single shape only, no creatives[], adSetId, dynamicCreative or placementAssets.
+         * - `page_likes`: Page Likes conversion location under OUTCOME_ENGAGEMENT (destination_type ON_PAGE, optimization PAGE_LIKES). `promotedObject.pageId` is optional and auto-filled from the connected Page. The creative CTA is fixed to LIKE_PAGE targeting that Page; headline / body / linkUrl / callToAction / imageUrl / video are all optional (Meta derives the link and the Like button from the Page).
          *
          * **TikTok**
          * - `conversions`: website-conversion ad group. Requires `promotedObject.pixelId`, your TikTok Pixel ID. Accepts an optional `promotedObject.customEventType` with a TikTok optimization_event code your pixel tracks (newer pixels use e.g. SHOPPING for purchase events; legacy pixels use ON_WEB_ORDER, INITIATE_ORDER, ON_WEB_REGISTER or FORM). To inherit pixel and event from an existing ad group, pass `adSetId` instead.
@@ -31052,7 +31852,7 @@ export type CreateStandaloneAdData = {
          * - 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.
          *
          */
-        goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'job_applicants';
+        goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
         /**
          * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
@@ -31517,7 +32317,8 @@ export type CreateStandaloneAdData = {
          * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
          * you control the card order and per-card copy/link. Requires top-level `body`,
-         * `linkUrl` and `callToAction`.
+         * `linkUrl` and `callToAction`. Those become the ad's own Destination and
+         * button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own.
          * Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
          * `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
          * `catalog_sales`.
@@ -31711,6 +32512,34 @@ export type CreateStandaloneAdData = {
          * Google Search RSA only. Extra descriptions.
          */
         additionalDescriptions?: Array<(string)>;
+        /**
+         * Google Search only. Sitelink assets to create and attach at the campaign level.
+         * Each entry becomes an Asset (with sitelink_asset + Asset.final_urls) plus a
+         * CampaignAsset link (field_type SITELINK). Approval is async — Google reviews
+         * assets after creation; poll asset.policy_summary later to read the verdict.
+         * Google requires at least two sitelinks to surface them on an ad; four or more
+         * is Google's own recommendation for maximum visibility. The response's
+         * creative.sitelinks[] echoes each input plus its Google resourceName.
+         *
+         */
+        sitelinks?: Array<{
+            /**
+             * The clickable link text shown under the ad. 25-char cap comes from Google.
+             */
+            text: string;
+            /**
+             * Final URL the sitelink navigates to.
+             */
+            linkUrl: string;
+            /**
+             * First description line under the link text (optional). 35-char cap.
+             */
+            description1?: string;
+            /**
+             * Second description line (optional; usually paired with description1).
+             */
+            description2?: string;
+        }>;
         /**
          * Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests.
          */
@@ -32513,6 +33342,49 @@ export type ListAdImagesError = (unknown | {
     error?: string;
 });
 
+export type UploadAdVideoData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64.
+         */
+        videoUrl?: string;
+        /**
+         * Raw base64 video bytes, or a full data URL (the data:video/...;base64, prefix is stripped). Capped by Vercel's body limit (~4.5 MB payload). Provide exactly one of videoUrl or videoBase64.
+         */
+        videoBase64?: string;
+        /**
+         * Optional filename shown alongside the upload session. Applied only when uploading via videoBase64.
+         */
+        filename?: string;
+    };
+};
+
+export type UploadAdVideoResponse = ({
+    adAccountId?: string;
+    video?: {
+        /**
+         * Meta video id, reusable as video.id on POST /v1/ads/create and inside POST /v1/ads/preview creativeSpec.
+         */
+        id?: string;
+        /**
+         * Meta-hosted poster URL if available; null when Meta has not produced a poster yet.
+         */
+        thumbnailUrl?: (string) | null;
+    };
+});
+
+export type UploadAdVideoError = (unknown | {
+    error?: string;
+});
+
 export type ListAdVideosData = {
     query: {
         /**
@@ -32555,6 +33427,35 @@ export type ListAdVideosError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type DeleteAdVideoData = {
+    path: {
+        /**
+         * Meta ad video id (numeric).
+         */
+        videoId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>) that owns the video.
+         */
+        adAccountId: string;
+    };
+};
+
+export type DeleteAdVideoResponse = ({
+    adAccountId?: string;
+    videoId?: string;
+    success?: boolean;
+});
+
+export type DeleteAdVideoError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type SearchAdInterestsData = {
     query: {
         /**
@@ -33019,9 +33920,7 @@ export type CreateAdAudienceData = {
     /**
      * Required for meta_engagement audiences (Meta only): what people
      * engaged with. `page` = a Facebook Page, `instagram` = an IG
-     * professional account, `video` = a video. The source object must be
-     * eligible for engagement audiences or Meta rejects with subcode
-     * 1713151 ("Invalid Event Name"), surfaced verbatim.
+     * professional account, `video` = a video.
      *
      */
     engagementSource?: 'page' | 'instagram' | 'video';