@zernio/node 0.2.556 → 0.2.558

package/dist/index.d.mts

@@ -7227,6 +7227,9 @@ type WebhookPayloadAccountAdsInitialSyncCompleted = {
          */
         errorCategory?: 'token_invalid' | 'permission_denied' | 'no_ad_accounts' | 'rate_limited' | 'discovery_failed' | 'unknown';
     };
+    /**
+     * 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;
 };
 type event = 'account.ads.initial_sync_completed';
@@ -7271,6 +7274,9 @@ type WebhookPayloadAccountConnected = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 type event2 = 'account.connected';
@@ -7304,6 +7310,9 @@ type WebhookPayloadAccountDisconnected = {
          */
         reason: string;
     };
+    /**
+     * 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;
 };
 type event3 = 'account.disconnected';
@@ -7420,7 +7429,7 @@ type WebhookPayloadAdStatusChanged = {
         message?: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -7469,6 +7478,9 @@ type WebhookPayloadCallEnded = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event5 = 'call.ended';
@@ -7495,6 +7507,9 @@ type WebhookPayloadCallFailed = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event6 = 'call.failed';
@@ -7524,6 +7539,9 @@ type WebhookPayloadCallPermissionRequest = {
         responseSource?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event7 = 'call.permission_request';
@@ -7572,6 +7590,9 @@ type WebhookPayloadCallReceived = {
         startedAt?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event8 = 'call.received';
@@ -7719,6 +7740,9 @@ type WebhookPayloadComment = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event9 = 'comment.received';
@@ -7770,6 +7794,9 @@ type WebhookPayloadConversationStarted = {
      * When the conversation document was created.
      */
     startedAt: string;
+    /**
+     * 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;
 };
 type event10 = 'conversation.started';
@@ -7798,6 +7825,9 @@ type WebhookPayloadExternalPost = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event11 = 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
@@ -7860,6 +7890,9 @@ type WebhookPayloadLead = {
         accountId?: string;
         platform: 'facebook';
     };
+    /**
+     * 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;
 };
 type event12 = 'lead.received';
@@ -8222,6 +8255,9 @@ type WebhookPayloadMessage = {
             };
         } | null;
     } | 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;
 };
 type event13 = 'message.received';
@@ -8261,6 +8297,9 @@ type WebhookPayloadMessageDeleted = {
     deletedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event14 = 'message.deleted';
@@ -8302,6 +8341,9 @@ type WebhookPayloadMessageDeliveryStatus = {
     } | null;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event15 = 'message.delivered' | 'message.read' | 'message.failed';
@@ -8332,6 +8374,9 @@ type WebhookPayloadMessageEdited = {
     editedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event16 = 'message.edited';
@@ -8404,6 +8449,9 @@ type WebhookPayloadMessageSent = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event17 = 'message.sent';
@@ -8444,6 +8492,9 @@ type WebhookPayloadPost = {
             [key: string]: unknown;
         };
     };
+    /**
+     * 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;
 };
 type event18 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
@@ -8538,6 +8589,9 @@ type WebhookPayloadPostPlatform = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 type event19 = 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
@@ -8591,6 +8645,9 @@ type WebhookPayloadReaction = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event20 = 'reaction.received';
@@ -8614,6 +8671,9 @@ type WebhookPayloadReviewNew = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event21 = 'review.new';
@@ -8640,6 +8700,9 @@ type WebhookPayloadReviewUpdated = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event22 = 'review.updated';
@@ -8656,6 +8719,9 @@ type WebhookPayloadTest = {
      * Human-readable test message
      */
     message: string;
+    /**
+     * UTC time at which Zernio generated this test event (set once when the payload is built). Test fires are sent synchronously as a single attempt; a later redelivery of this event keeps the original value.
+     */
     timestamp: string;
 };
 type event23 = 'webhook.test';
@@ -8707,7 +8773,7 @@ type WebhookPayloadWhatsAppTemplateStatusUpdated = {
         reason: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -18659,7 +18725,7 @@ type GetInboxPostCommentsResponse = ({
          */
         cid?: (string) | null;
         /**
-         * Parent comment ID for nested replies
+         * ID of the parent comment. Present on entries inside replies[] for Facebook, Instagram and X/Twitter. On X/Twitter it is also present on top-level entries, where it holds the ID of the post replied to. Omitted entirely (key absent, not null) on top-level Facebook and Instagram entries and on every other platform, which express the parent relationship only through replies[] nesting.
          */
         parentId?: (string) | null;
         /**
@@ -29374,6 +29440,12 @@ type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type BoostPostResponse = ({
     ad?: Ad;

package/dist/index.d.ts

@@ -7227,6 +7227,9 @@ type WebhookPayloadAccountAdsInitialSyncCompleted = {
          */
         errorCategory?: 'token_invalid' | 'permission_denied' | 'no_ad_accounts' | 'rate_limited' | 'discovery_failed' | 'unknown';
     };
+    /**
+     * 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;
 };
 type event = 'account.ads.initial_sync_completed';
@@ -7271,6 +7274,9 @@ type WebhookPayloadAccountConnected = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 type event2 = 'account.connected';
@@ -7304,6 +7310,9 @@ type WebhookPayloadAccountDisconnected = {
          */
         reason: string;
     };
+    /**
+     * 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;
 };
 type event3 = 'account.disconnected';
@@ -7420,7 +7429,7 @@ type WebhookPayloadAdStatusChanged = {
         message?: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -7469,6 +7478,9 @@ type WebhookPayloadCallEnded = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event5 = 'call.ended';
@@ -7495,6 +7507,9 @@ type WebhookPayloadCallFailed = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event6 = 'call.failed';
@@ -7524,6 +7539,9 @@ type WebhookPayloadCallPermissionRequest = {
         responseSource?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event7 = 'call.permission_request';
@@ -7572,6 +7590,9 @@ type WebhookPayloadCallReceived = {
         startedAt?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event8 = 'call.received';
@@ -7719,6 +7740,9 @@ type WebhookPayloadComment = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event9 = 'comment.received';
@@ -7770,6 +7794,9 @@ type WebhookPayloadConversationStarted = {
      * When the conversation document was created.
      */
     startedAt: string;
+    /**
+     * 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;
 };
 type event10 = 'conversation.started';
@@ -7798,6 +7825,9 @@ type WebhookPayloadExternalPost = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event11 = 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
@@ -7860,6 +7890,9 @@ type WebhookPayloadLead = {
         accountId?: string;
         platform: 'facebook';
     };
+    /**
+     * 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;
 };
 type event12 = 'lead.received';
@@ -8222,6 +8255,9 @@ type WebhookPayloadMessage = {
             };
         } | null;
     } | 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;
 };
 type event13 = 'message.received';
@@ -8261,6 +8297,9 @@ type WebhookPayloadMessageDeleted = {
     deletedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event14 = 'message.deleted';
@@ -8302,6 +8341,9 @@ type WebhookPayloadMessageDeliveryStatus = {
     } | null;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event15 = 'message.delivered' | 'message.read' | 'message.failed';
@@ -8332,6 +8374,9 @@ type WebhookPayloadMessageEdited = {
     editedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event16 = 'message.edited';
@@ -8404,6 +8449,9 @@ type WebhookPayloadMessageSent = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event17 = 'message.sent';
@@ -8444,6 +8492,9 @@ type WebhookPayloadPost = {
             [key: string]: unknown;
         };
     };
+    /**
+     * 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;
 };
 type event18 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
@@ -8538,6 +8589,9 @@ type WebhookPayloadPostPlatform = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 type event19 = 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
@@ -8591,6 +8645,9 @@ type WebhookPayloadReaction = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 type event20 = 'reaction.received';
@@ -8614,6 +8671,9 @@ type WebhookPayloadReviewNew = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event21 = 'review.new';
@@ -8640,6 +8700,9 @@ type WebhookPayloadReviewUpdated = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 type event22 = 'review.updated';
@@ -8656,6 +8719,9 @@ type WebhookPayloadTest = {
      * Human-readable test message
      */
     message: string;
+    /**
+     * UTC time at which Zernio generated this test event (set once when the payload is built). Test fires are sent synchronously as a single attempt; a later redelivery of this event keeps the original value.
+     */
     timestamp: string;
 };
 type event23 = 'webhook.test';
@@ -8707,7 +8773,7 @@ type WebhookPayloadWhatsAppTemplateStatusUpdated = {
         reason: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -18659,7 +18725,7 @@ type GetInboxPostCommentsResponse = ({
          */
         cid?: (string) | null;
         /**
-         * Parent comment ID for nested replies
+         * ID of the parent comment. Present on entries inside replies[] for Facebook, Instagram and X/Twitter. On X/Twitter it is also present on top-level entries, where it holds the ID of the post replied to. Omitted entirely (key absent, not null) on top-level Facebook and Instagram entries and on every other platform, which express the parent relationship only through replies[] nesting.
          */
         parentId?: (string) | null;
         /**
@@ -29374,6 +29440,12 @@ type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type BoostPostResponse = ({
     ad?: Ad;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.556",
+  version: "0.2.558",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.556",
+  version: "0.2.558",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.556",
+  "version": "0.2.558",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -8098,6 +8098,16 @@ export const getDsaRecommendations = <ThrowOnError extends boolean = false>(opti
  * `instagramAccountId`, `destinationType` and `adSetId` are Meta-only and
  * return 400 on other platforms.
  *
+ * **Retries.** Boosts are NOT idempotent and can take minutes when Meta requires re-hosting an
+ * Instagram video, so do not retry on client timeout. Send an
+ * Idempotency-Key header to make retries safe: same key and body replays
+ * the original 201, and distinct keys always create distinct ads.
+ * Without the header, an identical request is treated as a retry: while
+ * one is in flight it returns 409, and within 10 minutes of a completed
+ * boost it returns the already-created ad instead of creating another.
+ * To intentionally duplicate an ad, send distinct Idempotency-Keys (or
+ * vary the body, e.g. the name).
+ *
  */
 export const boostPost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BoostPostData, ThrowOnError>) => {
     return (options?.client ?? client).post<BoostPostResponse, BoostPostError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -6180,6 +6180,9 @@ export type WebhookPayloadAccountAdsInitialSyncCompleted = {
          */
         errorCategory?: 'token_invalid' | 'permission_denied' | 'no_ad_accounts' | 'rate_limited' | 'discovery_failed' | 'unknown';
     };
+    /**
+     * 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;
 };
 
@@ -6228,6 +6231,9 @@ export type WebhookPayloadAccountConnected = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 
@@ -6263,6 +6269,9 @@ export type WebhookPayloadAccountDisconnected = {
          */
         reason: string;
     };
+    /**
+     * 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;
 };
 
@@ -6382,7 +6391,7 @@ export type WebhookPayloadAdStatusChanged = {
         message?: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -6434,6 +6443,9 @@ export type WebhookPayloadCallEnded = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -6462,6 +6474,9 @@ export type WebhookPayloadCallFailed = {
         };
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -6493,6 +6508,9 @@ export type WebhookPayloadCallPermissionRequest = {
         responseSource?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -6544,6 +6562,9 @@ export type WebhookPayloadCallReceived = {
         startedAt?: string;
     };
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -6693,6 +6714,9 @@ export type WebhookPayloadComment = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 
@@ -6747,6 +6771,9 @@ export type WebhookPayloadConversationStarted = {
      * When the conversation document was created.
      */
     startedAt: string;
+    /**
+     * 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;
 };
 
@@ -6778,6 +6805,9 @@ export type WebhookPayloadExternalPost = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 
@@ -6842,6 +6872,9 @@ export type WebhookPayloadLead = {
         accountId?: string;
         platform: 'facebook';
     };
+    /**
+     * 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;
 };
 
@@ -7207,6 +7240,9 @@ export type WebhookPayloadMessage = {
             };
         } | null;
     } | 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;
 };
 
@@ -7250,6 +7286,9 @@ export type WebhookPayloadMessageDeleted = {
     deletedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -7293,6 +7332,9 @@ export type WebhookPayloadMessageDeliveryStatus = {
     } | null;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -7325,6 +7367,9 @@ export type WebhookPayloadMessageEdited = {
     editedAt: string;
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -7399,6 +7444,9 @@ export type WebhookPayloadMessageSent = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -7442,6 +7490,9 @@ export type WebhookPayloadPost = {
             [key: string]: unknown;
         };
     };
+    /**
+     * 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;
 };
 
@@ -7538,6 +7589,9 @@ export type WebhookPayloadPostPlatform = {
         username: string;
         displayName?: string;
     };
+    /**
+     * 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;
 };
 
@@ -7594,6 +7648,9 @@ export type WebhookPayloadReaction = {
     };
     conversation: InboxWebhookConversation;
     account: InboxWebhookAccount;
+    /**
+     * 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;
 };
 
@@ -7620,6 +7677,9 @@ export type WebhookPayloadReviewNew = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 
@@ -7648,6 +7708,9 @@ export type WebhookPayloadReviewUpdated = {
         platform: string;
         username: string;
     };
+    /**
+     * 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;
 };
 
@@ -7666,6 +7729,9 @@ export type WebhookPayloadTest = {
      * Human-readable test message
      */
     message: string;
+    /**
+     * UTC time at which Zernio generated this test event (set once when the payload is built). Test fires are sent synchronously as a single attempt; a later redelivery of this event keeps the original value.
+     */
     timestamp: string;
 };
 
@@ -7719,7 +7785,7 @@ export type WebhookPayloadWhatsAppTemplateStatusUpdated = {
         reason: string;
     };
     /**
-     * ISO-8601 timestamp the webhook was produced.
+     * 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;
 };
@@ -18359,7 +18425,7 @@ export type GetInboxPostCommentsResponse = ({
          */
         cid?: (string) | null;
         /**
-         * Parent comment ID for nested replies
+         * ID of the parent comment. Present on entries inside replies[] for Facebook, Instagram and X/Twitter. On X/Twitter it is also present on top-level entries, where it holds the ID of the post replied to. Omitted entirely (key absent, not null) on top-level Facebook and Instagram entries and on every other platform, which express the parent relationship only through replies[] nesting.
          */
         parentId?: (string) | null;
         /**
@@ -29907,6 +29973,12 @@ export type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 
 export type BoostPostResponse = ({