@linqapp/sdk 0.38.1 → 0.39.0

package/resources/webhooks.d.mts

@@ -872,8 +872,8 @@ export declare namespace MessageFailedWebhookEvent {
     interface Data {
         /**
          * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
          * chat.group_icon_update_failed) carry 3007 or 4001.
          */
         code: number;
@@ -1174,6 +1174,820 @@ export interface ReactionRemovedWebhookEvent {
      */
     webhook_version: string;
 }
+/**
+ * Complete webhook payload for poll.received events
+ */
+export interface PollReceivedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.received — a poll created by someone else and delivered to your
+     * line. Carries the full poll snapshot (options, no voters yet) at receipt time.
+     */
+    data: PollReceivedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollReceivedWebhookEvent {
+    /**
+     * Payload for poll.received — a poll created by someone else and delivered to your
+     * line. Carries the full poll snapshot (options, no voters yet) at receipt time.
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        received_at: string;
+        service: string;
+        updated_at: string;
+        /**
+         * The line that created the poll (is_me=false for an inbound poll).
+         */
+        sender_handle?: Shared.ChatHandle | null;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.sent events
+ */
+export interface PollSentWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    data: PollSentWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollSentWebhookEvent {
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
+        updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
+        /**
+         * The handle that sent the poll.
+         */
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.delivered events
+ */
+export interface PollDeliveredWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    data: PollDeliveredWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollDeliveredWebhookEvent {
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
+        updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
+        /**
+         * The handle that sent the poll.
+         */
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.read events
+ */
+export interface PollReadWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    data: PollReadWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollReadWebhookEvent {
+    /**
+     * Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps
+     * indicate state (null = not yet happened): sent → sent_at; delivered →
+     * +delivered_at; read → +read_at.
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        created_at: string;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
+        updated_at: string;
+        delivered_at?: string | null;
+        read_at?: string | null;
+        /**
+         * The handle that sent the poll.
+         */
+        sender_handle?: Shared.ChatHandle | null;
+        sent_at?: string | null;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.updated events
+ */
+export interface PollUpdatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.updated (option(s) added — add-only).
+     */
+    data: PollUpdatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollUpdatedWebhookEvent {
+    /**
+     * Payload for poll.updated (option(s) added — add-only).
+     */
+    interface Data {
+        added_options: Array<Data.AddedOption>;
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        /**
+         * The line that added the option(s) — always present.
+         */
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        interface AddedOption {
+            can_be_edited: boolean;
+            /**
+             * The participant who added this option (poll creator for the initial options;
+             * whoever added later ones). Null when unknown.
+             */
+            creator_handle: Shared.ChatHandle;
+            option_id: string;
+            text: string;
+            voters: Array<AddedOption.Voter>;
+        }
+        namespace AddedOption {
+            interface Voter {
+                handle: string;
+                voted_at: string;
+            }
+        }
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.failed events
+ */
+export interface PollFailedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.failed — an outbound poll (or poll action) that failed to send.
+     * Carries the poll snapshot at failure time plus the error and when it failed.
+     */
+    data: PollFailedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollFailedWebhookEvent {
+    /**
+     * Payload for poll.failed — an outbound poll (or poll action) that failed to send.
+     * Carries the poll snapshot at failure time plus the error and when it failed.
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        error: Data.Error;
+        failed_at: string;
+        message_id: string;
+        poll: Data.Poll;
+        service: string;
+        /**
+         * Null on failure (the send never landed).
+         */
+        sender_handle?: Shared.ChatHandle | null;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        interface Error {
+            /**
+             * Error codes in webhook failure events. The possible set varies by event:
+             * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+             * 4008; the group update failure events (chat.group_name_update_failed,
+             * chat.group_icon_update_failed) carry 3007 or 4001.
+             */
+            code: number;
+            message: string;
+        }
+        interface Poll {
+            options: Array<Poll.Option>;
+            /**
+             * Distinct participants across the whole poll.
+             */
+            total_voters: number;
+        }
+        namespace Poll {
+            interface Option {
+                can_be_edited: boolean;
+                /**
+                 * The participant who added this option (poll creator for the initial options;
+                 * whoever added later ones). Null when unknown.
+                 */
+                creator_handle: Shared.ChatHandle;
+                option_id: string;
+                text: string;
+                voters: Array<Option.Voter>;
+            }
+            namespace Option {
+                interface Voter {
+                    handle: string;
+                    voted_at: string;
+                }
+            }
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.vote.added events
+ */
+export interface PollVoteAddedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    data: PollVoteAddedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollVoteAddedWebhookEvent {
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        option_id: string;
+        /**
+         * The voter — always present.
+         */
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.vote.removed events
+ */
+export interface PollVoteRemovedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    data: PollVoteRemovedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace PollVoteRemovedWebhookEvent {
+    /**
+     * Payload for poll.vote.added and poll.vote.removed (one option toggled).
+     */
+    interface Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        chat: Data.Chat;
+        direction: 'inbound' | 'outbound';
+        message_id: string;
+        option_id: string;
+        /**
+         * The voter — always present.
+         */
+        sender_handle: Shared.ChatHandle;
+        service: string;
+    }
+    namespace Data {
+        /**
+         * Chat info for poll webhook events.
+         */
+        interface Chat {
+            id: string;
+            is_group?: boolean | null;
+            owner_handle?: Shared.ChatHandle | null;
+        }
+    }
+}
+/**
+ * Complete webhook payload for poll.reaction.added events
+ */
+export interface PollReactionAddedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for poll.reaction.added — a reaction on a poll message. Same shape as
+     * reaction.added; `message_id` is the poll-definition message's ID. Poll reactions
+     * are stickers, which iMessage cannot remove, so there is no removal counterpart.
+     */
+    data: ReactionEventBase;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
 /**
  * Complete webhook payload for participant.added events
  */
@@ -1655,8 +2469,8 @@ export declare namespace ChatGroupNameUpdateFailedWebhookEvent {
         chat_id: string;
         /**
          * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
          * chat.group_icon_update_failed) carry 3007 or 4001.
          */
         error_code: number;
@@ -1724,8 +2538,8 @@ export declare namespace ChatGroupIconUpdateFailedWebhookEvent {
         chat_id: string;
         /**
          * Error codes in webhook failure events. The possible set varies by event:
-         * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
-         * update failure events (chat.group_name_update_failed,
+         * message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or
+         * 4008; the group update failure events (chat.group_name_update_failed,
          * chat.group_icon_update_failed) carry 3007 or 4001.
          */
         error_code: number;
@@ -1843,6 +2657,113 @@ export declare namespace ChatTypingIndicatorStoppedWebhookEvent {
         chat_id: string;
     }
 }
+/**
+ * Complete webhook payload for chat.background_updated events
+ */
+export interface ChatBackgroundUpdatedWebhookEvent {
+    /**
+     * API version for the webhook payload format
+     */
+    api_version: string;
+    /**
+     * When the event was created
+     */
+    created_at: string;
+    /**
+     * Payload for chat.background_updated webhook events.
+     */
+    data: ChatBackgroundUpdatedWebhookEvent.Data;
+    /**
+     * Unique identifier for this event (for deduplication)
+     */
+    event_id: string;
+    /**
+     * Valid webhook event types that can be subscribed to.
+     *
+     * **Note:** `message.edited` is only delivered to subscriptions using
+     * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+     * subscription will not produce any deliveries.
+     */
+    event_type: WebhookEventsAPI.WebhookEventType;
+    /**
+     * Partner identifier. Present on all webhooks for cross-referencing.
+     */
+    partner_id: string;
+    /**
+     * Trace ID for debugging and correlation across systems.
+     */
+    trace_id: string;
+    /**
+     * Date-based webhook payload version. Determined by the `?version=` query
+     * parameter in your webhook subscription URL. If no version parameter is
+     * specified, defaults based on subscription creation date.
+     */
+    webhook_version: string;
+}
+export declare namespace ChatBackgroundUpdatedWebhookEvent {
+    /**
+     * Payload for chat.background_updated webhook events.
+     */
+    interface Data {
+        /**
+         * Chat information
+         */
+        chat: Data.Chat;
+        /**
+         * Who changed it. `is_me` is true when your own number set it.
+         */
+        actor_handle?: Shared.ChatHandle | null;
+        /**
+         * A chat transcript background. Fields are populated per `type`.
+         */
+        background?: Data.Background | null;
+    }
+    namespace Data {
+        /**
+         * Chat information
+         */
+        interface Chat {
+            /**
+             * Chat identifier
+             */
+            id: string;
+            /**
+             * Whether this is a group chat
+             */
+            is_group?: boolean | null;
+            /**
+             * Your phone number's handle. Always has is_me=true.
+             */
+            owner_handle?: Shared.ChatHandle | null;
+        }
+        /**
+         * A chat transcript background. Fields are populated per `type`.
+         */
+        interface Background {
+            /**
+             * The background family.
+             */
+            type: 'color' | 'dynamic' | 'photo';
+            /**
+             * Photo: the image URL.
+             */
+            image_url?: string | null;
+            /**
+             * Color: the two gradient stops as hex, top then bottom.
+             */
+            shades?: Array<string> | null;
+            /**
+             * Dynamic: the animated style.
+             */
+            style?: 'sky' | 'water' | 'aurora' | 'glitter' | null;
+            /**
+             * Color: `custom` (the stored two colors) or a named swatch. Dynamic: the variant
+             * within the `style` (e.g. `sunrise`).
+             */
+            variant?: string | null;
+        }
+    }
+}
 /**
  * Complete webhook payload for phone_number.status_updated events
  */
@@ -1916,8 +2837,8 @@ export declare namespace PhoneNumberStatusUpdatedWebhookEvent {
 /**
  * Complete webhook payload for message.sent events (2026-02-03 format)
  */
-export type UnwrapWebhookEvent = MessageSentWebhookEvent | MessageReceivedWebhookEvent | MessageReadWebhookEvent | MessageDeliveredWebhookEvent | MessageFailedWebhookEvent | MessageEditedWebhookEvent | ReactionAddedWebhookEvent | ReactionRemovedWebhookEvent | ParticipantAddedWebhookEvent | ParticipantRemovedWebhookEvent | ChatCreatedWebhookEvent | ChatGroupNameUpdatedWebhookEvent | ChatGroupIconUpdatedWebhookEvent | ChatGroupNameUpdateFailedWebhookEvent | ChatGroupIconUpdateFailedWebhookEvent | ChatTypingIndicatorStartedWebhookEvent | ChatTypingIndicatorStoppedWebhookEvent | PhoneNumberStatusUpdatedWebhookEvent;
+export type UnwrapWebhookEvent = MessageSentWebhookEvent | MessageReceivedWebhookEvent | MessageReadWebhookEvent | MessageDeliveredWebhookEvent | MessageFailedWebhookEvent | MessageEditedWebhookEvent | ReactionAddedWebhookEvent | ReactionRemovedWebhookEvent | PollReceivedWebhookEvent | PollSentWebhookEvent | PollDeliveredWebhookEvent | PollReadWebhookEvent | PollUpdatedWebhookEvent | PollFailedWebhookEvent | PollVoteAddedWebhookEvent | PollVoteRemovedWebhookEvent | PollReactionAddedWebhookEvent | ParticipantAddedWebhookEvent | ParticipantRemovedWebhookEvent | ChatCreatedWebhookEvent | ChatGroupNameUpdatedWebhookEvent | ChatGroupIconUpdatedWebhookEvent | ChatGroupNameUpdateFailedWebhookEvent | ChatGroupIconUpdateFailedWebhookEvent | ChatTypingIndicatorStartedWebhookEvent | ChatTypingIndicatorStoppedWebhookEvent | ChatBackgroundUpdatedWebhookEvent | PhoneNumberStatusUpdatedWebhookEvent;
 export declare namespace Webhooks {
-    export { type MessageEventV2 as MessageEventV2, type MessagePayload as MessagePayload, type ReactionEventBase as ReactionEventBase, type SchemasMediaPartResponse as SchemasMediaPartResponse, type SchemasMessageEffect as SchemasMessageEffect, type SchemasTextPartResponse as SchemasTextPartResponse, type MessageSentWebhookEvent as MessageSentWebhookEvent, type MessageReceivedWebhookEvent as MessageReceivedWebhookEvent, type MessageReadWebhookEvent as MessageReadWebhookEvent, type MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent, type MessageFailedWebhookEvent as MessageFailedWebhookEvent, type MessageEditedWebhookEvent as MessageEditedWebhookEvent, type ReactionAddedWebhookEvent as ReactionAddedWebhookEvent, type ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent, type ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent, type ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent, type ChatCreatedWebhookEvent as ChatCreatedWebhookEvent, type ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent, type ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent, type ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent, type ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent, type ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent, type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent, type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
+    export { type MessageEventV2 as MessageEventV2, type MessagePayload as MessagePayload, type ReactionEventBase as ReactionEventBase, type SchemasMediaPartResponse as SchemasMediaPartResponse, type SchemasMessageEffect as SchemasMessageEffect, type SchemasTextPartResponse as SchemasTextPartResponse, type MessageSentWebhookEvent as MessageSentWebhookEvent, type MessageReceivedWebhookEvent as MessageReceivedWebhookEvent, type MessageReadWebhookEvent as MessageReadWebhookEvent, type MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent, type MessageFailedWebhookEvent as MessageFailedWebhookEvent, type MessageEditedWebhookEvent as MessageEditedWebhookEvent, type ReactionAddedWebhookEvent as ReactionAddedWebhookEvent, type ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent, type PollReceivedWebhookEvent as PollReceivedWebhookEvent, type PollSentWebhookEvent as PollSentWebhookEvent, type PollDeliveredWebhookEvent as PollDeliveredWebhookEvent, type PollReadWebhookEvent as PollReadWebhookEvent, type PollUpdatedWebhookEvent as PollUpdatedWebhookEvent, type PollFailedWebhookEvent as PollFailedWebhookEvent, type PollVoteAddedWebhookEvent as PollVoteAddedWebhookEvent, type PollVoteRemovedWebhookEvent as PollVoteRemovedWebhookEvent, type PollReactionAddedWebhookEvent as PollReactionAddedWebhookEvent, type ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent, type ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent, type ChatCreatedWebhookEvent as ChatCreatedWebhookEvent, type ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent, type ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent, type ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent, type ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent, type ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent, type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent, type ChatBackgroundUpdatedWebhookEvent as ChatBackgroundUpdatedWebhookEvent, type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
 }
 //# sourceMappingURL=webhooks.d.mts.map