@getlatedev/node 0.2.1088 → 0.2.1090

package/src/generated/types.gen.ts

@@ -4118,7 +4118,7 @@ export type CtwaAdRequestBody = {
          */
         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`.
+         * 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`. Meta: a video still processing is waited on for up to 30 s, then answered 409 `invalid_resource_state` (poll GET /v1/ads/videos/{videoId}).
          */
         id?: string;
         /**
@@ -4217,7 +4217,7 @@ export type CtwaAdRequestBody = {
              */
             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`.
+             * 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`. Meta: a video still processing is waited on for up to 30 s, then answered 409 `invalid_resource_state` (poll GET /v1/ads/videos/{videoId}).
              */
             id?: string;
             /**
@@ -11479,7 +11479,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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | '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.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
+    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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'ad.video.processed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -12010,6 +12010,72 @@ export type event6 = 'ad.status_changed';
  */
 export type level2 = 'CAMPAIGN' | 'AD_SET' | 'AD';
 
+/**
+ * Webhook payload for the `ad.video.processed` event. Fires once per
+ * `POST /v1/ads/videos` call made with `async: true`, when Meta finishes
+ * processing the video (Meta only).
+ *
+ */
+export type WebhookPayloadAdVideoProcessed = {
+    /**
+     * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery.
+     */
+    id: string;
+    event: 'ad.video.processed';
+    /**
+     * The connected ads account the video was uploaded with.
+     */
+    account: {
+        /**
+         * Internal Zernio account ID.
+         */
+        accountId: string;
+        /**
+         * Internal Zernio profile ID this account belongs to.
+         */
+        profileId: string;
+        /**
+         * Ads connection platform. Currently always `metaads`.
+         */
+        platform: string;
+        username: string;
+        displayName?: (string) | null;
+    };
+    video: {
+        /**
+         * Meta video id, as returned by the 202 upload response.
+         */
+        id: string;
+        /**
+         * Meta ad account id (act_<n>) the video was uploaded to.
+         */
+        platformAdAccountId: string;
+        /**
+         * `ready`: usable as `video.id` on the create endpoints. `error`: Meta could not process it; upload again.
+         */
+        status: 'ready' | 'error';
+        /**
+         * Meta's processing error when status is `error`, otherwise null.
+         */
+        error: (string) | null;
+        /**
+         * Meta's auto-generated poster when status is `ready` and Meta produced one, otherwise null.
+         */
+        thumbnailUrl: (string) | null;
+    };
+    /**
+     * UTC time at which Zernio generated this event.
+     */
+    timestamp: string;
+};
+
+export type event7 = 'ad.video.processed';
+
+/**
+ * `ready`: usable as `video.id` on the create endpoints. `error`: Meta could not process it; upload again.
+ */
+export type status32 = 'ready' | 'error';
+
 /**
  * Webhook payload for `analytics.synced`. Fired once per connected account each
  * time its analytics sync cycle completes successfully. Poll-driven (roughly
@@ -12081,7 +12147,7 @@ export type WebhookPayloadAnalyticsSynced = {
     timestamp: string;
 };
 
-export type event7 = 'analytics.synced';
+export type event8 = 'analytics.synced';
 
 export type WebhookPayloadApiChangelogPublished = {
     /**
@@ -12096,7 +12162,7 @@ export type WebhookPayloadApiChangelogPublished = {
     timestamp: string;
 };
 
-export type event8 = 'api.changelog.published';
+export type event9 = 'api.changelog.published';
 
 /**
  * Webhook payload for the `call.ended` event. Fires on call hangup
@@ -12166,7 +12232,7 @@ export type WebhookPayloadCallEnded = {
     timestamp: string;
 };
 
-export type event9 = 'call.ended';
+export type event10 = 'call.ended';
 
 /**
  * Webhook payload for the `call.failed` event. Fired when a call
@@ -12200,7 +12266,7 @@ export type WebhookPayloadCallFailed = {
     timestamp: string;
 };
 
-export type event10 = 'call.failed';
+export type event11 = 'call.failed';
 
 /**
  * Webhook payload for the `call.permission_request` event. Fires
@@ -12237,7 +12303,7 @@ export type WebhookPayloadCallPermissionRequest = {
     timestamp: string;
 };
 
-export type event11 = 'call.permission_request';
+export type event12 = 'call.permission_request';
 
 export type response = 'accept' | 'reject';
 
@@ -12291,7 +12357,7 @@ export type WebhookPayloadCallReceived = {
     timestamp: string;
 };
 
-export type event12 = 'call.received';
+export type event13 = 'call.received';
 
 /**
  * Webhook payload for comment received events (Instagram, Facebook, Threads, YouTube, LinkedIn, Bluesky, Reddit, TikTok). X/Twitter does NOT fire this event. TikTok events carry only the author id: the comment.update webhook has no username, picture or owner flag.
@@ -12447,7 +12513,7 @@ export type WebhookPayloadComment = {
     timestamp: string;
 };
 
-export type event13 = 'comment.received';
+export type event14 = 'comment.received';
 
 export type platform13 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'linkedin' | 'bluesky' | 'reddit' | 'tiktok';
 
@@ -12486,7 +12552,7 @@ export type WebhookPayloadCommerceProduct = {
     };
 };
 
-export type event14 = 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted';
+export type event15 = 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted';
 
 export type type16 = 'product';
 
@@ -12524,7 +12590,7 @@ export type WebhookPayloadConversationControlChanged = {
     timestamp: string;
 };
 
-export type event15 = 'conversation.control_changed';
+export type event16 = 'conversation.control_changed';
 
 /**
  * Who answers now. ai_agent: Meta Business Agent; app: you; other: another partner app on the number.
@@ -12561,7 +12627,7 @@ export type WebhookPayloadConversationStarted = {
     timestamp: string;
 };
 
-export type event16 = 'conversation.started';
+export type event17 = 'conversation.started';
 
 /**
  * Webhook payload for post.external.created / post.external.updated /
@@ -12593,7 +12659,7 @@ export type WebhookPayloadExternalPost = {
     timestamp: string;
 };
 
-export type event17 = 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
+export type event18 = 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
 
 /**
  * Webhook payload for lead.received events (Meta Lead Gen / Instant Forms).
@@ -12664,7 +12730,7 @@ export type WebhookPayloadLead = {
     timestamp: string;
 };
 
-export type event18 = 'lead.received';
+export type event19 = 'lead.received';
 
 export type platform14 = 'facebook';
 
@@ -13223,7 +13289,7 @@ export type WebhookPayloadMessage = {
     timestamp: string;
 };
 
-export type event19 = 'message.received';
+export type event20 = 'message.received';
 
 /**
  * Which Zernio surface produced the message. Always present and
@@ -13284,7 +13350,7 @@ export type WebhookPayloadMessageDeleted = {
     timestamp: string;
 };
 
-export type event20 = 'message.deleted';
+export type event21 = 'message.deleted';
 
 /**
  * Shared payload for message.delivered, message.read, message.played and
@@ -13347,7 +13413,7 @@ export type WebhookPayloadMessageDeliveryStatus = {
     timestamp: string;
 };
 
-export type event21 = 'message.delivered' | 'message.read' | 'message.played' | 'message.failed';
+export type event22 = 'message.delivered' | 'message.read' | 'message.played' | 'message.failed';
 
 /**
  * Webhook payload for message.edited events. Fires when the sender
@@ -13385,7 +13451,7 @@ export type WebhookPayloadMessageEdited = {
     timestamp: string;
 };
 
-export type event22 = 'message.edited';
+export type event23 = 'message.edited';
 
 /**
  * Webhook payload for message sent events (fired when a message is sent via the API, or from the WhatsApp Business app on Coexistence numbers)
@@ -13603,7 +13669,7 @@ export type WebhookPayloadMessageSent = {
     timestamp: string;
 };
 
-export type event23 = 'message.sent';
+export type event24 = '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.
@@ -13657,7 +13723,7 @@ export type WebhookPayloadPhoneNumberStockAvailable = {
     timestamp: string;
 };
 
-export type event24 = 'phone_number.stock_available';
+export type event25 = 'phone_number.stock_available';
 
 /**
  * Webhook payload for post events
@@ -13707,7 +13773,7 @@ export type WebhookPayloadPost = {
     timestamp: string;
 };
 
-export type event25 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
+export type event26 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
 
 /**
  * Webhook payload for the per-platform terminal events
@@ -13826,12 +13892,12 @@ export type WebhookPayloadPostPlatform = {
     timestamp: string;
 };
 
-export type event26 = 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
+export type event27 = 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
 
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status32 = 'published' | 'failed' | 'deleted';
+export type status33 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger, TikTok)
@@ -13886,7 +13952,7 @@ export type WebhookPayloadReaction = {
     timestamp: string;
 };
 
-export type event27 = 'reaction.received';
+export type event28 = 'reaction.received';
 
 export type action = 'added' | 'removed';
 
@@ -13960,7 +14026,7 @@ export type WebhookPayloadReferral = {
     timestamp: string;
 };
 
-export type event28 = 'referral.received';
+export type event29 = 'referral.received';
 
 /**
  * Webhook payload for the review.new event (new review posted on a connected account).
@@ -13987,7 +14053,7 @@ export type WebhookPayloadReviewNew = {
     timestamp: string;
 };
 
-export type event29 = 'review.new';
+export type event30 = 'review.new';
 
 /**
  * Webhook payload for the review.updated event. Fired when the reviewer edits their
@@ -14020,7 +14086,7 @@ export type WebhookPayloadReviewUpdated = {
     timestamp: string;
 };
 
-export type event30 = 'review.updated';
+export type event31 = 'review.updated';
 
 /**
  * Webhook payload for test deliveries
@@ -14041,7 +14107,7 @@ export type WebhookPayloadTest = {
     timestamp: string;
 };
 
-export type event31 = 'webhook.test';
+export type event32 = 'webhook.test';
 
 /**
  * Webhook payload for `whatsapp.account.alert_received`, forwarded from Meta's
@@ -14088,7 +14154,7 @@ export type WebhookPayloadWhatsAppAccountAlertReceived = {
     timestamp: string;
 };
 
-export type event32 = 'whatsapp.account.alert_received';
+export type event33 = 'whatsapp.account.alert_received';
 
 export type platform16 = 'whatsapp';
 
@@ -14139,12 +14205,12 @@ export type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
     timestamp: string;
 };
 
-export type event33 = 'whatsapp.account.name_status_updated';
+export type event34 = 'whatsapp.account.name_status_updated';
 
 /**
  * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
  */
-export type status33 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+export type status34 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
 
 /**
  * Webhook payload for `whatsapp.account.quality_updated`. Fired when a connected
@@ -14192,7 +14258,7 @@ export type WebhookPayloadWhatsAppAccountQualityUpdated = {
     timestamp: string;
 };
 
-export type event34 = 'whatsapp.account.quality_updated';
+export type event35 = 'whatsapp.account.quality_updated';
 
 /**
  * The Meta webhook field that reported the change.
@@ -14263,12 +14329,12 @@ export type WebhookPayloadWhatsAppAccountStatusUpdated = {
     timestamp: string;
 };
 
-export type event35 = 'whatsapp.account.status_updated';
+export type event36 = 'whatsapp.account.status_updated';
 
 /**
  * `active` only on a reinstatement (DISABLED_UPDATE with ban state REINSTATE).
  */
-export type status34 = 'restricted' | 'active';
+export type status35 = 'restricted' | 'active';
 
 /**
  * Webhook payload for the `whatsapp.contact.identity_changed` event. Fired when
@@ -14315,7 +14381,7 @@ export type WebhookPayloadWhatsAppContactIdentityChanged = {
     timestamp: string;
 };
 
-export type event36 = 'whatsapp.contact.identity_changed';
+export type event37 = 'whatsapp.contact.identity_changed';
 
 /**
  * Which Meta signal reported the change. `user_changed_number`: new phone number. `user_changed_user_id` and `user_id_update`: new BSUID.
@@ -14384,7 +14450,7 @@ export type WebhookPayloadWhatsAppTemplateCategoryUpdated = {
     timestamp: string;
 };
 
-export type event37 = 'whatsapp.template.category_updated';
+export type event38 = 'whatsapp.template.category_updated';
 
 /**
  * `scheduled` is Meta's 24h advance notice of an upcoming
@@ -14461,7 +14527,7 @@ export type WebhookPayloadWhatsAppTemplateStatusUpdated = {
     timestamp: string;
 };
 
-export type event38 = 'whatsapp.template.status_updated';
+export type event39 = 'whatsapp.template.status_updated';
 
 /**
  * New status. Forwarded verbatim from Meta's `event` field.
@@ -14469,7 +14535,7 @@ export type event38 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status35 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status36 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 /**
  * WhatsApp only. Meta's `conversation` object from the status webhook (the billing
@@ -14840,7 +14906,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 status36 = 'success' | 'failed' | 'pending';
+export type status37 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -25276,7 +25342,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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | '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.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
+        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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'ad.video.processed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -25342,7 +25408,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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | '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.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
+        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' | 'account.ads.sync_failed' | 'account.ads.sync_recovered' | 'analytics.synced' | 'message.received' | 'conversation.started' | 'conversation.control_changed' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.played' | 'message.failed' | 'reaction.received' | 'referral.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'ad.video.processed' | 'whatsapp.template.status_updated' | 'whatsapp.template.category_updated' | 'whatsapp.account.name_status_updated' | 'whatsapp.account.quality_updated' | 'whatsapp.account.status_updated' | 'whatsapp.account.alert_received' | 'whatsapp.contact.identity_changed' | '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' | 'phone_number.stock_available' | 'verification.approved' | 'verification.failed' | 'api.changelog.published' | 'sms.registration.action_required' | 'sms.registration.status_updated' | 'branded_calling.identity.status_updated' | 'branded_calling.identity.action_required' | 'branded_calling.number.status_updated' | 'rcs.agent.status_updated' | 'commerce.product.created' | 'commerce.product.updated' | 'commerce.product.deleted')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -39977,6 +40043,10 @@ export type ListAdSetsData = {
          * Account ID
          */
         accountId?: string;
+        /**
+         * Platform ad account id (Meta act_<n>). Lists every synced ad set of that ad account; no campaignId needed.
+         */
+        adAccountId?: string;
         /**
          * Platform ad set ID
          */
@@ -40035,12 +40105,14 @@ export type ListAdSetsResponse = ({
             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.
+         * The audience this ad set delivers to, as the platform reports it at the last sync.
+         * LinkedIn and Meta; null for every other platform and for 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.
+         * On Meta it is the ad set's `targeting` verbatim (snake_case: geo_locations,
+         * age_min, custom_audiences, flexible_spec, ...), so it can be read, edited and sent
+         * back as is. On LinkedIn `include` and `exclude` (below) are the campaign's
+         * `targetingCriteria` verbatim, without reconstructing them from our normalized
+         * targeting spec.
          *
          */
         targeting?: {
@@ -40064,6 +40136,7 @@ export type ListAdSetsResponse = ({
              * Whether the campaign may deliver on the LinkedIn Audience Network, off LinkedIn itself.
              */
             offsiteDeliveryEnabled?: boolean;
+            [key: string]: unknown | boolean;
         } | null;
         isExternal?: (boolean) | null;
         platformCreatedAt?: (string) | null;
@@ -40072,13 +40145,27 @@ export type ListAdSetsResponse = ({
          */
         statusReadAt?: (string) | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. The ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT). Absent on rows not read live and on other platforms.
+         * The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS). On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT).
          */
         optimizationGoal?: (string) | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. The ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
+         * The ad set's billing event as last synced, where the platform reports one. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
          */
         billingEvent?: (string) | null;
+        /**
+         * The bid strategy as last synced, in the platform's own enum (Meta `bid_strategy`, for example LOWEST_COST_WITHOUT_CAP, COST_CAP). On Meta under a campaign budget this is the campaign's strategy.
+         */
+        bidStrategy?: (string) | null;
+        /**
+         * Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none.
+         */
+        bidAmount?: (number) | null;
+        /**
+         * Meta only. The ad set's `promoted_object` verbatim (snake_case, for example pixel_id + custom_event_type, page_id, application_id), as last synced from its most recent ad. Null on other platforms and on an ad set with no ad yet; GET /v1/ads/accounts/live reads it live for every ad set.
+         */
+        promotedObject?: {
+            [key: string]: unknown;
+        } | null;
         /**
          * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
@@ -44400,6 +44487,184 @@ export type GetAdAccountFinanceResponse = ({
 
 export type GetAdAccountFinanceError = (unknown | ErrorResponse);
 
+export type GetAdAccountLiveEntitiesData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         */
+        after?: string;
+        /**
+         * Read only one level. Required with `after`. Both levels are read when omitted.
+         */
+        level?: 'campaign' | 'adSet';
+        /**
+         * Maximum rows per level in this response.
+         */
+        limit?: number;
+        /**
+         * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
+         * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
+         * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         */
+        status?: string;
+    };
+};
+
+export type GetAdAccountLiveEntitiesResponse = ({
+    accountId?: string;
+    adAccountId?: string;
+    platform?: 'facebook';
+    /**
+     * ISO 4217 code every budget and bid amount is expressed in.
+     */
+    currency?: string;
+    /**
+     * When Meta was read.
+     */
+    readAt?: string;
+    /**
+     * Absent when `level=adSet`.
+     */
+    campaigns?: Array<{
+        platformCampaignId?: string;
+        campaignName?: (string) | null;
+        /**
+         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         */
+        platformCampaignStatus?: (string) | null;
+        /**
+         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         */
+        configuredStatus?: (string) | null;
+        /**
+         * Zernio's normalized status (active, paused, ...), derived from `platformCampaignStatus`.
+         */
+        status?: string;
+        /**
+         * The campaign budget, same shape as the synced rows. Null when the budget lives on the ad sets.
+         */
+        budget?: {
+            amount?: number;
+            type?: 'daily' | 'lifetime';
+        } | null;
+        /**
+         * Meta `daily_budget` in whole units of `currency`.
+         */
+        dailyBudget?: (number) | null;
+        /**
+         * Meta `lifetime_budget` in whole units of `currency`.
+         */
+        lifetimeBudget?: (number) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         */
+        budgetRemaining?: (number) | null;
+        /**
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         */
+        spendCap?: (number) | null;
+        /**
+         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         */
+        bidStrategy?: (string) | null;
+    }>;
+    /**
+     * Absent when `level=campaign`.
+     */
+    adSets?: Array<{
+        platformAdSetId?: string;
+        adSetName?: (string) | null;
+        platformCampaignId?: (string) | null;
+        /**
+         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         */
+        platformAdSetStatus?: (string) | null;
+        /**
+         * Meta `status`: the ad set's own switch.
+         */
+        configuredStatus?: (string) | null;
+        /**
+         * Zernio's normalized status, derived from `platformAdSetStatus`.
+         */
+        status?: string;
+        /**
+         * The ad set budget, same shape as the synced rows. Null under a campaign budget.
+         */
+        budget?: {
+            amount?: number;
+            type?: 'daily' | 'lifetime';
+        } | null;
+        /**
+         * Meta `daily_budget` in whole units of `currency`.
+         */
+        dailyBudget?: (number) | null;
+        /**
+         * Meta `lifetime_budget` in whole units of `currency`.
+         */
+        lifetimeBudget?: (number) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         */
+        budgetRemaining?: (number) | null;
+        /**
+         * Meta `bid_strategy`.
+         */
+        bidStrategy?: (string) | null;
+        /**
+         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         */
+        bidAmount?: (number) | null;
+        /**
+         * Meta `optimization_goal`.
+         */
+        optimizationGoal?: (string) | null;
+        /**
+         * Meta `billing_event`.
+         */
+        billingEvent?: (string) | null;
+        /**
+         * Meta `promoted_object` verbatim (snake_case).
+         */
+        promotedObject?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         */
+        targeting?: {
+            [key: string]: unknown;
+        } | null;
+        schedule?: {
+            startDate?: string;
+            /**
+             * Absent when the ad set runs until it is stopped.
+             */
+            endDate?: string;
+        } | null;
+    }>;
+    /**
+     * One entry per level read. `after` is null on the last page.
+     */
+    paging?: {
+        campaigns?: {
+            after?: (string) | null;
+        };
+        adSets?: {
+            after?: (string) | null;
+        };
+    };
+});
+
+export type GetAdAccountLiveEntitiesError = (ErrorResponse | unknown);
+
 export type CreateAdAccountData = {
     body: {
         /**
@@ -47144,6 +47409,10 @@ export type UploadAdVideoData = {
          * Optional filename shown alongside the upload session. Applied only when uploading via videoBase64.
          */
         filename?: string;
+        /**
+         * true: answer 202 once Meta accepts the upload instead of waiting for processing. Poll GET /v1/ads/videos/{videoId} or subscribe to ad.video.processed.
+         */
+        async?: boolean;
     };
 };
 
@@ -47154,11 +47423,25 @@ export type UploadAdVideoResponse = ({
          * Meta video id, reusable as video.id on POST /v1/ads/create and inside POST /v1/ads/preview creativeSpec.
          */
         id?: string;
+        status?: 'ready';
         /**
          * Meta-hosted poster URL if available; null when Meta has not produced a poster yet.
          */
         thumbnailUrl?: (string) | null;
     };
+} | {
+    adAccountId?: string;
+    video?: {
+        /**
+         * Meta video id. Usable as video.id once GET /v1/ads/videos/{videoId} reports ready.
+         */
+        id?: string;
+        status?: 'processing';
+        /**
+         * Always null on 202; read it from GET /v1/ads/videos/{videoId} once ready.
+         */
+        thumbnailUrl?: (string) | null;
+    };
 });
 
 export type UploadAdVideoError = (unknown | ErrorResponse);
@@ -47203,6 +47486,51 @@ export type ListAdVideosResponse = ({
 
 export type ListAdVideosError = (ErrorResponse | unknown);
 
+export type GetAdVideoStatusData = {
+    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>) the video was uploaded to.
+         */
+        adAccountId: string;
+    };
+};
+
+export type GetAdVideoStatusResponse = ({
+    adAccountId?: string;
+    video?: {
+        id: string;
+        status: 'processing' | 'ready' | 'error';
+        /**
+         * Meta's raw status.video_status, forwarded verbatim.
+         */
+        platformStatus: (string) | null;
+        /**
+         * Meta's processing percentage when reported.
+         */
+        processingProgress: (number) | null;
+        /**
+         * Meta's processing error when status is error.
+         */
+        error: (string) | null;
+        /**
+         * Meta's auto-generated poster once ready, when Meta produced one.
+         */
+        thumbnailUrl: (string) | null;
+    };
+});
+
+export type GetAdVideoStatusError = (ErrorResponse | unknown);
+
 export type DeleteAdVideoData = {
     path: {
         /**