@sentdm/sentdm 0.33.0 → 0.35.0

package/resources/webhooks.d.ts

@@ -3,7 +3,11 @@ import * as WebhooksAPI from "./webhooks.js";
 import { APIPromise } from "../core/api-promise.js";
 import { RequestOptions } from "../internal/request-options.js";
 /**
- * Configure webhook endpoints for real-time event delivery
+ * Delivery reports and inbound messages, pushed to you.
+ *
+ * Subscribe an endpoint to the event types you care about — `GET /v3/webhooks/event-types` lists them — and we POST each one as it happens, retrying on failure. Polling `GET /v3/messages/{id}` works and does not scale.
+ *
+ * **Verify the signature.** Every delivery is signed with your endpoint's secret; an unverified endpoint is one anybody can post to. `rotate-secret` replaces it, `test` sends a specimen event, and `GET /v3/webhooks/{id}/events` shows what we tried to deliver and what your endpoint answered — which is the first place to look when something appears to be missing.
  */
 export declare class Webhooks extends APIResource {
     /**
@@ -11,32 +15,32 @@ export declare class Webhooks extends APIResource {
      *
      * @example
      * ```ts
-     * const apiResponseWebhook = await client.webhooks.create();
+     * const webhook = await client.webhooks.create();
      * ```
      */
-    create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<APIResponseWebhook>;
+    create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<WebhookCreateResponse>;
     /**
      * Retrieves a single webhook by ID for the authenticated customer.
      *
      * @example
      * ```ts
-     * const apiResponseWebhook = await client.webhooks.retrieve(
+     * const webhook = await client.webhooks.retrieve(
      *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
      * );
      * ```
      */
-    retrieve(id: string, params?: WebhookRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<APIResponseWebhook>;
+    retrieve(id: string, params?: WebhookRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<WebhookRetrieveResponse>;
     /**
      * Updates an existing webhook for the authenticated customer.
      *
      * @example
      * ```ts
-     * const apiResponseWebhook = await client.webhooks.update(
+     * const webhook = await client.webhooks.update(
      *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
      * );
      * ```
      */
-    update(id: string, params: WebhookUpdateParams, options?: RequestOptions): APIPromise<APIResponseWebhook>;
+    update(id: string, params: WebhookUpdateParams, options?: RequestOptions): APIPromise<WebhookUpdateResponse>;
     /**
      * Retrieves a paginated list of webhooks for the authenticated customer.
      *
@@ -109,168 +113,514 @@ export declare class Webhooks extends APIResource {
      *
      * @example
      * ```ts
-     * const apiResponseWebhook =
-     *   await client.webhooks.toggleStatus(
-     *     'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
-     *   );
+     * const response = await client.webhooks.toggleStatus(
+     *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
+     * );
      * ```
      */
-    toggleStatus(id: string, params: WebhookToggleStatusParams, options?: RequestOptions): APIPromise<APIResponseWebhook>;
+    toggleStatus(id: string, params: WebhookToggleStatusParams, options?: RequestOptions): APIPromise<WebhookToggleStatusResponse>;
+}
+/**
+ * The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
+ * this shape and varies only in Payload.
+ */
+export interface InboundMessageEvent {
+    /**
+     * The specific event within the family, for example message.delivered or
+     * message.received. Absent on events that have no subtype, so treat it as
+     * optional.
+     */
+    event?: string | null;
+    /**
+     * The event family, for example message or templates. Route on this first, then on
+     * event for the specific change.
+     */
+    field?: string;
+    /**
+     * Body of a message.received event. Delivered when a contact messages one of your
+     * numbers.
+     */
+    payload?: InboundMessageEventPayload | null;
+    /**
+     * When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+     * time, not the time the underlying change happened. Use the timestamp inside the
+     * payload for the latter.
+     */
+    timestamp?: string;
+}
+/**
+ * Body of a message.received event. Delivered when a contact messages one of your
+ * numbers.
+ */
+export interface InboundMessageEventPayload {
+    /**
+     * The account the message belongs to.
+     */
+    account_id?: string;
+    /**
+     * The channel the message arrived on, for example sms or whatsapp.
+     */
+    channel?: string;
+    /**
+     * The contact's number in E.164 format, meaning the number the message came from.
+     */
+    inbound_number?: string;
+    /**
+     * The inbound message.
+     */
+    message_id?: string;
+    /**
+     * Your number in E.164 format, meaning the number the message was addressed to.
+     */
+    outbound_number?: string;
+    /**
+     * When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+     */
+    received_at?: string;
+    /**
+     * The message body. Sent as null when the inbound message carried no text, for
+     * example a media-only message. The field is always present, so read it and check
+     * for null rather than checking whether the key exists.
+     */
+    text?: string | null;
+    /**
+     * When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ). Same value as
+     * ReceivedAt, kept for envelope consistency with outbound events.
+     */
+    updated_at?: string;
+}
+/**
+ * The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
+ * this shape and varies only in Payload.
+ */
+export interface MessageEvent {
+    /**
+     * The specific event within the family, for example message.delivered or
+     * message.received. Absent on events that have no subtype, so treat it as
+     * optional.
+     */
+    event?: string | null;
+    /**
+     * The event family, for example message or templates. Route on this first, then on
+     * event for the specific change.
+     */
+    field?: string;
+    /**
+     * Body of an outbound message lifecycle event. Delivered once per status change,
+     * so a single message produces several of these as it moves toward a terminal
+     * status.
+     */
+    payload?: MessageEventPayload | null;
+    /**
+     * When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+     * time, not the time the underlying change happened. Use the timestamp inside the
+     * payload for the latter.
+     */
+    timestamp?: string;
+}
+/**
+ * Body of an outbound message lifecycle event. Delivered once per status change,
+ * so a single message produces several of these as it moves toward a terminal
+ * status.
+ */
+export interface MessageEventPayload {
+    /**
+     * The account the message belongs to.
+     */
+    account_id?: string;
+    /**
+     * The agent attributed to the send, when the send was attributed to one.
+     */
+    agent_id?: string | null;
+    /**
+     * The channel the message went out on, for example sms or whatsapp. A message that
+     * falls back to another channel reports the channel actually used.
+     */
+    channel?: string;
+    /**
+     * The message this event describes. Stable across every event in the message's
+     * lifecycle, so use it to correlate them.
+     */
+    message_id?: string;
+    /**
+     * The status the message just reached, for example SENT, DELIVERED, or FAILED.
+     * Sent means dispatched and delivered means confirmed, so treat them as distinct
+     * outcomes.
+     */
+    message_status?: string;
+    /**
+     * The recipient's number in E.164 format.
+     */
+    outbound_number?: string;
+    /**
+     * The template the message was sent from, when it was sent from one.
+     */
+    template_id?: string | null;
+    /**
+     * Name of the template the message was sent from. Omitted when the message wasn't
+     * template-based.
+     */
+    template_name?: string | null;
+    /**
+     * When the message reached MessageStatus, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+     */
+    updated_at?: string;
 }
 /**
- * Request and response metadata
+ * The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
+ * this shape and varies only in Payload.
  */
-export interface APIMeta {
+export interface TemplateEvent {
+    /**
+     * The specific event within the family, for example message.delivered or
+     * message.received. Absent on events that have no subtype, so treat it as
+     * optional.
+     */
+    event?: string | null;
+    /**
+     * The event family, for example message or templates. Route on this first, then on
+     * event for the specific change.
+     */
+    field?: string;
     /**
-     * Unique identifier for this request (for tracing and support)
+     * Body of a template status event. Delivered when a template's review outcome
+     * changes, so you can react without polling.
      */
-    request_id?: string;
+    payload?: TemplateEventPayload | null;
     /**
-     * Server timestamp when the response was generated
+     * When Sent emitted the event, in UTC (yyyy-MM-ddTHH:mm:ssZ). This is the emission
+     * time, not the time the underlying change happened. Use the timestamp inside the
+     * payload for the latter.
      */
     timestamp?: string;
+}
+/**
+ * Body of a template status event. Delivered when a template's review outcome
+ * changes, so you can react without polling.
+ */
+export interface TemplateEventPayload {
+    /**
+     * The account the template belongs to.
+     */
+    account_id?: string;
     /**
-     * API version used for this request
+     * The template's category, for example UTILITY, MARKETING, or AUTHENTICATION.
      */
-    version?: string;
+    category?: string;
+    /**
+     * The channel the template applies to.
+     */
+    channel?: string;
+    /**
+     * The template's language code, for example en_US.
+     */
+    language?: string;
+    /**
+     * Why the template reached Status, when a reason was given. Populated on a
+     * rejection.
+     */
+    reason?: string | null;
+    /**
+     * The review status the template just reached, for example APPROVED or REJECTED.
+     */
+    status?: string;
+    /**
+     * The template in Sent.
+     */
+    template_id?: string;
+    /**
+     * The template's display name.
+     */
+    template_name?: string;
+    /**
+     * The template's identifier with Meta, assigned when the template is submitted for
+     * review.
+     */
+    whatsapp_template_id?: string;
 }
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface APIResponseWebhook {
+export interface WebhookCreateResponse {
     /**
      * The response data (null if error)
      */
-    data?: WebhookResponse | null;
+    data?: WebhookCreateResponse.Data | null;
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookCreateResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookCreateResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
     success?: boolean;
 }
+export declare namespace WebhookCreateResponse {
+    /**
+     * The response data (null if error)
+     */
+    interface Data {
+        id?: string;
+        consecutive_failures?: number;
+        created_at?: string;
+        /**
+         * Which customer owns this — the key's own, or the profile named in x-profile-id.
+         * Says whose resource this is, which the resource's own id does not.
+         */
+        customer_id?: string;
+        display_name?: string;
+        endpoint_url?: string;
+        event_filters?: {
+            [key: string]: Array<string>;
+        } | null;
+        event_types?: Array<string>;
+        is_active?: boolean;
+        last_delivery_attempt_at?: string | null;
+        last_successful_delivery_at?: string | null;
+        retry_count?: number;
+        signing_secret?: string | null;
+        timeout_seconds?: number;
+        updated_at?: string | null;
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
+}
 /**
- * Error information
+ * Standard API response envelope for all v3 endpoints
  */
-export interface ErrorDetail {
+export interface WebhookRetrieveResponse {
     /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
+     * The response data (null if error)
      */
-    code?: string;
+    data?: WebhookRetrieveResponse.Data | null;
     /**
-     * Additional validation error details (field-level errors)
+     * Error information
      */
-    details?: {
-        [key: string]: Array<string>;
-    } | null;
+    error?: WebhookRetrieveResponse.Error | null;
     /**
-     * URL to documentation about this error
+     * Request and response metadata
      */
-    doc_url?: string | null;
+    meta?: WebhookRetrieveResponse.Meta;
     /**
-     * Human-readable error message
+     * Indicates whether the request was successful
      */
-    message?: string;
+    success?: boolean;
 }
-export interface MutationRequest {
+export declare namespace WebhookRetrieveResponse {
     /**
-     * Sandbox flag - when true, the operation is simulated without side effects Useful
-     * for testing integrations without actual execution
+     * The response data (null if error)
      */
-    sandbox?: boolean;
+    interface Data {
+        id?: string;
+        consecutive_failures?: number;
+        created_at?: string;
+        /**
+         * Which customer owns this — the key's own, or the profile named in x-profile-id.
+         * Says whose resource this is, which the resource's own id does not.
+         */
+        customer_id?: string;
+        display_name?: string;
+        endpoint_url?: string;
+        event_filters?: {
+            [key: string]: Array<string>;
+        } | null;
+        event_types?: Array<string>;
+        is_active?: boolean;
+        last_delivery_attempt_at?: string | null;
+        last_successful_delivery_at?: string | null;
+        retry_count?: number;
+        signing_secret?: string | null;
+        timeout_seconds?: number;
+        updated_at?: string | null;
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 /**
- * Pagination metadata for list responses
+ * Standard API response envelope for all v3 endpoints
  */
-export interface PaginationMeta {
+export interface WebhookUpdateResponse {
     /**
-     * Cursor-based pagination pointers
+     * The response data (null if error)
      */
-    cursors?: PaginationMeta.Cursors | null;
+    data?: WebhookUpdateResponse.Data | null;
     /**
-     * Whether there are more pages after this one
+     * Error information
      */
-    has_more?: boolean;
+    error?: WebhookUpdateResponse.Error | null;
     /**
-     * Current page number (1-indexed)
+     * Request and response metadata
      */
-    page?: number;
+    meta?: WebhookUpdateResponse.Meta;
     /**
-     * Number of items per page
+     * Indicates whether the request was successful
      */
-    page_size?: number;
+    success?: boolean;
+}
+export declare namespace WebhookUpdateResponse {
     /**
-     * Total number of items across all pages
+     * The response data (null if error)
      */
-    total_count?: number;
+    interface Data {
+        id?: string;
+        consecutive_failures?: number;
+        created_at?: string;
+        /**
+         * Which customer owns this — the key's own, or the profile named in x-profile-id.
+         * Says whose resource this is, which the resource's own id does not.
+         */
+        customer_id?: string;
+        display_name?: string;
+        endpoint_url?: string;
+        event_filters?: {
+            [key: string]: Array<string>;
+        } | null;
+        event_types?: Array<string>;
+        is_active?: boolean;
+        last_delivery_attempt_at?: string | null;
+        last_successful_delivery_at?: string | null;
+        retry_count?: number;
+        signing_secret?: string | null;
+        timeout_seconds?: number;
+        updated_at?: string | null;
+    }
     /**
-     * Total number of pages
+     * Error information
      */
-    total_pages?: number;
-}
-export declare namespace PaginationMeta {
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
     /**
-     * Cursor-based pagination pointers
+     * Request and response metadata
      */
-    interface Cursors {
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
         /**
-         * Cursor to fetch the next page
+         * Server timestamp when the response was generated
          */
-        after?: string | null;
+        timestamp?: string;
         /**
-         * Cursor to fetch the previous page
+         * API version used for this request
          */
-        before?: string | null;
+        version?: string;
     }
 }
-export interface WebhookEventType {
-    description?: string | null;
-    display_name?: string;
-    event_type?: string | null;
-    is_active?: boolean;
-    name?: string;
-    sub_types?: Array<WebhookEventType> | null;
-}
-export interface WebhookResponse {
-    id?: string;
-    consecutive_failures?: number;
-    created_at?: string;
-    display_name?: string;
-    endpoint_url?: string;
-    event_filters?: {
-        [key: string]: Array<string>;
-    } | null;
-    event_types?: Array<string>;
-    is_active?: boolean;
-    last_delivery_attempt_at?: string | null;
-    last_successful_delivery_at?: string | null;
-    retry_count?: number;
-    signing_secret?: string | null;
-    timeout_seconds?: number;
-    updated_at?: string | null;
-}
 /**
  * Standard API response envelope for all v3 endpoints
  */
 export interface WebhookListResponse {
     /**
-     * The response data (null if error)
+     * A paginated list of webhooks.
      */
     data?: WebhookListResponse.Data | null;
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookListResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookListResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -278,14 +628,126 @@ export interface WebhookListResponse {
 }
 export declare namespace WebhookListResponse {
     /**
-     * The response data (null if error)
+     * A paginated list of webhooks.
      */
     interface Data {
         /**
          * Pagination metadata for list responses
          */
-        pagination?: WebhooksAPI.PaginationMeta;
-        webhooks?: Array<WebhooksAPI.WebhookResponse>;
+        pagination?: Data.Pagination;
+        /**
+         * The webhooks on this page.
+         */
+        webhooks?: Array<Data.Webhook>;
+    }
+    namespace Data {
+        /**
+         * Pagination metadata for list responses
+         */
+        interface Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            cursors?: Pagination.Cursors | null;
+            /**
+             * Whether there are more pages after this one
+             */
+            has_more?: boolean;
+            /**
+             * Current page number (1-indexed)
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             */
+            page_size?: number;
+            /**
+             * Total number of items across all pages
+             */
+            total_count?: number;
+            /**
+             * Total number of pages
+             */
+            total_pages?: number;
+        }
+        namespace Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            interface Cursors {
+                /**
+                 * Cursor to fetch the next page.
+                 */
+                after?: string | null;
+                /**
+                 * Cursor to fetch the previous page.
+                 */
+                before?: string | null;
+            }
+        }
+        interface Webhook {
+            id?: string;
+            consecutive_failures?: number;
+            created_at?: string;
+            /**
+             * Which customer owns this — the key's own, or the profile named in x-profile-id.
+             * Says whose resource this is, which the resource's own id does not.
+             */
+            customer_id?: string;
+            display_name?: string;
+            endpoint_url?: string;
+            event_filters?: {
+                [key: string]: Array<string>;
+            } | null;
+            event_types?: Array<string>;
+            is_active?: boolean;
+            last_delivery_attempt_at?: string | null;
+            last_successful_delivery_at?: string | null;
+            retry_count?: number;
+            signing_secret?: string | null;
+            timeout_seconds?: number;
+            updated_at?: string | null;
+        }
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
     }
 }
 /**
@@ -293,17 +755,17 @@ export declare namespace WebhookListResponse {
  */
 export interface WebhookListEventTypesResponse {
     /**
-     * The response data (null if error)
+     * The webhook event types a customer can subscribe to.
      */
     data?: WebhookListEventTypesResponse.Data | null;
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookListEventTypesResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookListEventTypesResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -311,10 +773,111 @@ export interface WebhookListEventTypesResponse {
 }
 export declare namespace WebhookListEventTypesResponse {
     /**
-     * The response data (null if error)
+     * The webhook event types a customer can subscribe to.
      */
     interface Data {
-        event_types?: Array<WebhooksAPI.WebhookEventType>;
+        /**
+         * The event_types on this page.
+         */
+        event_types?: Array<Data.EventType>;
+        /**
+         * Pagination metadata for list responses
+         */
+        pagination?: Data.Pagination;
+    }
+    namespace Data {
+        interface EventType {
+            description?: string | null;
+            display_name?: string;
+            event_type?: string | null;
+            is_active?: boolean;
+            name?: string;
+            sub_types?: Array<unknown> | null;
+        }
+        /**
+         * Pagination metadata for list responses
+         */
+        interface Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            cursors?: Pagination.Cursors | null;
+            /**
+             * Whether there are more pages after this one
+             */
+            has_more?: boolean;
+            /**
+             * Current page number (1-indexed)
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             */
+            page_size?: number;
+            /**
+             * Total number of items across all pages
+             */
+            total_count?: number;
+            /**
+             * Total number of pages
+             */
+            total_pages?: number;
+        }
+        namespace Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            interface Cursors {
+                /**
+                 * Cursor to fetch the next page.
+                 */
+                after?: string | null;
+                /**
+                 * Cursor to fetch the previous page.
+                 */
+                before?: string | null;
+            }
+        }
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
     }
 }
 /**
@@ -322,17 +885,17 @@ export declare namespace WebhookListEventTypesResponse {
  */
 export interface WebhookListEventsResponse {
     /**
-     * The response data (null if error)
+     * A paginated list of webhook delivery records.
      */
     data?: WebhookListEventsResponse.Data | null;
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookListEventsResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookListEventsResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -340,14 +903,17 @@ export interface WebhookListEventsResponse {
 }
 export declare namespace WebhookListEventsResponse {
     /**
-     * The response data (null if error)
+     * A paginated list of webhook delivery records.
      */
     interface Data {
+        /**
+         * The events on this page.
+         */
         events?: Array<Data.Event>;
         /**
          * Pagination metadata for list responses
          */
-        pagination?: WebhooksAPI.PaginationMeta;
+        pagination?: Data.Pagination;
     }
     namespace Data {
         interface Event {
@@ -356,13 +922,103 @@ export declare namespace WebhookListEventsResponse {
             delivery_attempts?: number;
             delivery_status?: string;
             error_message?: string | null;
-            event_data?: unknown;
+            /**
+             * The exact event body that was delivered, or attempted, for this record. One of
+             * the three webhook envelopes: a message status change, an inbound message, or a
+             * template status change. Read field and event to tell which, the same way your
+             * endpoint does.
+             */
+            event_data?: WebhooksAPI.MessageEvent | WebhooksAPI.InboundMessageEvent | WebhooksAPI.TemplateEvent;
             event_type?: string;
             http_status_code?: number | null;
             processing_completed_at?: string | null;
             processing_started_at?: string | null;
             response_body?: string | null;
         }
+        /**
+         * Pagination metadata for list responses
+         */
+        interface Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            cursors?: Pagination.Cursors | null;
+            /**
+             * Whether there are more pages after this one
+             */
+            has_more?: boolean;
+            /**
+             * Current page number (1-indexed)
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             */
+            page_size?: number;
+            /**
+             * Total number of items across all pages
+             */
+            total_count?: number;
+            /**
+             * Total number of pages
+             */
+            total_pages?: number;
+        }
+        namespace Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            interface Cursors {
+                /**
+                 * Cursor to fetch the next page.
+                 */
+                after?: string | null;
+                /**
+                 * Cursor to fetch the previous page.
+                 */
+                before?: string | null;
+            }
+        }
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
     }
 }
 /**
@@ -376,11 +1032,11 @@ export interface WebhookRotateSecretResponse {
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookRotateSecretResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookRotateSecretResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -393,6 +1049,46 @@ export declare namespace WebhookRotateSecretResponse {
     interface Data {
         signing_secret?: string;
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 /**
  * Standard API response envelope for all v3 endpoints
@@ -405,11 +1101,11 @@ export interface WebhookTestResponse {
     /**
      * Error information
      */
-    error?: ErrorDetail | null;
+    error?: WebhookTestResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: APIMeta;
+    meta?: WebhookTestResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -423,6 +1119,135 @@ export declare namespace WebhookTestResponse {
         message?: string;
         success?: boolean;
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
+}
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface WebhookToggleStatusResponse {
+    /**
+     * The response data (null if error)
+     */
+    data?: WebhookToggleStatusResponse.Data | null;
+    /**
+     * Error information
+     */
+    error?: WebhookToggleStatusResponse.Error | null;
+    /**
+     * Request and response metadata
+     */
+    meta?: WebhookToggleStatusResponse.Meta;
+    /**
+     * Indicates whether the request was successful
+     */
+    success?: boolean;
+}
+export declare namespace WebhookToggleStatusResponse {
+    /**
+     * The response data (null if error)
+     */
+    interface Data {
+        id?: string;
+        consecutive_failures?: number;
+        created_at?: string;
+        /**
+         * Which customer owns this — the key's own, or the profile named in x-profile-id.
+         * Says whose resource this is, which the resource's own id does not.
+         */
+        customer_id?: string;
+        display_name?: string;
+        endpoint_url?: string;
+        event_filters?: {
+            [key: string]: Array<string>;
+        } | null;
+        event_types?: Array<string>;
+        is_active?: boolean;
+        last_delivery_attempt_at?: string | null;
+        last_successful_delivery_at?: string | null;
+        retry_count?: number;
+        signing_secret?: string | null;
+        timeout_seconds?: number;
+        updated_at?: string | null;
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 export interface WebhookCreateParams {
     /**
@@ -645,6 +1470,6 @@ export interface WebhookToggleStatusParams {
     'x-profile-id'?: string;
 }
 export declare namespace Webhooks {
-    export { type APIMeta as APIMeta, type APIResponseWebhook as APIResponseWebhook, type ErrorDetail as ErrorDetail, type MutationRequest as MutationRequest, type PaginationMeta as PaginationMeta, type WebhookEventType as WebhookEventType, type WebhookResponse as WebhookResponse, type WebhookListResponse as WebhookListResponse, type WebhookListEventTypesResponse as WebhookListEventTypesResponse, type WebhookListEventsResponse as WebhookListEventsResponse, type WebhookRotateSecretResponse as WebhookRotateSecretResponse, type WebhookTestResponse as WebhookTestResponse, type WebhookCreateParams as WebhookCreateParams, type WebhookRetrieveParams as WebhookRetrieveParams, type WebhookUpdateParams as WebhookUpdateParams, type WebhookListParams as WebhookListParams, type WebhookDeleteParams as WebhookDeleteParams, type WebhookListEventTypesParams as WebhookListEventTypesParams, type WebhookListEventsParams as WebhookListEventsParams, type WebhookRotateSecretParams as WebhookRotateSecretParams, type WebhookTestParams as WebhookTestParams, type WebhookToggleStatusParams as WebhookToggleStatusParams, };
+    export { type InboundMessageEvent as InboundMessageEvent, type InboundMessageEventPayload as InboundMessageEventPayload, type MessageEvent as MessageEvent, type MessageEventPayload as MessageEventPayload, type TemplateEvent as TemplateEvent, type TemplateEventPayload as TemplateEventPayload, type WebhookCreateResponse as WebhookCreateResponse, type WebhookRetrieveResponse as WebhookRetrieveResponse, type WebhookUpdateResponse as WebhookUpdateResponse, type WebhookListResponse as WebhookListResponse, type WebhookListEventTypesResponse as WebhookListEventTypesResponse, type WebhookListEventsResponse as WebhookListEventsResponse, type WebhookRotateSecretResponse as WebhookRotateSecretResponse, type WebhookTestResponse as WebhookTestResponse, type WebhookToggleStatusResponse as WebhookToggleStatusResponse, type WebhookCreateParams as WebhookCreateParams, type WebhookRetrieveParams as WebhookRetrieveParams, type WebhookUpdateParams as WebhookUpdateParams, type WebhookListParams as WebhookListParams, type WebhookDeleteParams as WebhookDeleteParams, type WebhookListEventTypesParams as WebhookListEventTypesParams, type WebhookListEventsParams as WebhookListEventsParams, type WebhookRotateSecretParams as WebhookRotateSecretParams, type WebhookTestParams as WebhookTestParams, type WebhookToggleStatusParams as WebhookToggleStatusParams, };
 }
 //# sourceMappingURL=webhooks.d.ts.map