@sentdm/sentdm 0.35.0 → 0.37.0

package/src/resources/webhooks.ts

@@ -20,10 +20,10 @@ export class Webhooks extends APIResource {
    *
    * @example
    * ```ts
-   * const webhook = await client.webhooks.create();
+   * const apiResponseWebhook = await client.webhooks.create();
    * ```
    */
-  create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<WebhookCreateResponse> {
+  create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<APIResponseWebhook> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.post('/v3/webhooks', {
       body,
@@ -43,7 +43,7 @@ export class Webhooks extends APIResource {
    *
    * @example
    * ```ts
-   * const webhook = await client.webhooks.retrieve(
+   * const apiResponseWebhook = await client.webhooks.retrieve(
    *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
    * );
    * ```
@@ -52,7 +52,7 @@ export class Webhooks extends APIResource {
     id: string,
     params: WebhookRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<WebhookRetrieveResponse> {
+  ): APIPromise<APIResponseWebhook> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/webhooks/${id}`, {
       ...options,
@@ -68,16 +68,12 @@ export class Webhooks extends APIResource {
    *
    * @example
    * ```ts
-   * const webhook = await client.webhooks.update(
+   * const apiResponseWebhook = await client.webhooks.update(
    *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
    * );
    * ```
    */
-  update(
-    id: string,
-    params: WebhookUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<WebhookUpdateResponse> {
+  update(id: string, params: WebhookUpdateParams, options?: RequestOptions): APIPromise<APIResponseWebhook> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.put(path`/v3/webhooks/${id}`, {
       body,
@@ -249,16 +245,17 @@ export class Webhooks extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.webhooks.toggleStatus(
-   *   'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
-   * );
+   * const apiResponseWebhook =
+   *   await client.webhooks.toggleStatus(
+   *     'd4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8',
+   *   );
    * ```
    */
   toggleStatus(
     id: string,
     params: WebhookToggleStatusParams,
     options?: RequestOptions,
-  ): APIPromise<WebhookToggleStatusResponse> {
+  ): APIPromise<APIResponseWebhook> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.patch(path`/v3/webhooks/${id}/toggle-status`, {
       body,
@@ -274,6 +271,76 @@ export class Webhooks extends APIResource {
   }
 }
 
+/**
+ * Request and response metadata
+ */
+export interface APIMeta {
+  /**
+   * 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 APIResponseWebhook {
+  /**
+   * The response data (null if error)
+   */
+  data?: WebhookResponse | null;
+
+  /**
+   * Error information
+   */
+  error?: ErrorDetail | null;
+
+  /**
+   * Request and response metadata
+   */
+  meta?: APIMeta;
+
+  /**
+   * Indicates whether the request was successful
+   */
+  success?: boolean;
+}
+
+/**
+ * Error information
+ */
+export interface ErrorDetail {
+  /**
+   * 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;
+}
+
 /**
  * The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
  * this shape and varies only in Payload.
@@ -311,6 +378,16 @@ export interface InboundMessageEvent {
  * numbers.
  */
 export interface InboundMessageEventPayload {
+  /**
+   * The contact's number in E.164 format, meaning the number the message came from.
+   */
+  inbound_number: string;
+
+  /**
+   * When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ).
+   */
+  received_at: string;
+
   /**
    * The account the message belongs to.
    */
@@ -321,11 +398,6 @@ export interface InboundMessageEventPayload {
    */
   channel?: string;
 
-  /**
-   * The contact's number in E.164 format, meaning the number the message came from.
-   */
-  inbound_number?: string;
-
   /**
    * The inbound message.
    */
@@ -336,11 +408,6 @@ export interface InboundMessageEventPayload {
    */
   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
@@ -394,6 +461,13 @@ export interface MessageEvent {
  * status.
  */
 export interface MessageEventPayload {
+  /**
+   * 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 account the message belongs to.
    */
@@ -416,13 +490,6 @@ export interface MessageEventPayload {
    */
   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.
    */
@@ -445,6 +512,66 @@ export interface MessageEventPayload {
   updated_at?: string;
 }
 
+export interface MutationRequest {
+  /**
+   * Sandbox flag - when true, the operation is simulated without side effects Useful
+   * for testing integrations without actual execution
+   */
+  sandbox?: boolean;
+}
+
+/**
+ * Pagination metadata for list responses
+ */
+export interface PaginationMeta {
+  /**
+   * @deprecated Cursor-based pagination. Never populated — see Cursors.
+   */
+  cursors?: PaginationMeta.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;
+}
+
+export namespace PaginationMeta {
+  /**
+   * @deprecated Cursor-based pagination. Never populated — see Cursors.
+   */
+  export interface Cursors {
+    /**
+     * Cursor to fetch the next page.
+     */
+    after?: string | null;
+
+    /**
+     * Cursor to fetch the previous page.
+     */
+    before?: string | null;
+  }
+}
+
 /**
  * The envelope Sent POSTs to a subscribed webhook endpoint. Every event shares
  * this shape and varies only in Payload.
@@ -482,6 +609,17 @@ export interface TemplateEvent {
  * changes, so you can react without polling.
  */
 export interface TemplateEventPayload {
+  /**
+   * The review status the template just reached, for example APPROVED or REJECTED.
+   */
+  status: string;
+
+  /**
+   * The template's identifier with Meta, assigned when the template is submitted for
+   * review.
+   */
+  whatsapp_template_id: string;
+
   /**
    * The account the template belongs to.
    */
@@ -508,11 +646,6 @@ export interface TemplateEventPayload {
    */
   reason?: string | null;
 
-  /**
-   * The review status the template just reached, for example APPROVED or REJECTED.
-   */
-  status?: string;
-
   /**
    * The template in Sent.
    */
@@ -522,32 +655,76 @@ export interface TemplateEventPayload {
    * The template's display name.
    */
   template_name?: 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;
 
   /**
-   * The template's identifier with Meta, assigned when the template is submitted for
-   * review.
+   * 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.
    */
-  whatsapp_template_id?: string;
+  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;
 }
 
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface WebhookCreateResponse {
+export interface WebhookListResponse {
   /**
-   * The response data (null if error)
+   * A paginated list of webhooks.
    */
-  data?: WebhookCreateResponse.Data | null;
+  data?: WebhookListResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhookCreateResponse.Error | null;
+  error?: ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhookCreateResponse.Meta;
+  meta?: APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -555,110 +732,83 @@ export interface WebhookCreateResponse {
   success?: boolean;
 }
 
-export namespace WebhookCreateResponse {
+export namespace WebhookListResponse {
   /**
-   * The response data (null if error)
+   * A paginated list of webhooks.
    */
   export 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.
+     * Pagination metadata for list responses
      */
-    customer_id?: string;
-
-    display_name?: string;
-
-    endpoint_url?: string;
+    pagination?: WebhooksAPI.PaginationMeta;
 
-    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;
+    /**
+     * The webhooks on this page.
+     */
+    webhooks?: Array<WebhooksAPI.WebhookResponse>;
   }
+}
+
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface WebhookListEventTypesResponse {
+  /**
+   * The webhook event types a customer can subscribe to.
+   */
+  data?: WebhookListEventTypesResponse.Data | null;
 
   /**
    * Error information
    */
-  export 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;
-  }
+  error?: ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
+  meta?: APIMeta;
+
+  /**
+   * Indicates whether the request was successful
+   */
+  success?: boolean;
+}
 
+export namespace WebhookListEventTypesResponse {
+  /**
+   * The webhook event types a customer can subscribe to.
+   */
+  export interface Data {
     /**
-     * Server timestamp when the response was generated
+     * The event_types on this page.
      */
-    timestamp?: string;
+    event_types?: Array<WebhooksAPI.WebhookEventType>;
 
     /**
-     * API version used for this request
+     * Pagination metadata for list responses
      */
-    version?: string;
+    pagination?: WebhooksAPI.PaginationMeta;
   }
 }
 
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface WebhookRetrieveResponse {
+export interface WebhookListEventsResponse {
   /**
-   * The response data (null if error)
+   * A paginated list of webhook delivery records.
    */
-  data?: WebhookRetrieveResponse.Data | null;
+  data?: WebhookListEventsResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhookRetrieveResponse.Error | null;
+  error?: ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhookRetrieveResponse.Meta;
+  meta?: APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -666,599 +816,45 @@ export interface WebhookRetrieveResponse {
   success?: boolean;
 }
 
-export namespace WebhookRetrieveResponse {
+export namespace WebhookListEventsResponse {
   /**
-   * The response data (null if error)
+   * A paginated list of webhook delivery records.
    */
   export interface Data {
-    id?: string;
-
-    consecutive_failures?: number;
-
-    created_at?: string;
+    /**
+     * The events on this page.
+     */
+    events?: Array<Data.Event>;
 
     /**
-     * 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.
+     * Pagination metadata for list responses
      */
-    customer_id?: string;
+    pagination?: WebhooksAPI.PaginationMeta;
+  }
 
-    display_name?: string;
+  export namespace Data {
+    export interface Event {
+      id?: string;
 
-    endpoint_url?: string;
+      created_at?: string;
 
-    event_filters?: { [key: string]: Array<string> } | null;
+      delivery_attempts?: number;
 
-    event_types?: Array<string>;
+      delivery_status?: string;
 
-    is_active?: boolean;
+      error_message?: string | null;
 
-    last_delivery_attempt_at?: string | null;
+      /**
+       * 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;
 
-    last_successful_delivery_at?: string | null;
+      event_type?: string;
 
-    retry_count?: number;
-
-    signing_secret?: string | null;
-
-    timeout_seconds?: number;
-
-    updated_at?: string | null;
-  }
-
-  /**
-   * Error information
-   */
-  export 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
-   */
-  export 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 WebhookUpdateResponse {
-  /**
-   * The response data (null if error)
-   */
-  data?: WebhookUpdateResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: WebhookUpdateResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: WebhookUpdateResponse.Meta;
-
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
-
-export namespace WebhookUpdateResponse {
-  /**
-   * The response data (null if error)
-   */
-  export 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
-   */
-  export 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
-   */
-  export 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 WebhookListResponse {
-  /**
-   * A paginated list of webhooks.
-   */
-  data?: WebhookListResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: WebhookListResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: WebhookListResponse.Meta;
-
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
-
-export namespace WebhookListResponse {
-  /**
-   * A paginated list of webhooks.
-   */
-  export interface Data {
-    /**
-     * Pagination metadata for list responses
-     */
-    pagination?: Data.Pagination;
-
-    /**
-     * The webhooks on this page.
-     */
-    webhooks?: Array<Data.Webhook>;
-  }
-
-  export namespace Data {
-    /**
-     * Pagination metadata for list responses
-     */
-    export 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;
-    }
-
-    export namespace Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      export interface Cursors {
-        /**
-         * Cursor to fetch the next page.
-         */
-        after?: string | null;
-
-        /**
-         * Cursor to fetch the previous page.
-         */
-        before?: string | null;
-      }
-    }
-
-    export 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
-   */
-  export 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
-   */
-  export 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 WebhookListEventTypesResponse {
-  /**
-   * The webhook event types a customer can subscribe to.
-   */
-  data?: WebhookListEventTypesResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: WebhookListEventTypesResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: WebhookListEventTypesResponse.Meta;
-
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
-
-export namespace WebhookListEventTypesResponse {
-  /**
-   * The webhook event types a customer can subscribe to.
-   */
-  export interface Data {
-    /**
-     * The event_types on this page.
-     */
-    event_types?: Array<Data.EventType>;
-
-    /**
-     * Pagination metadata for list responses
-     */
-    pagination?: Data.Pagination;
-  }
-
-  export namespace Data {
-    export 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
-     */
-    export 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;
-    }
-
-    export namespace Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      export interface Cursors {
-        /**
-         * Cursor to fetch the next page.
-         */
-        after?: string | null;
-
-        /**
-         * Cursor to fetch the previous page.
-         */
-        before?: string | null;
-      }
-    }
-  }
-
-  /**
-   * Error information
-   */
-  export 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
-   */
-  export 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 WebhookListEventsResponse {
-  /**
-   * A paginated list of webhook delivery records.
-   */
-  data?: WebhookListEventsResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: WebhookListEventsResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: WebhookListEventsResponse.Meta;
-
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
-
-export namespace WebhookListEventsResponse {
-  /**
-   * A paginated list of webhook delivery records.
-   */
-  export interface Data {
-    /**
-     * The events on this page.
-     */
-    events?: Array<Data.Event>;
-
-    /**
-     * Pagination metadata for list responses
-     */
-    pagination?: Data.Pagination;
-  }
-
-  export namespace Data {
-    export interface Event {
-      id?: string;
-
-      created_at?: string;
-
-      delivery_attempts?: number;
-
-      delivery_status?: string;
-
-      error_message?: string | null;
-
-      /**
-       * 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;
+      http_status_code?: number | null;
 
       processing_completed_at?: string | null;
 
@@ -1266,103 +862,6 @@ export namespace WebhookListEventsResponse {
 
       response_body?: string | null;
     }
-
-    /**
-     * Pagination metadata for list responses
-     */
-    export 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;
-    }
-
-    export namespace Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      export interface Cursors {
-        /**
-         * Cursor to fetch the next page.
-         */
-        after?: string | null;
-
-        /**
-         * Cursor to fetch the previous page.
-         */
-        before?: string | null;
-      }
-    }
-  }
-
-  /**
-   * Error information
-   */
-  export 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
-   */
-  export 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;
   }
 }
 
@@ -1378,12 +877,12 @@ export interface WebhookRotateSecretResponse {
   /**
    * Error information
    */
-  error?: WebhookRotateSecretResponse.Error | null;
+  error?: ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhookRotateSecretResponse.Meta;
+  meta?: APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -1398,51 +897,6 @@ export namespace WebhookRotateSecretResponse {
   export interface Data {
     signing_secret?: string;
   }
-
-  /**
-   * Error information
-   */
-  export 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
-   */
-  export 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;
-  }
 }
 
 /**
@@ -1457,12 +911,12 @@ export interface WebhookTestResponse {
   /**
    * Error information
    */
-  error?: WebhookTestResponse.Error | null;
+  error?: ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhookTestResponse.Meta;
+  meta?: APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -1479,162 +933,6 @@ export namespace WebhookTestResponse {
 
     success?: boolean;
   }
-
-  /**
-   * Error information
-   */
-  export 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
-   */
-  export 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 namespace WebhookToggleStatusResponse {
-  /**
-   * The response data (null if error)
-   */
-  export 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
-   */
-  export 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
-   */
-  export 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 {
@@ -1896,21 +1194,24 @@ export interface WebhookToggleStatusParams {
 
 export declare namespace Webhooks {
   export {
+    type APIMeta as APIMeta,
+    type APIResponseWebhook as APIResponseWebhook,
+    type ErrorDetail as ErrorDetail,
     type InboundMessageEvent as InboundMessageEvent,
     type InboundMessageEventPayload as InboundMessageEventPayload,
     type MessageEvent as MessageEvent,
     type MessageEventPayload as MessageEventPayload,
+    type MutationRequest as MutationRequest,
+    type PaginationMeta as PaginationMeta,
     type TemplateEvent as TemplateEvent,
     type TemplateEventPayload as TemplateEventPayload,
-    type WebhookCreateResponse as WebhookCreateResponse,
-    type WebhookRetrieveResponse as WebhookRetrieveResponse,
-    type WebhookUpdateResponse as WebhookUpdateResponse,
+    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 WebhookToggleStatusResponse as WebhookToggleStatusResponse,
     type WebhookCreateParams as WebhookCreateParams,
     type WebhookRetrieveParams as WebhookRetrieveParams,
     type WebhookUpdateParams as WebhookUpdateParams,