@zernio/node 0.2.833 → 0.2.835

package/src/generated/types.gen.ts

@@ -115,6 +115,18 @@ export type Ad = {
     budget?: {
         amount?: number;
         type?: 'daily' | 'lifetime';
+        /**
+         * LinkedIn only. The parent campaign's `dailyBudget`. LinkedIn allows a daily AND a lifetime budget on the same campaign, which `amount`/`type` cannot express (daily wins there); read `daily` and `lifetime` to see both.
+         */
+        daily?: number;
+        /**
+         * LinkedIn only. The parent campaign's `totalBudget`, readable even when a daily budget is also set.
+         */
+        lifetime?: number;
+        /**
+         * LinkedIn only. The campaign's `pacingStrategy`: how fast LinkedIn may spend the budget. Typically LINEAR or ACCELERATED; the list is open.
+         */
+        pacing?: string;
     } | null;
     metrics?: (AdMetrics | null);
     platformAdId?: string;
@@ -124,7 +136,17 @@ export type Ad = {
     campaignName?: string;
     adSetName?: string;
     /**
-     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads.
+     * The platform's own campaign objective, verbatim, alongside the normalized `goal` it maps to.
+     * The mapping is many-to-one, so `goal` alone cannot be mapped back to it.
+     *
+     * - Meta: campaign `objective` (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC).
+     * - LinkedIn: campaign `objectiveType` (e.g. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS,
+     * VIDEO_VIEW, ENGAGEMENT, JOB_APPLICANT, WEBSITE_CONVERSION). The list is open, so treat an
+     * unrecognized value as valid rather than an error.
+     * - TikTok and Pinterest: their raw objective_type.
+     *
+     * Null on platforms that report none, and on LinkedIn ads not yet re-synced.
+     *
      */
     platformObjective?: (string) | null;
     /**
@@ -331,6 +353,10 @@ export type Ad = {
          * LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign.
          */
         isServing?: (boolean) | null;
+        /**
+         * LinkedIn only. The LinkedIn ad format, in LinkedIn's own vocabulary: STANDARD_UPDATE, SINGLE_VIDEO, CAROUSEL, NATIVE_DOCUMENT, EVENT, TEXT_AD, SPOTLIGHT, FOLLOW_COMPANY, JOBS, SPONSORED_INMAILS and others. On an ad Zernio created this is the format it was created as; on an ad synced from Campaign Manager it is the parent campaign's raw `format`, which is what LinkedIn actually enforces on its creatives. The list is open, so treat an unrecognized value as valid. Absent on LinkedIn ads not yet re-synced, and on every other platform.
+         */
+        adFormat?: (string) | null;
         /**
          * LinkedIn only. Why this specific creative is not being served. Empty when it is serving.
          * A superset of the ad-level `servingStatuses`: it repeats the inherited campaign, campaign
@@ -423,6 +449,24 @@ export type AdAnalyticsResponse = {
         daily?: Array<(AdMetrics & {
     date?: string;
 })>;
+        /**
+         * Requested demographic breakdowns, keyed by dimension. Fetched live from the
+         * platform per request and never stored, so these rows can carry fields the
+         * stored `summary` and `daily` series do not.
+         *
+         * LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where
+         * LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement
+         * figures, plus two reach fields:
+         *
+         * - `reach`: the segment's `approximateMemberReach`.
+         * - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of
+         * the targeted audience, passed through verbatim.
+         *
+         * LinkedIn withholds both below its audience privacy threshold, in which case the
+         * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
+         * is not part of the stored metrics series.
+         *
+         */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
@@ -616,7 +660,7 @@ export type AdEngagementCounts = {
      */
     pageLikes?: number;
     /**
-     * 3-second video views (`video_view`). For completion-based counts use `videoThruplayWatchedActions`.
+     * Video views, from the `video_view` action. Meta counts a 3-second view; LinkedIn's own `videoViews` threshold (2 continuous seconds, or 25% of the video) lands under the same key, so compare across platforms with care. For completion-based counts use `videoThruplayWatchedActions`.
      */
     videoViews?: number;
     /**
@@ -802,7 +846,7 @@ export type AdMetrics = {
     spend?: number;
     impressions?: number;
     /**
-     * Unique people reached in the requested date range. Meta (facebook/instagram) and TikTok: the platform's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient platform error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, reach is NOT additive on these platforms: neither daily values nor child nodes sum to the range total. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Frequency (impressions / reach) is only meaningful for Meta and TikTok.
+     * Unique people reached in the requested date range. Meta (facebook/instagram) and TikTok: the platform's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient platform error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, reach is NOT additive on these platforms: neither daily values nor child nodes sum to the range total. LinkedIn: the campaign's `approximateMemberReach`, de-duplicated by LinkedIn per day and then summed over the range here, so it overcounts members reached on more than one day; LinkedIn withholds it below its audience privacy threshold, where it reads 0. Google, X, Pinterest and OpenAI report 0 (reach not synced). Frequency (impressions / reach) is only meaningful for Meta and TikTok.
      */
     reach?: number;
     clicks?: number;
@@ -832,7 +876,7 @@ export type AdMetrics = {
      */
     costPerConversion?: number;
     /**
-     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...), covering both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share). Follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
+     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...), covering both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share). Follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen) plus `video_view`, which carries LinkedIn's `videoViews` under the same key every other platform uses, so it feeds `engagementBreakdown.videoViews` too; it is an engagement, NOT a conversion, and is excluded from `conversions`. Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
      */
     actions?: {
         [key: string]: (number);
@@ -1229,6 +1273,18 @@ export type AdTreeAdSet = {
     budget?: {
         amount?: number;
         type?: 'daily' | 'lifetime';
+        /**
+         * LinkedIn only. The campaign's `dailyBudget`. LinkedIn allows a daily AND a lifetime budget on the same campaign, which `amount`/`type` cannot express (daily wins there); read `daily` and `lifetime` to see both.
+         */
+        daily?: number;
+        /**
+         * LinkedIn only. The campaign's `totalBudget`, readable even when a daily budget is also set.
+         */
+        lifetime?: number;
+        /**
+         * LinkedIn only. The campaign's `pacingStrategy`: how fast LinkedIn may spend the budget. Typically LINEAR or ACCELERATED; the list is open.
+         */
+        pacing?: string;
     } | null;
     /**
      * Ad-set-level budget (ABO). Null for CBO campaigns where the budget is set on the campaign.
@@ -1236,6 +1292,18 @@ export type AdTreeAdSet = {
     adSetBudget?: {
         amount?: number;
         type?: 'daily' | 'lifetime';
+        /**
+         * LinkedIn only. See `budget.daily`.
+         */
+        daily?: number;
+        /**
+         * LinkedIn only. See `budget.lifetime`.
+         */
+        lifetime?: number;
+        /**
+         * LinkedIn only. See `budget.pacing`.
+         */
+        pacing?: string;
     } | null;
     metrics?: AdMetrics;
     /**
@@ -2590,6 +2658,24 @@ export type CampaignAnalyticsResponse = {
         daily?: Array<(AdMetrics & {
     date?: string;
 })>;
+        /**
+         * Requested demographic breakdowns, keyed by dimension. Fetched live from the
+         * platform per request and never stored, so these rows can carry fields the
+         * stored `summary` and `daily` series do not.
+         *
+         * LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where
+         * LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement
+         * figures, plus two reach fields:
+         *
+         * - `reach`: the segment's `approximateMemberReach`.
+         * - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of
+         * the targeted audience, passed through verbatim.
+         *
+         * LinkedIn withholds both below its audience privacy threshold, in which case the
+         * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
+         * is not part of the stored metrics series.
+         *
+         */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
@@ -4821,6 +4907,98 @@ export type GoogleStructuredSnippet = {
 
 export type header = 'Amenities' | 'Brands' | 'Courses' | 'Degree programs' | 'Destinations' | 'Featured hotels' | 'Insurance coverage' | 'Models' | 'Neighborhoods' | 'Service catalog' | 'Shows' | 'Styles' | 'Types';
 
+export type ImessageAudienceContact = {
+    conversationId?: string;
+    accountId?: string;
+    /**
+     * The contact handle (E.164 phone or email)
+     */
+    contact?: string;
+    name?: (string) | null;
+    subscribed?: boolean;
+    lastMessage?: (string) | null;
+    lastMessageAt?: (string) | null;
+    firstSeenAt?: (string) | null;
+    /**
+     * Present when the thread was opened through a tracked opt-in link
+     */
+    optIn?: {
+        at?: string;
+        parameters?: {
+            [key: string]: unknown;
+        };
+    } | null;
+};
+
+/**
+ * An iMessage sender registered as an account on a profile.
+ */
+export type ImessageSender = {
+    /**
+     * Account id (use it with the inbox endpoints' accountId)
+     */
+    id?: string;
+    platform?: 'imessage';
+    /**
+     * The sender handle (E.164 phone or email)
+     */
+    sender?: string;
+    /**
+     * imessage:// deep link that opens Messages on this sender with a prefilled text. Share it so contacts message you first (Apple only lets a sender reach contacts who wrote to it first).
+     */
+    optInLink?: (string) | null;
+    displayName?: string;
+    profileId?: (string) | null;
+    /**
+     * Delivery provider backing this sender (e.g. loopmessage)
+     */
+    provider?: string;
+    /**
+     * Whether the provider confirmed the sender as active at registration time
+     */
+    senderVerified?: boolean;
+    isActive?: boolean;
+};
+
+export type platform4 = 'imessage';
+
+/**
+ * A provisioned iMessage sender order and its lifecycle. Activation is asynchronous: poll GET /v1/imessage/senders/{senderId} or subscribe to account.connected.
+ */
+export type ImessageSenderLifecycle = {
+    id?: string;
+    kind?: 'phone' | 'email';
+    region?: ('US' | 'GB') | null;
+    /**
+     * The sender handle once activation assigns it
+     */
+    handle?: (string) | null;
+    /**
+     * imessage:// deep link that opens Messages on this sender with a prefilled text. Share it so contacts message you first (Apple only lets a sender reach contacts who wrote to it first); null until the handle is assigned.
+     */
+    optInLink?: (string) | null;
+    status?: 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
+    /**
+     * Monthly price billed while the sender is active
+     */
+    priceCents?: number;
+    provider?: string;
+    profileId?: string;
+    displayName?: (string) | null;
+    failureReason?: (string) | null;
+    /**
+     * The messaging account created at activation
+     */
+    accountId?: (string) | null;
+    createdAt?: string;
+};
+
+export type kind = 'phone' | 'email';
+
+export type region = 'US' | 'GB';
+
+export type status11 = 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
+
 /**
  * Attachment snapshot inside an edit-history entry.
  */
@@ -4891,7 +5069,7 @@ export type InboxWebhookConversation = {
     contactId?: string;
 };
 
-export type status11 = 'active' | 'archived';
+export type status12 = 'active' | 'archived';
 
 /**
  * The conversation object included in conversation lifecycle webhook payloads (conversation.started, conversation.control_changed).
@@ -4901,7 +5079,7 @@ export type InboxWebhookConversationDetail = {
      * The platform's conversation id, equal to `conversation.platformConversationId` on inbox webhooks (whose `conversation.id` is Zernio's internal id). Both are accepted by the conversation endpoints.
      */
     id: string;
-    platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok';
+    platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok' | 'imessage';
     /**
      * Same value as `id`.
      */
@@ -4929,7 +5107,7 @@ export type InboxWebhookConversationDetail = {
     contactId?: string;
 };
 
-export type platform4 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok';
+export type platform5 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok' | 'imessage';
 
 /**
  * The message object included in inbox webhook payloads.
@@ -5045,7 +5223,7 @@ export type InboxWebhookMessage = {
     isRead: boolean;
 };
 
-export type platform5 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms';
+export type platform6 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms';
 
 export type direction2 = 'incoming' | 'outgoing';
 
@@ -5173,7 +5351,7 @@ export type InstagramAccountInsightsResponse = {
 /**
  * Platform that served this response.
  */
-export type platform6 = 'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok';
+export type platform7 = 'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok';
 
 export type metricType = 'time_series' | 'total_value';
 
@@ -6428,7 +6606,7 @@ export type PlatformAnalytics = {
     errorMessage?: (string) | null;
 };
 
-export type status12 = 'published' | 'failed';
+export type status13 = 'published' | 'failed';
 
 /**
  * Sync state of analytics for this platform
@@ -6610,7 +6788,7 @@ export type Post = {
 /**
  * `cancelled` is set by DELETE /v1/posts/{postId}/unpublish once every platform entry has been removed from its platform (a post with published entries left becomes `partial`); cancelled posts can be edited and rescheduled like drafts.
  */
-export type status13 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'partial' | 'failed' | 'cancelled';
+export type status14 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'partial' | 'failed' | 'cancelled';
 
 export type visibility2 = 'public' | 'private' | 'unlisted';
 
@@ -6805,9 +6983,9 @@ export type Product = {
     publishedAt?: (string) | null;
 };
 
-export type platform7 = 'shopify';
+export type platform8 = 'shopify';
 
-export type status14 = 'active' | 'draft' | 'archived';
+export type status15 = 'active' | 'draft' | 'archived';
 
 export type ProductImage = {
     url?: string;
@@ -7227,7 +7405,7 @@ export type ReviewWebhookReview = {
 /**
  * Platform the review originated on. Currently Google Business Profile only.
  */
-export type platform8 = 'googlebusiness';
+export type platform9 = 'googlebusiness';
 
 /**
  * A Meta Reach & Frequency prediction. Money values in whole units of the ad account currency.
@@ -7404,7 +7582,7 @@ export type SocialAccount = {
     };
 };
 
-export type platform9 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
+export type platform10 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
 
 /**
  * Normalized, platform-agnostic ad-targeting spec. Every field is optional, an
@@ -7954,12 +8132,12 @@ export type TrackingTag = {
     ownerAdAccountId?: string;
 };
 
-export type platform10 = 'metaads';
+export type platform11 = 'metaads';
 
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
  */
-export type kind = 'pixel' | 'tag' | 'insight_tag';
+export type kind2 = 'pixel' | 'tag' | 'insight_tag';
 
 /**
  * X-specific post options. The article field creates a long-form X Article and is mutually exclusive with tweet media and tweet-only options. Geo-restriction applies at the media level: media is hidden outside the specified countries while tweet text remains visible.
@@ -8054,7 +8232,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status15 = 'pending' | 'completed' | 'expired';
+export type status16 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -8529,7 +8707,7 @@ export type Verification = {
     resend?: boolean;
 };
 
-export type status16 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+export type status17 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
 export type channel3 = 'sms';
 
@@ -8648,7 +8826,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status17 = 'success' | 'failed';
+export type status18 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -8760,7 +8938,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status18 = 'success' | 'failure';
+export type status19 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -9387,7 +9565,7 @@ export type WebhookPayloadComment = {
 
 export type event10 = 'comment.received';
 
-export type platform11 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'linkedin' | 'bluesky' | 'reddit' | 'tiktok';
+export type platform12 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'linkedin' | 'bluesky' | 'reddit' | 'tiktok';
 
 /**
  * WhatsApp only. Who answers a conversation changed: Meta Business Agent took it over,
@@ -9561,7 +9739,7 @@ export type WebhookPayloadLead = {
 
 export type event14 = 'lead.received';
 
-export type platform12 = 'facebook';
+export type platform13 = 'facebook';
 
 /**
  * Webhook payload for message received events
@@ -9581,7 +9759,7 @@ export type WebhookPayloadMessage = {
          * Internal conversation ID
          */
         conversationId: string;
-        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms' | 'twitter' | 'bluesky' | 'reddit' | 'slack' | 'tiktok';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms' | 'twitter' | 'bluesky' | 'reddit' | 'slack' | 'tiktok' | 'imessage';
         /**
          * Platform's message ID
          */
@@ -10249,7 +10427,7 @@ export type WebhookPayloadMessageSent = {
         /**
          * Every platform whose outgoing messages Zernio observes. sms is absent on purpose: its carrier receipts update delivery status and never raise message.sent.
          */
-        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack' | 'tiktok';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack' | 'tiktok' | 'imessage';
         /**
          * Platform's message ID
          */
@@ -10441,7 +10619,7 @@ export type event19 = 'message.sent';
 /**
  * Every platform whose outgoing messages Zernio observes. sms is absent on purpose: its carrier receipts update delivery status and never raise message.sent.
  */
-export type platform13 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack' | 'tiktok';
+export type platform14 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack' | 'tiktok' | 'imessage';
 
 /**
  * WhatsApp send origin. whatsapp_business_app when sent from the WhatsApp Business phone app on a Coexistence number; cloud_api when sent through Zernio (dashboard, API, or broadcasts); meta_business_agent when Meta Business Agent answered on the number. Absent on non-WhatsApp platforms. Says where WhatsApp saw the send come from, not which Zernio surface produced it: read sentVia for that.
@@ -10638,7 +10816,7 @@ export type event22 = 'post.platform.published' | 'post.platform.failed' | 'post
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status19 = 'published' | 'failed' | 'deleted';
+export type status20 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger)
@@ -10898,12 +11076,12 @@ export type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
 
 export type event28 = 'whatsapp.account.name_status_updated';
 
-export type platform14 = 'whatsapp';
+export type platform15 = 'whatsapp';
 
 /**
  * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
  */
-export type status20 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+export type status21 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
 
 /**
  * Webhook payload for the `whatsapp.template.category_updated` event.
@@ -11052,7 +11230,7 @@ export type event30 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status21 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status22 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -11206,7 +11384,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status22 = 'pending' | 'active';
+export type status23 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -11364,7 +11542,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 status23 = 'success' | 'failed' | 'pending';
+export type status24 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -21670,7 +21848,7 @@ export type ListInboxConversationsData = {
         /**
          * Filter by platform
          */
-        platform?: 'facebook' | 'instagram' | 'twitter' | 'bluesky' | 'reddit' | 'telegram' | 'whatsapp';
+        platform?: 'facebook' | 'instagram' | 'twitter' | 'bluesky' | 'reddit' | 'telegram' | 'whatsapp' | 'imessage';
         /**
          * Filter by profile ID
          */
@@ -21713,6 +21891,10 @@ export type ListInboxConversationsResponse = ({
          * WhatsApp only, present once Meta Business Agent has touched the thread. ai_agent: the agent answers and new inbound arrive flagged metadata.standby; app: you hold control; other: another partner app does. Change it with POST /v1/inbox/conversations/{conversationId}/thread-control.
          */
         threadControl?: 'app' | 'ai_agent' | 'other';
+        /**
+         * iMessage only, true for a group thread. Manage it through the /v1/imessage/groups/{conversationId} endpoints.
+         */
+        isGroup?: boolean;
         /**
          * Direct link to open the conversation on the platform (if available)
          */
@@ -22099,7 +22281,7 @@ export type SearchInboxConversationsData = {
         /**
          * Filter by platform (searchable platforms only)
          */
-        platform?: 'facebook' | 'instagram' | 'telegram' | 'whatsapp' | 'sms' | 'slack';
+        platform?: 'facebook' | 'instagram' | 'telegram' | 'whatsapp' | 'sms' | 'slack' | 'imessage';
         /**
          * Filter by profile ID
          */
@@ -22570,7 +22752,7 @@ export type SendInboxMessageData = {
          */
         category?: 'utility';
         /**
-         * WhatsApp only. Set false to send the message without a link-preview thumbnail for the first URL in the text. Defaults to true, which is how every WhatsApp text has been sent to date. Ignored on other platforms. Accepted on the JSON body only, not on multipart requests.
+         * WhatsApp and iMessage. Set false to send the message without a link-preview thumbnail (WhatsApp: the first URL; iMessage: every link renders as plain text). Defaults to true, which is how every WhatsApp text has been sent to date. Ignored on other platforms. Accepted on the JSON body only, not on multipart requests.
          */
         linkPreview?: boolean;
         /**
@@ -22590,6 +22772,22 @@ export type SendInboxMessageData = {
          *
          */
         voiceNote?: boolean;
+        /**
+         * iMessage only (JSON body only). Bold title line rendered above the message text. Rejected with 400 on other platforms; ignored on voice-message sends.
+         */
+        subject?: string;
+        /**
+         * iMessage only (JSON body only). Apple screen/bubble animation played when the message arrives. Rejected with 400 on other platforms.
+         */
+        effect?: 'slam' | 'loud' | 'gentle' | 'invisibleInk' | 'echo' | 'spotlight' | 'balloons' | 'confetti' | 'love' | 'lasers' | 'fireworks' | 'shootingStar' | 'celebration';
+        /**
+         * iMessage only (JSON body only). When `true`, attaches the sender's contact card (vCard) so the recipient can save the sender. Counts as message content on its own, so `message` becomes optional.
+         */
+        contactCard?: boolean;
+        /**
+         * iMessage only (JSON body only). Overrides the delivery channel for this one send; the provider otherwise picks it automatically. The sender must carry the matching add-on (SMS, RCS or WhatsApp), or the send fails. Not a default to set on every request. Rejected with 400 on other platforms.
+         */
+        channel?: 'imessage' | 'sms' | 'rcs' | 'whatsapp';
         /**
          * Quick reply buttons. Mutually exclusive with buttons. Max 13 items.
          */
@@ -23082,7 +23280,7 @@ export type SendInboxMessageData = {
          */
         replyTo?: string;
         /**
-         * WhatsApp-only. Send a location pin.
+         * WhatsApp and iMessage. Send a location pin (on iMessage it renders as a native map bubble).
          */
         location?: {
             /**
@@ -23293,7 +23491,7 @@ export type EditInboxMessageData = {
          */
         conversationId: string;
         /**
-         * The Telegram message ID to edit
+         * The platform message ID to edit (iMessage also accepts the Zernio message id)
          */
         messageId: string;
     };
@@ -26151,6 +26349,437 @@ export type DialVoiceWebCallError = ({
     error?: string;
 } | unknown);
 
+export type ListImessageSendersResponse = ({
+    senders?: Array<ImessageSender>;
+});
+
+export type ListImessageSendersError = ({
+    error?: string;
+} | unknown);
+
+export type RegisterImessageSenderData = {
+    body: {
+        /**
+         * Profile to attach the sender to
+         */
+        profileId: string;
+        /**
+         * The provider-provisioned sender handle: a phone number in international format (e.g. +18305551234) or an email address
+         */
+        sender: string;
+        displayName?: string;
+        /**
+         * Delivery provider. Defaults to the platform default.
+         */
+        provider?: 'loopmessage';
+    };
+};
+
+export type RegisterImessageSenderResponse = ({
+    success?: boolean;
+    account?: ImessageSender;
+});
+
+export type RegisterImessageSenderError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListImessageSenderOrdersData = {
+    query?: {
+        includeCanceled?: boolean;
+    };
+};
+
+export type ListImessageSenderOrdersResponse = ({
+    senders?: Array<ImessageSenderLifecycle>;
+});
+
+export type ListImessageSenderOrdersError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type OrderImessageSenderData = {
+    body: {
+        profileId: string;
+        kind: 'phone' | 'email';
+        /**
+         * Required for phone senders. Without availableNumberId the number is carrier-assigned in this region and revealed once the sender activates.
+         */
+        region?: 'US' | 'GB';
+        /**
+         * A number from GET /v1/imessage/senders/available-numbers. It is assigned and activated on order instead of waiting for provisioning. Phone senders only.
+         */
+        availableNumberId?: string;
+        /**
+         * US phone senders only. Preferred area for a carrier-assigned number (ignored with availableNumberId).
+         */
+        zipCode?: string;
+        /**
+         * Local part for email senders (required for kind: email)
+         */
+        emailName?: string;
+        /**
+         * Domain for email senders (required for kind: email)
+         */
+        emailDomain?: string;
+        displayName?: string;
+        /**
+         * Idempotency key for safe retries
+         */
+        purchaseIntentId?: string;
+        /**
+         * Contact card (vCard) attached to the sender, shown when recipients save it. Required before sending with contactCard.
+         */
+        contact?: {
+            firstName: string;
+            lastName?: string;
+            photoUrl?: string;
+        };
+    };
+};
+
+export type OrderImessageSenderResponse = ({
+    success?: boolean;
+    sender?: ImessageSenderLifecycle;
+});
+
+export type OrderImessageSenderError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type GetImessageSenderData = {
+    path: {
+        senderId: string;
+    };
+};
+
+export type GetImessageSenderResponse = ({
+    success?: boolean;
+    sender?: ImessageSenderLifecycle;
+    /**
+     * Provider platform health for this sender; null when the provider cannot report it.
+     */
+    health?: {
+        imessage?: 'active' | 'degradation' | 'outage';
+        whatsapp?: 'active' | 'degradation' | 'outage';
+    } | null;
+    /**
+     * Provider-hosted opt-in page for this sender (opens Messages on any Apple device); null until the sender is active or when the provider cannot report it.
+     */
+    imessageLink?: (string) | null;
+});
+
+export type GetImessageSenderError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateImessageSenderData = {
+    body: {
+        displayName?: string;
+        contact?: {
+            firstName: string;
+            lastName?: string;
+            /**
+             * Square image
+             */
+            photoUrl?: string;
+        };
+    };
+    path: {
+        senderId: string;
+    };
+};
+
+export type UpdateImessageSenderResponse = ({
+    success?: boolean;
+    sender?: ImessageSenderLifecycle;
+});
+
+export type UpdateImessageSenderError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CancelImessageSenderData = {
+    path: {
+        senderId: string;
+    };
+};
+
+export type CancelImessageSenderResponse = ({
+    success?: boolean;
+    sender?: ImessageSenderLifecycle;
+});
+
+export type CancelImessageSenderError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListImessageAudienceData = {
+    query?: {
+        /**
+         * Limit to one sender account
+         */
+        accountId?: string;
+        limit?: number;
+        /**
+         * Matches the contact handle or name
+         */
+        search?: string;
+        skip?: number;
+        status?: 'subscribed' | 'unsubscribed';
+    };
+};
+
+export type ListImessageAudienceResponse = ({
+    contacts?: Array<ImessageAudienceContact>;
+    total?: number;
+    limit?: number;
+    skip?: number;
+});
+
+export type ListImessageAudienceError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type SetImessageSubscriptionData = {
+    body: {
+        accountId: string;
+        conversationId: string;
+        subscribed: boolean;
+    };
+};
+
+export type SetImessageSubscriptionResponse = ({
+    success?: boolean;
+    conversationId?: string;
+    subscribed?: boolean;
+});
+
+export type SetImessageSubscriptionError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateImessageOptInLinkData = {
+    body: {
+        /**
+         * Prefilled message text. Must contain the literal `[opt-in-code]` placeholder, e.g. "Hi! My code is [opt-in-code]".
+         */
+        body: string;
+        /**
+         * Custom key/values (e.g. leadId, campaign) echoed back on the opt-in message.
+         */
+        parameters?: {
+            [key: string]: (string);
+        };
+        /**
+         * Your own code in place of the generated one (3-8 characters, no spaces or `#`, `!`, `-`). An unredeemed link lives 24 hours; re-issuing with the same code replaces it, and the earlier URL stops matching.
+         */
+        optInCode?: string;
+    };
+    path: {
+        senderId: string;
+    };
+};
+
+export type CreateImessageOptInLinkResponse = ({
+    success?: boolean;
+    link?: {
+        id?: string;
+        /**
+         * imessage:// deep link
+         */
+        imessage?: string;
+        /**
+         * sms: deep link for non-Apple devices
+         */
+        sms?: (string) | null;
+        whatsapp?: (string) | null;
+        /**
+         * Hosted landing URL that picks the right scheme for the device
+         */
+        url?: string;
+    };
+});
+
+export type CreateImessageOptInLinkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListImessageAvailableNumbersData = {
+    query?: {
+        region?: 'US' | 'GB';
+    };
+};
+
+export type ListImessageAvailableNumbersResponse = ({
+    numbers?: Array<{
+        /**
+         * Pass as availableNumberId when ordering
+         */
+        id?: string;
+        /**
+         * E.164
+         */
+        phone?: string;
+        region?: string;
+    }>;
+    region?: (string) | null;
+});
+
+export type ListImessageAvailableNumbersError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ReserveImessageAvailableNumberData = {
+    path: {
+        numberId: string;
+    };
+};
+
+export type ReserveImessageAvailableNumberResponse = ({
+    success?: boolean;
+    numberId?: string;
+    expiresInSeconds?: number;
+});
+
+export type ReserveImessageAvailableNumberError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateImessageGroupData = {
+    body: {
+        /**
+         * The iMessage account (sender) that opens the group
+         */
+        accountId: string;
+        /**
+         * Participant handles (E.164 phones or iMessage emails)
+         */
+        contacts: Array<(string)>;
+        /**
+         * The first message
+         */
+        text: string;
+        /**
+         * Group name (required for WhatsApp groups)
+         */
+        name?: string;
+        channel?: 'imessage' | 'sms' | 'rcs' | 'whatsapp';
+    };
+};
+
+export type CreateImessageGroupResponse = ({
+    success?: boolean;
+    /**
+     * The provider's request id (not the group id)
+     */
+    requestId?: string;
+});
+
+export type CreateImessageGroupError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type GetImessageGroupData = {
+    path: {
+        /**
+         * The inbox conversation id (or the provider group id)
+         */
+        conversationId: string;
+    };
+    query: {
+        accountId: string;
+    };
+};
+
+export type GetImessageGroupResponse = ({
+    success?: boolean;
+    conversationId?: string;
+    group?: {
+        /**
+         * Provider group id
+         */
+        id?: string;
+        name?: (string) | null;
+        participants?: Array<(string)>;
+        channel?: (string) | null;
+        createdAt?: (string) | null;
+    };
+});
+
+export type GetImessageGroupError = (unknown | {
+    error?: string;
+});
+
+export type UpdateImessageGroupData = {
+    body: {
+        accountId: string;
+        name?: string;
+        /**
+         * Public HTTPS image URL; empty string removes the photo
+         */
+        photoUrl?: string;
+    };
+    path: {
+        conversationId: string;
+    };
+};
+
+export type UpdateImessageGroupResponse = ({
+    success?: boolean;
+    conversationId?: string;
+});
+
+export type UpdateImessageGroupError = (unknown | {
+    error?: string;
+});
+
+export type AddImessageGroupParticipantData = {
+    body: {
+        accountId: string;
+        /**
+         * E.164 phone or iMessage email
+         */
+        contact: string;
+    };
+    path: {
+        conversationId: string;
+    };
+};
+
+export type AddImessageGroupParticipantResponse = ({
+    success?: boolean;
+    conversationId?: string;
+    contact?: string;
+});
+
+export type AddImessageGroupParticipantError = (unknown | {
+    error?: string;
+});
+
+export type RemoveImessageGroupParticipantData = {
+    path: {
+        conversationId: string;
+    };
+    query: {
+        accountId: string;
+        /**
+         * E.164 phone or iMessage email
+         */
+        contact: string;
+    };
+};
+
+export type RemoveImessageGroupParticipantResponse = ({
+    success?: boolean;
+    conversationId?: string;
+    contact?: string;
+});
+
+export type RemoveImessageGroupParticipantError = (unknown | {
+    error?: string;
+});
+
 export type SendSmsData = {
     body: {
         /**
@@ -27608,6 +28237,16 @@ export type ListPhoneNumbersResponse = ({
          */
         callingEnabled?: boolean;
     }>;
+    /**
+     * iMessage phone senders (see /v1/imessage/senders/order). Hosted
+     * by the iMessage provider, not on your Telnyx numbers: SMS and
+     * Calls can never be enabled on them, and they bill as iMessage
+     * senders. `handle` is null until the carrier assigns the number
+     * at activation. Included only on the default and `status=active`
+     * views.
+     *
+     */
+    imessage?: Array<ImessageSenderLifecycle>;
     /**
      * The shared WhatsApp sandbox (one Zernio-owned number, all users test
      * against it). Present when the sandbox is configured; null otherwise.
@@ -28092,6 +28731,16 @@ export type GetWhatsAppPhoneNumbersResponse = ({
          */
         callingEnabled?: boolean;
     }>;
+    /**
+     * iMessage phone senders (see /v1/imessage/senders/order). Hosted
+     * by the iMessage provider, not on your Telnyx numbers: SMS and
+     * Calls can never be enabled on them, and they bill as iMessage
+     * senders. `handle` is null until the carrier assigns the number
+     * at activation. Included only on the default and `status=active`
+     * views.
+     *
+     */
+    imessage?: Array<ImessageSenderLifecycle>;
     /**
      * The shared WhatsApp sandbox (one Zernio-owned number, all users test
      * against it). Present when the sandbox is configured; null otherwise.
@@ -31649,7 +32298,7 @@ export type CreateBroadcastData = {
     body: {
         profileId: string;
         accountId: string;
-        platform: 'instagram' | 'facebook' | 'telegram' | 'twitter' | 'bluesky' | 'reddit' | 'whatsapp' | 'sms' | 'slack';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'twitter' | 'bluesky' | 'reddit' | 'whatsapp' | 'sms' | 'slack' | 'imessage';
         name: string;
         description?: string;
         message?: {
@@ -34735,7 +35384,61 @@ export type ListAdSetsResponse = ({
         profileId?: string;
         currency?: (string) | null;
         budget?: {
-            [key: string]: unknown;
+            amount?: number;
+            type?: 'daily' | 'lifetime';
+            /**
+             * LinkedIn only. The campaign's `dailyBudget`. LinkedIn allows a daily AND a lifetime budget on the same campaign, which `amount`/`type` cannot express (daily wins there); read `daily` and `lifetime` to see both.
+             */
+            daily?: number;
+            /**
+             * LinkedIn only. The campaign's `totalBudget`, readable even when a daily budget is also set.
+             */
+            lifetime?: number;
+            /**
+             * LinkedIn only. The campaign's `pacingStrategy`: how fast LinkedIn may spend the budget. Typically LINEAR or ACCELERATED; the list is open.
+             */
+            pacing?: string;
+        } | null;
+        /**
+         * The ad set's own flight dates, as synced from the platform. On LinkedIn this is the campaign's `runSchedule`. Null when the platform reports none.
+         */
+        schedule?: {
+            startDate?: string;
+            /**
+             * Absent when the ad set runs until it is stopped.
+             */
+            endDate?: string;
+        } | null;
+        /**
+         * The audience this ad set delivers to, as the platform reports it. LinkedIn only
+         * today; null for every other platform and for LinkedIn ad sets not yet re-synced.
+         *
+         * `include` and `exclude` are the campaign's `targetingCriteria` verbatim, so they
+         * can be read, edited and sent back without reconstructing them from our normalized
+         * targeting spec. Exclusions were previously not readable at all.
+         *
+         */
+        targeting?: {
+            /**
+             * LinkedIn `targetingCriteria.include`, verbatim (an `and` of `or` facet clauses).
+             */
+            include?: {
+                [key: string]: unknown;
+            };
+            /**
+             * LinkedIn `targetingCriteria.exclude`, verbatim. Absent when the campaign excludes nothing.
+             */
+            exclude?: {
+                [key: string]: unknown;
+            };
+            /**
+             * LinkedIn audience expansion: whether LinkedIn may also serve to members similar to the criteria.
+             */
+            audienceExpansionEnabled?: boolean;
+            /**
+             * Whether the campaign may deliver on the LinkedIn Audience Network, off LinkedIn itself.
+             */
+            offsiteDeliveryEnabled?: boolean;
         } | null;
         isExternal?: (boolean) | null;
         platformCreatedAt?: (string) | null;
@@ -40898,6 +41601,10 @@ export type EstimateAdReachResponse = ({
      * Optional estimated daily reach/results at the given budget, when the platform returns it.
      */
     daily?: (number) | null;
+    /**
+     * LinkedIn only. LinkedIn's `audienceCounts.active`, verbatim: the active subset of the same audience `lower`/`upper` carry as its `total`. Absent when LinkedIn does not report it; `0` is a real answer, not a missing one.
+     */
+    active?: (number) | null;
     /**
      * Currency of any monetary fields in the estimate, when applicable.
      */