@zapier/zapier-sdk 0.48.1 → 0.50.0

package/README.md

@@ -12,10 +12,10 @@
   - [`getProfile`](#getprofile)
 - [Actions](#actions)
   - [`getAction`](#getaction)
-  - [`getInputFieldsSchema`](#getinputfieldsschema)
+  - [`getActionInputFieldsSchema`](#getactioninputfieldsschema)
+  - [`listActionInputFieldChoices`](#listactioninputfieldchoices)
+  - [`listActionInputFields`](#listactioninputfields)
   - [`listActions`](#listactions)
-  - [`listInputFieldChoices`](#listinputfieldchoices)
-  - [`listInputFields`](#listinputfields)
   - [`runAction`](#runaction)
 - [Apps](#apps)
   - [`apps.{appKey}`](#appsappkey)
@@ -46,6 +46,24 @@
   - [`listTableRecords`](#listtablerecords)
   - [`listTables`](#listtables)
   - [`updateTableRecords`](#updatetablerecords)
+- [Triggers (Experimental)](#triggers-experimental)
+  - [`ackTriggerInboxMessages`](#acktriggerinboxmessages--experimental)
+  - [`createTriggerInbox`](#createtriggerinbox--experimental)
+  - [`deleteTriggerInbox`](#deletetriggerinbox--experimental)
+  - [`drainTriggerInbox`](#draintriggerinbox--experimental)
+  - [`ensureTriggerInbox`](#ensuretriggerinbox--experimental)
+  - [`getTriggerInbox`](#gettriggerinbox--experimental)
+  - [`getTriggerInputFieldsSchema`](#gettriggerinputfieldsschema--experimental)
+  - [`leaseTriggerInboxMessages`](#leasetriggerinboxmessages--experimental)
+  - [`listTriggerInboxMessages`](#listtriggerinboxmessages--experimental)
+  - [`listTriggerInboxes`](#listtriggerinboxes--experimental)
+  - [`listTriggerInputFieldChoices`](#listtriggerinputfieldchoices--experimental)
+  - [`listTriggerInputFields`](#listtriggerinputfields--experimental)
+  - [`pauseTriggerInbox`](#pausetriggerinbox--experimental)
+  - [`releaseTriggerInboxMessages`](#releasetriggerinboxmessages--experimental)
+  - [`resumeTriggerInbox`](#resumetriggerinbox--experimental)
+  - [`updateTriggerInbox`](#updatetriggerinbox--experimental)
+  - [`watchTriggerInbox`](#watchtriggerinbox--experimental)
 
 ## Documentation
 
@@ -311,17 +329,20 @@ console.log(emojiData.emoji);
 
 The `createZapierSdk(...)` factory function is the main entry point for the SDK. It provides methods for managing connections, listing apps, running actions, and more.
 
-| Name                          | Type                       | Required | Default | Possible Values | Description                                                                                                                                                                                   |
-| ----------------------------- | -------------------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `credentials`                 | `string, object, function` | ❌       | —       | —               | Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those. |
-| `debug`                       | `boolean`                  | ❌       | —       | —               | Enable debug logging.                                                                                                                                                                         |
-| `baseUrl`                     | `string`                   | ❌       | —       | —               | Base URL for Zapier API endpoints.                                                                                                                                                            |
-| `trackingBaseUrl`             | `string`                   | ❌       | —       | —               | Base URL for Zapier tracking endpoints.                                                                                                                                                       |
-| `maxNetworkRetries`           | `number`                   | ❌       | —       | —               | Max retries for rate-limited requests (default: 3).                                                                                                                                           |
-| `maxNetworkRetryDelayMs`      | `number`                   | ❌       | —       | —               | Max delay in ms to wait for retry (default: 60000).                                                                                                                                           |
-| `canIncludeSharedConnections` | `boolean`                  | ❌       | —       | —               | Allow listing shared connections.                                                                                                                                                             |
-| `canIncludeSharedTables`      | `boolean`                  | ❌       | —       | —               | Allow listing shared tables.                                                                                                                                                                  |
-| `canDeleteTables`             | `boolean`                  | ❌       | —       | —               | Allow deleting tables.                                                                                                                                                                        |
+| Name                          | Type                       | Required | Default | Possible Values             | Description                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ----------------------------- | -------------------------- | -------- | ------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `credentials`                 | `string, object, function` | ❌       | —       | —                           | Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those.                                                                                                                                                                                                                                       |
+| `debug`                       | `boolean`                  | ❌       | —       | —                           | Enable debug logging.                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `baseUrl`                     | `string`                   | ❌       | —       | —                           | Base URL for Zapier API endpoints.                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `trackingBaseUrl`             | `string`                   | ❌       | —       | —                           | Base URL for Zapier tracking endpoints.                                                                                                                                                                                                                                                                                                                                                                                             |
+| `maxNetworkRetries`           | `number`                   | ❌       | —       | —                           | Max retries for rate-limited requests (default: 3).                                                                                                                                                                                                                                                                                                                                                                                 |
+| `maxNetworkRetryDelayMs`      | `number`                   | ❌       | —       | —                           | Max delay in ms to wait for retry (default: 60000).                                                                                                                                                                                                                                                                                                                                                                                 |
+| `approvalTimeoutMs`           | `number`                   | ❌       | —       | —                           | Timeout in ms for approval polling. Default: 600000 (10 min).                                                                                                                                                                                                                                                                                                                                                                       |
+| `maxApprovalRetries`          | `number`                   | ❌       | —       | —                           | Maximum number of sequential approval rounds per request (one per gating policy) before giving up. Default: 2.                                                                                                                                                                                                                                                                                                                      |
+| `approvalMode`                | `string`                   | ❌       | —       | `disabled`, `poll`, `throw` | Approval flow behavior. "disabled" (default) throws a ZapierApprovalError on approval-required responses without creating an approval. "poll" creates the approval, opens it in a browser, polls until resolved, and retries the original request. "throw" creates the approval and throws a ZapierApprovalError with the approval URL so the caller can surface it. Defaults to the ZAPIER_APPROVAL_MODE env var, then "disabled". |
+| `canIncludeSharedConnections` | `boolean`                  | ❌       | —       | —                           | Allow listing shared connections.                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `canIncludeSharedTables`      | `boolean`                  | ❌       | —       | —                           | Allow listing shared tables.                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `canDeleteTables`             | `boolean`                  | ❌       | —       | —                           | Allow deleting tables.                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 ## Named Connections
 
@@ -452,7 +473,7 @@ const { data: action } = await zapier.getAction({
 });
 ```
 
-#### `getInputFieldsSchema`
+#### `getActionInputFieldsSchema`
 
 Get the JSON Schema representation of input fields for an action. Returns a JSON Schema object describing the structure, types, and validation rules for the action's input parameters.
 
@@ -472,71 +493,14 @@ Get the JSON Schema representation of input fields for an action. Returns a JSON
 **Example:**
 
 ```typescript
-const { data: inputSchema } = await zapier.getInputFieldsSchema({
+const { data: inputSchema } = await zapier.getActionInputFieldsSchema({
   app: "example-app",
   actionType: "read",
   action: "example-action",
 });
 ```
 
-#### `listActions`
-
-List all actions for a specific app
-
-**Parameters:**
-
-| Name             | Type     | Required | Default | Possible Values                                                                                | Description                                                            |
-| ---------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| `options`        | `object` | ✅       | —       | —                                                                                              |                                                                        |
-| ​ ↳ `app`        | `string` | ✅       | —       | —                                                                                              | App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github') |
-| ​ ↳ `actionType` | `string` | ❌       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Filter actions by type                                                 |
-| ​ ↳ `pageSize`   | `number` | ❌       | —       | —                                                                                              | Number of actions per page                                             |
-| ​ ↳ `maxItems`   | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                         |
-| ​ ↳ `cursor`     | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                                   |
-
-**Returns:** `Promise<PaginatedResult<ActionItem>>`
-
-| Name               | Type       | Required | Possible Values                                                                                | Description                                                    |
-| ------------------ | ---------- | -------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
-| `data[]`           | `object[]` | ✅       | —                                                                                              |                                                                |
-| ​ ↳ `id`           | `string`   | ❌       | —                                                                                              |                                                                |
-| ​ ↳ `key`          | `string`   | ✅       | —                                                                                              |                                                                |
-| ​ ↳ `description`  | `string`   | ✅       | —                                                                                              |                                                                |
-| ​ ↳ `is_important` | `boolean`  | ❌       | —                                                                                              |                                                                |
-| ​ ↳ `is_hidden`    | `boolean`  | ❌       | —                                                                                              |                                                                |
-| ​ ↳ `app_key`      | `string`   | ✅       | —                                                                                              |                                                                |
-| ​ ↳ `app_version`  | `string`   | ❌       | —                                                                                              |                                                                |
-| ​ ↳ `action_type`  | `string`   | ✅       | `filter`, `read`, `read_bulk`, `run`, `search`, `search_and_write`, `search_or_write`, `write` |                                                                |
-| ​ ↳ `title`        | `string`   | ✅       | —                                                                                              |                                                                |
-| ​ ↳ `type`         | `string`   | ✅       | `action`                                                                                       |                                                                |
-| `nextCursor`       | `string`   | ❌       | —                                                                                              | Cursor for the next page; omitted when there are no more pages |
-
-**Example:**
-
-```typescript
-// Get first page and a cursor for the second page
-const { data: actions, nextCursor } = await zapier.listActions({
-  app: "example-app",
-});
-
-// Or iterate over all pages
-for await (const page of zapier.listActions({
-  app: "example-app",
-})) {
-  // Do something with each page
-}
-
-// Or iterate over individual items across all pages
-for await (const action of zapier
-  .listActions({
-    app: "example-app",
-  })
-  .items()) {
-  // Do something with each action
-}
-```
-
-#### `listInputFieldChoices`
+#### `listActionInputFieldChoices`
 
 Get the available choices for a dynamic dropdown input field
 
@@ -572,7 +536,7 @@ Get the available choices for a dynamic dropdown input field
 ```typescript
 // Get first page and a cursor for the second page
 const { data: inputFieldChoices, nextCursor } =
-  await zapier.listInputFieldChoices({
+  await zapier.listActionInputFieldChoices({
     app: "example-app",
     actionType: "read",
     action: "example-action",
@@ -580,7 +544,7 @@ const { data: inputFieldChoices, nextCursor } =
   });
 
 // Or iterate over all pages
-for await (const page of zapier.listInputFieldChoices({
+for await (const page of zapier.listActionInputFieldChoices({
   app: "example-app",
   actionType: "read",
   action: "example-action",
@@ -591,7 +555,7 @@ for await (const page of zapier.listInputFieldChoices({
 
 // Or iterate over individual items across all pages
 for await (const inputFieldChoice of zapier
-  .listInputFieldChoices({
+  .listActionInputFieldChoices({
     app: "example-app",
     actionType: "read",
     action: "example-action",
@@ -602,7 +566,7 @@ for await (const inputFieldChoice of zapier
 }
 ```
 
-#### `listInputFields`
+#### `listActionInputFields`
 
 Get the input fields required for a specific action
 
@@ -667,14 +631,14 @@ Get the input fields required for a specific action
 
 ```typescript
 // Get first page and a cursor for the second page
-const { data: rootFields, nextCursor } = await zapier.listInputFields({
+const { data: rootFields, nextCursor } = await zapier.listActionInputFields({
   app: "example-app",
   actionType: "read",
   action: "example-action",
 });
 
 // Or iterate over all pages
-for await (const page of zapier.listInputFields({
+for await (const page of zapier.listActionInputFields({
   app: "example-app",
   actionType: "read",
   action: "example-action",
@@ -684,7 +648,7 @@ for await (const page of zapier.listInputFields({
 
 // Or iterate over individual items across all pages
 for await (const rootField of zapier
-  .listInputFields({
+  .listActionInputFields({
     app: "example-app",
     actionType: "read",
     action: "example-action",
@@ -694,6 +658,63 @@ for await (const rootField of zapier
 }
 ```
 
+#### `listActions`
+
+List all actions for a specific app
+
+**Parameters:**
+
+| Name             | Type     | Required | Default | Possible Values                                                                                | Description                                                            |
+| ---------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| `options`        | `object` | ✅       | —       | —                                                                                              |                                                                        |
+| ​ ↳ `app`        | `string` | ✅       | —       | —                                                                                              | App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github') |
+| ​ ↳ `actionType` | `string` | ❌       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Filter actions by type                                                 |
+| ​ ↳ `pageSize`   | `number` | ❌       | —       | —                                                                                              | Number of actions per page                                             |
+| ​ ↳ `maxItems`   | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                         |
+| ​ ↳ `cursor`     | `string` | ❌       | —       | —                                                                                              | Cursor to start from                                                   |
+
+**Returns:** `Promise<PaginatedResult<ActionItem>>`
+
+| Name               | Type       | Required | Possible Values                                                                                | Description                                                    |
+| ------------------ | ---------- | -------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `data[]`           | `object[]` | ✅       | —                                                                                              |                                                                |
+| ​ ↳ `id`           | `string`   | ❌       | —                                                                                              |                                                                |
+| ​ ↳ `key`          | `string`   | ✅       | —                                                                                              |                                                                |
+| ​ ↳ `description`  | `string`   | ✅       | —                                                                                              |                                                                |
+| ​ ↳ `is_important` | `boolean`  | ❌       | —                                                                                              |                                                                |
+| ​ ↳ `is_hidden`    | `boolean`  | ❌       | —                                                                                              |                                                                |
+| ​ ↳ `app_key`      | `string`   | ✅       | —                                                                                              |                                                                |
+| ​ ↳ `app_version`  | `string`   | ❌       | —                                                                                              |                                                                |
+| ​ ↳ `action_type`  | `string`   | ✅       | `filter`, `read`, `read_bulk`, `run`, `search`, `search_and_write`, `search_or_write`, `write` |                                                                |
+| ​ ↳ `title`        | `string`   | ✅       | —                                                                                              |                                                                |
+| ​ ↳ `type`         | `string`   | ✅       | `action`                                                                                       |                                                                |
+| `nextCursor`       | `string`   | ❌       | —                                                                                              | Cursor for the next page; omitted when there are no more pages |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: actions, nextCursor } = await zapier.listActions({
+  app: "example-app",
+});
+
+// Or iterate over all pages
+for await (const page of zapier.listActions({
+  app: "example-app",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const action of zapier
+  .listActions({
+    app: "example-app",
+  })
+  .items()) {
+  // Do something with each action
+}
+```
+
 #### `runAction`
 
 Execute an action with the given inputs
@@ -1768,3 +1789,733 @@ const result = await zapier.updateTableRecords({
   ],
 });
 ```
+
+### Triggers (Experimental)
+
+> Experimental. Import from `"@zapier/zapier-sdk/experimental"` to use these methods. Methods and behavior may change, and availabilitiy may be limited to some users.
+
+#### `ackTriggerInboxMessages` 🧪 _experimental_
+
+Acknowledge messages from a lease. Acked messages are removed from the inbox; unacked ones return to the available pool when the lease expires.
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description                                                                                                |
+| -------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox`    | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+| ​ ↳ `lease`    | `string` | ✅       | —       | —               | Lease ID returned from leaseTriggerInboxMessages                                                           |
+| ​ ↳ `messages` | `array`  | ❌       | —       | —               | Specific message IDs to ack. Omit to ack every message in the lease.                                       |
+
+**Returns:** `Promise<TriggerInboxAckItem>`
+
+| Name                              | Type       | Required | Possible Values                               | Description              |
+| --------------------------------- | ---------- | -------- | --------------------------------------------- | ------------------------ |
+| `data`                            | `object`   | ✅       | —                                             |                          |
+| ​ ↳ `acked_id`                    | `string`   | ✅       | —                                             |                          |
+| ​ ↳ `results[]`                   | `object[]` | ✅       | —                                             |                          |
+| ​   ↳ `id`                        | `string`   | ✅       | —                                             |                          |
+| ​   ↳ `created_at`                | `string`   | ✅       | —                                             |                          |
+| ​   ↳ `status`                    | `string`   | ✅       | `available`, `leased`, `acked`, `quarantined` | Message lifecycle status |
+| ​   ↳ `message_attributes`        | `object`   | ✅       | —                                             |                          |
+| ​     ↳ `lease_count`             | `number`   | ✅       | —                                             |                          |
+| ​     ↳ `error_message`           | `string`   | ✅       | —                                             |                          |
+| ​     ↳ `possible_duplicate_data` | `boolean`  | ✅       | —                                             |                          |
+
+**Example:**
+
+```typescript
+const result = await zapier.ackTriggerInboxMessages({
+  inbox: "example-inbox",
+  lease: "example-lease",
+});
+```
+
+#### `createTriggerInbox` 🧪 _experimental_
+
+Create a new trigger inbox subscription with an auto-generated name. Always creates; use ensureTriggerInbox for get-or-create on a stable name.
+
+**Parameters:**
+
+| Name                  | Type             | Required | Default | Possible Values | Description                                                                                                  |
+| --------------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
+| `options`             | `object`         | ✅       | —       | —               |                                                                                                              |
+| ​ ↳ `app`             | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3') |
+| ​ ↳ `action`          | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                              |
+| ​ ↳ `connection`      | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Optional for triggers that don't require auth.                            |
+| ​ ↳ `inputs`          | `object`         | ❌       | —       | —               | Input parameters for the trigger subscription                                                                |
+| ​ ↳ `notificationUrl` | `string`         | ❌       | —       | —               | Webhook URL to POST to when new messages arrive                                                              |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.createTriggerInbox({
+  app: "example-app",
+  action: "example-action",
+});
+```
+
+#### `deleteTriggerInbox` 🧪 _experimental_
+
+Mark a trigger inbox for deletion
+
+**Parameters:**
+
+| Name        | Type     | Required | Default | Possible Values | Description                                                                                                |
+| ----------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`   | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox` | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+
+**Returns:** `Promise<{ success: boolean }>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.deleteTriggerInbox({
+  inbox: "example-inbox",
+});
+```
+
+#### `drainTriggerInbox` 🧪 _experimental_
+
+Drain an existing trigger inbox: lease currently-available messages, process each via onMessage, return when the inbox is empty, maxMessages is reached, or the abort signal fires.
+
+**Parameters:**
+
+| Name                  | Type       | Required | Default | Possible Values | Description                                                                                                                                                                                                                 |
+| --------------------- | ---------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`             | `object`   | ✅       | —       | —               |                                                                                                                                                                                                                             |
+| ​ ↳ `inbox`           | `string`   | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint.                                                                                                                  |
+| ​ ↳ `onMessage`       | `function` | ❌       | —       | —               | Per-message handler. Resolves to ack; rejects to release-or-leave per `releaseOnError`. Throw `ZapierReleaseTriggerMessageSignal` to release explicitly, or `ZapierAbortDrainSignal` to stop after the current batch.       |
+| ​ ↳ `concurrency`     | `number`   | ❌       | —       | —               | Per-message handler workers running in parallel. Defaults to `leaseLimit`, or 1 if neither is set.                                                                                                                          |
+| ​ ↳ `leaseLimit`      | `number`   | ❌       | —       | —               | Per-lease HTTP batch size. Defaults to `concurrency`, or 1 if neither is set.                                                                                                                                               |
+| ​ ↳ `leaseSeconds`    | `number`   | ❌       | —       | —               | Seconds until the lease expires; messages return to available if not acked. API default is 300 (5 minutes).                                                                                                                 |
+| ​ ↳ `releaseOnError`  | `boolean`  | ❌       | —       | —               | If true, errors immediately release the message. If false (default), errors leave it leased until the lease timeout. `ZapierReleaseTriggerMessageSignal` always releases regardless.                                        |
+| ​ ↳ `continueOnError` | `boolean`  | ❌       | —       | —               | If false (default, fail-fast), the first handler error rejects and stops the drain. If true, handler errors are observed via `onError` and the drain continues. SDK-level errors (lease / ack / release) reject regardless. |
+| ​ ↳ `onError`         | `function` | ❌       | —       | —               | Per-message error observer for `continueOnError: true`. Called with the failure and the message; control-flow signals are filtered out. Throws from `onError` are swallowed.                                                |
+| ​ ↳ `signal`          | `any`      | ❌       | —       | —               | Abort signal. Aborting cancels in-flight HTTP, releases unprocessed messages, and resolves cleanly. Errors during shutdown still reject.                                                                                    |
+| ​ ↳ `maxMessages`     | `number`   | ❌       | —       | —               | Cap total messages drained. Defaults to draining the inbox until empty.                                                                                                                                                     |
+
+**Returns:** `Promise<void>`
+
+**Example:**
+
+```typescript
+const result = await zapier.drainTriggerInbox({
+  inbox: "example-inbox",
+  onMessage: async (message) => {
+    /* process message */
+  },
+});
+```
+
+#### `ensureTriggerInbox` 🧪 _experimental_
+
+Get-or-create a trigger inbox by name. Idempotent on (user, account, name): returns the existing inbox if a matching subscription is registered, creates a new one otherwise. Throws ZapierConflictError if the name exists with a different subscription.
+
+**Parameters:**
+
+| Name                  | Type             | Required | Default | Possible Values | Description                                                                                                                                                             |
+| --------------------- | ---------------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`             | `object`         | ✅       | —       | —               |                                                                                                                                                                         |
+| ​ ↳ `name`            | `string`         | ✅       | —       | —               | Inbox name; serves as the idempotency key. Required for ensureTriggerInbox — without one, the API mints a fresh inbox each call (use createTriggerInbox for that path). |
+| ​ ↳ `app`             | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3')                                                            |
+| ​ ↳ `action`          | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                                                                                         |
+| ​ ↳ `connection`      | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Optional for triggers that don't require auth.                                                                                       |
+| ​ ↳ `inputs`          | `object`         | ❌       | —       | —               | Input parameters for the trigger subscription                                                                                                                           |
+| ​ ↳ `notificationUrl` | `string`         | ❌       | —       | —               | Webhook URL to POST to when new messages arrive                                                                                                                         |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.ensureTriggerInbox({
+  name: "example-name",
+  app: "example-app",
+  action: "example-action",
+});
+```
+
+#### `getTriggerInbox` 🧪 _experimental_
+
+Get details of a trigger inbox by ID
+
+**Parameters:**
+
+| Name        | Type     | Required | Default | Possible Values | Description                                                                                                |
+| ----------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`   | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox` | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const { data: triggerInbox } = await zapier.getTriggerInbox({
+  inbox: "example-inbox",
+});
+```
+
+#### `getTriggerInputFieldsSchema` 🧪 _experimental_
+
+Get the JSON Schema representation of input fields for a trigger. Returns a JSON Schema object describing the structure, types, and validation rules for the trigger's input parameters.
+
+**Parameters:**
+
+| Name             | Type             | Required | Default | Possible Values | Description                                                                                                  |
+| ---------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
+| `options`        | `object`         | ✅       | —       | —               |                                                                                                              |
+| ​ ↳ `app`        | `string`         | ✅       | —       | —               | App key (e.g., 'SlackCLIAPI' or slug like 'github') to get the input schema for                              |
+| ​ ↳ `action`     | `string`         | ✅       | —       | —               | Trigger action key to get the input schema for                                                               |
+| ​ ↳ `connection` | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Required if the trigger needs a connection to determine available fields. |
+| ​ ↳ `inputs`     | `object`         | ❌       | —       | —               | Current input values that may affect the schema (e.g., when fields depend on other field values)             |
+
+**Returns:** `Promise<any>`
+
+**Example:**
+
+```typescript
+const result = await zapier.getTriggerInputFieldsSchema({
+  app: "example-app",
+  action: "example-action",
+});
+```
+
+#### `leaseTriggerInboxMessages` 🧪 _experimental_
+
+Lease up to N messages from a trigger inbox. Returns messages plus a lease ID; ack within the lease window to remove from the inbox.
+
+**Parameters:**
+
+| Name               | Type     | Required | Default | Possible Values | Description                                                                                                        |
+| ------------------ | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `options`          | `object` | ✅       | —       | —               |                                                                                                                    |
+| ​ ↳ `inbox`        | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint.         |
+| ​ ↳ `leaseLimit`   | `number` | ❌       | —       | —               | Maximum messages to lease in a single batch (1-100)                                                                |
+| ​ ↳ `leaseSeconds` | `number` | ❌       | —       | —               | Seconds until the lease expires; messages return to available if not acked. API default is 300 (5 minutes).        |
+| ​ ↳ `signal`       | `any`    | ❌       | —       | —               | Abort signal forwarded to the lease HTTP request. Aborting causes the in-flight request to reject with AbortError. |
+
+**Returns:** `Promise<TriggerInboxLeaseItem>`
+
+| Name                              | Type       | Required | Possible Values                                                                                                                                                 | Description                             |
+| --------------------------------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                            | `object`   | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `lease_id`                    | `string`   | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `leased_until`                | `string`   | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `results[]`                   | `object[]` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `id`                        | `string`   | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `created_at`                | `string`   | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `status`                    | `string`   | ✅       | `available`, `leased`, `acked`, `quarantined`                                                                                                                   | Message lifecycle status                |
+| ​   ↳ `message_attributes`        | `object`   | ✅       | —                                                                                                                                                               |                                         |
+| ​     ↳ `lease_count`             | `number`   | ✅       | —                                                                                                                                                               |                                         |
+| ​     ↳ `error_message`           | `string`   | ✅       | —                                                                                                                                                               |                                         |
+| ​     ↳ `possible_duplicate_data` | `boolean`  | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `payload`                   | `object`   | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `inbox_attributes`            | `object`   | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `status`                    | `string`   | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​   ↳ `paused_reason`             | `string`   | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+
+**Example:**
+
+```typescript
+const result = await zapier.leaseTriggerInboxMessages({
+  inbox: "example-inbox",
+});
+```
+
+#### `listTriggerInboxMessages` 🧪 _experimental_
+
+List messages in a trigger inbox (no payload, status-only)
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description                                                                                                |
+| -------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox`    | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+| ​ ↳ `pageSize` | `number` | ❌       | —       | —               | Number of messages per page                                                                                |
+| ​ ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total items to return across all pages                                                             |
+| ​ ↳ `cursor`   | `string` | ❌       | —       | —               | Pagination cursor                                                                                          |
+
+**Returns:** `Promise<PaginatedResult<TriggerMessageItem>>`
+
+| Name                            | Type       | Required | Possible Values                               | Description                                                    |
+| ------------------------------- | ---------- | -------- | --------------------------------------------- | -------------------------------------------------------------- |
+| `data[]`                        | `object[]` | ✅       | —                                             |                                                                |
+| ​ ↳ `id`                        | `string`   | ✅       | —                                             |                                                                |
+| ​ ↳ `created_at`                | `string`   | ✅       | —                                             |                                                                |
+| ​ ↳ `status`                    | `string`   | ✅       | `available`, `leased`, `acked`, `quarantined` | Message lifecycle status                                       |
+| ​ ↳ `message_attributes`        | `object`   | ✅       | —                                             |                                                                |
+| ​   ↳ `lease_count`             | `number`   | ✅       | —                                             |                                                                |
+| ​   ↳ `error_message`           | `string`   | ✅       | —                                             |                                                                |
+| ​   ↳ `possible_duplicate_data` | `boolean`  | ✅       | —                                             |                                                                |
+| `nextCursor`                    | `string`   | ❌       | —                                             | Cursor for the next page; omitted when there are no more pages |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: triggerMessages, nextCursor } =
+  await zapier.listTriggerInboxMessages({
+    inbox: "example-inbox",
+  });
+
+// Or iterate over all pages
+for await (const page of zapier.listTriggerInboxMessages({
+  inbox: "example-inbox",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const triggerMessage of zapier
+  .listTriggerInboxMessages({
+    inbox: "example-inbox",
+  })
+  .items()) {
+  // Do something with each triggerMessage
+}
+```
+
+#### `listTriggerInboxes` 🧪 _experimental_
+
+List all trigger inboxes for the authenticated user
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values                                                          | Description                                                                                                  |
+| -------------- | -------- | -------- | ------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `options`      | `object` | ✅       | —       | —                                                                        |                                                                                                              |
+| ​ ↳ `name`     | `string` | ❌       | —       | —                                                                        | Filter by inbox name (exact match). Names are unique per (user, account), so this returns at most one inbox. |
+| ​ ↳ `status`   | `string` | ❌       | —       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure` | Filter by inbox status                                                                                       |
+| ​ ↳ `pageSize` | `number` | ❌       | —       | —                                                                        | Number of inboxes per page                                                                                   |
+| ​ ↳ `maxItems` | `number` | ❌       | —       | —                                                                        | Maximum total items to return across all pages                                                               |
+| ​ ↳ `cursor`   | `string` | ❌       | —       | —                                                                        | Cursor (offset) to start from for pagination                                                                 |
+
+**Returns:** `Promise<PaginatedResult<TriggerInboxItem>>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                                                    |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `data[]`               | `object[]`       | ✅       | —                                                                                                                                                               |                                                                |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                                         |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable                        |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                                                |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                                                |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                                                |
+| `nextCursor`           | `string`         | ❌       | —                                                                                                                                                               | Cursor for the next page; omitted when there are no more pages |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: triggerInboxs, nextCursor } = await zapier.listTriggerInboxes();
+
+// Or iterate over all pages
+for await (const page of zapier.listTriggerInboxes()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const triggerInbox of zapier.listTriggerInboxes().items()) {
+  // Do something with each triggerInbox
+}
+```
+
+#### `listTriggerInputFieldChoices` 🧪 _experimental_
+
+Get the available choices for a dynamic dropdown input field on a trigger
+
+**Parameters:**
+
+| Name             | Type             | Required | Default | Possible Values | Description                                                                                                         |
+| ---------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `options`        | `object`         | ✅       | —       | —               |                                                                                                                     |
+| ​ ↳ `app`        | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3')        |
+| ​ ↳ `action`     | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                                     |
+| ​ ↳ `inputField` | `string`         | ✅       | —       | —               | Input field key to get choices for                                                                                  |
+| ​ ↳ `connection` | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Required if the trigger needs a connection to populate dynamic dropdown options. |
+| ​ ↳ `inputs`     | `object`         | ❌       | —       | —               | Current input values that may affect available choices                                                              |
+| ​ ↳ `page`       | `number`         | ❌       | —       | —               | Page number for paginated results                                                                                   |
+| ​ ↳ `pageSize`   | `number`         | ❌       | —       | —               | Number of choices per page                                                                                          |
+| ​ ↳ `maxItems`   | `number`         | ❌       | —       | —               | Maximum total items to return across all pages                                                                      |
+| ​ ↳ `cursor`     | `string`         | ❌       | —       | —               | Cursor to start from                                                                                                |
+
+**Returns:** `Promise<PaginatedResult<InputFieldChoiceItem>>`
+
+| Name         | Type       | Required | Possible Values | Description                                                    |
+| ------------ | ---------- | -------- | --------------- | -------------------------------------------------------------- |
+| `data[]`     | `object[]` | ✅       | —               |                                                                |
+| ​ ↳ `key`    | `string`   | ❌       | —               |                                                                |
+| ​ ↳ `label`  | `string`   | ❌       | —               |                                                                |
+| ​ ↳ `sample` | `string`   | ❌       | —               |                                                                |
+| ​ ↳ `value`  | `string`   | ❌       | —               |                                                                |
+| `nextCursor` | `string`   | ❌       | —               | Cursor for the next page; omitted when there are no more pages |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: inputFieldChoices, nextCursor } =
+  await zapier.listTriggerInputFieldChoices({
+    app: "example-app",
+    action: "example-action",
+    inputField: "example-input-field",
+  });
+
+// Or iterate over all pages
+for await (const page of zapier.listTriggerInputFieldChoices({
+  app: "example-app",
+  action: "example-action",
+  inputField: "example-input-field",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const inputFieldChoice of zapier
+  .listTriggerInputFieldChoices({
+    app: "example-app",
+    action: "example-action",
+    inputField: "example-input-field",
+  })
+  .items()) {
+  // Do something with each inputFieldChoice
+}
+```
+
+#### `listTriggerInputFields` 🧪 _experimental_
+
+Get the input fields required for a specific trigger
+
+**Parameters:**
+
+| Name             | Type             | Required | Default | Possible Values | Description                                                                                                  |
+| ---------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
+| `options`        | `object`         | ✅       | —       | —               |                                                                                                              |
+| ​ ↳ `app`        | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3') |
+| ​ ↳ `action`     | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                              |
+| ​ ↳ `connection` | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Required if the trigger needs a connection to determine available fields. |
+| ​ ↳ `inputs`     | `object`         | ❌       | —       | —               | Current input values that may affect available fields                                                        |
+| ​ ↳ `pageSize`   | `number`         | ❌       | —       | —               | Number of input fields per page                                                                              |
+| ​ ↳ `maxItems`   | `number`         | ❌       | —       | —               | Maximum total items to return across all pages                                                               |
+| ​ ↳ `cursor`     | `string`         | ❌       | —       | —               | Cursor to start from                                                                                         |
+
+**Returns:** `Promise<PaginatedResult<RootFieldItem>>`
+
+| Name         | Type       | Required | Possible Values | Description                                                    |
+| ------------ | ---------- | -------- | --------------- | -------------------------------------------------------------- |
+| `data[]`     | `object[]` | ✅       | —               | One of the variants below, distinguished by `type`             |
+| `nextCursor` | `string`   | ❌       | —               | Cursor for the next page; omitted when there are no more pages |
+
+**When `type` is `"input_field"`:**
+
+| Name                       | Type      | Required | Possible Values | Description |
+| -------------------------- | --------- | -------- | --------------- | ----------- |
+| `type`                     | `string`  | ✅       | `input_field`   |             |
+| `key`                      | `string`  | ✅       | —               |             |
+| `default_value`            | `string`  | ✅       | —               |             |
+| `depends_on`               | `array`   | ✅       | —               |             |
+| `description`              | `string`  | ✅       | —               |             |
+| `invalidates_input_fields` | `boolean` | ✅       | —               |             |
+| `is_required`              | `boolean` | ✅       | —               |             |
+| `placeholder`              | `string`  | ✅       | —               |             |
+| `title`                    | `string`  | ✅       | —               |             |
+| `value_type`               | `string`  | ✅       | —               |             |
+| `format`                   | `string`  | ❌       | —               |             |
+| `items`                    | `object`  | ❌       | —               |             |
+| ​ ↳ `type`                 | `string`  | ✅       | —               |             |
+
+**When `type` is `"info_field"`:**
+
+| Name          | Type     | Required | Possible Values | Description |
+| ------------- | -------- | -------- | --------------- | ----------- |
+| `type`        | `string` | ✅       | `info_field`    |             |
+| `key`         | `string` | ✅       | —               |             |
+| `description` | `string` | ✅       | —               |             |
+| `title`       | `string` | ❌       | —               |             |
+
+**When `type` is `"fieldset"`:**
+
+| Name     | Type     | Required | Possible Values | Description |
+| -------- | -------- | -------- | --------------- | ----------- |
+| `type`   | `string` | ✅       | `fieldset`      |             |
+| `key`    | `string` | ✅       | —               |             |
+| `title`  | `string` | ✅       | —               |             |
+| `fields` | `array`  | ✅       | —               |             |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: rootFields, nextCursor } = await zapier.listTriggerInputFields({
+  app: "example-app",
+  action: "example-action",
+});
+
+// Or iterate over all pages
+for await (const page of zapier.listTriggerInputFields({
+  app: "example-app",
+  action: "example-action",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const rootField of zapier
+  .listTriggerInputFields({
+    app: "example-app",
+    action: "example-action",
+  })
+  .items()) {
+  // Do something with each rootField
+}
+```
+
+#### `pauseTriggerInbox` 🧪 _experimental_
+
+Pause a trigger inbox; events stop being collected
+
+**Parameters:**
+
+| Name        | Type     | Required | Default | Possible Values | Description                                                                                                |
+| ----------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`   | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox` | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.pauseTriggerInbox({
+  inbox: "example-inbox",
+});
+```
+
+#### `releaseTriggerInboxMessages` 🧪 _experimental_
+
+Release messages from a lease back to the inbox without acknowledging them. Released messages become immediately available for re-leasing. The lease attempt still counts against the per-message lease limit; releasing does not refund the attempt.
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description                                                                                                |
+| -------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox`    | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+| ​ ↳ `lease`    | `string` | ✅       | —       | —               | Lease ID returned from leaseTriggerInboxMessages                                                           |
+| ​ ↳ `messages` | `array`  | ❌       | —       | —               | Specific message IDs to release. Omit to release every message in the lease.                               |
+
+**Returns:** `Promise<TriggerInboxReleaseItem>`
+
+| Name                              | Type       | Required | Possible Values                               | Description              |
+| --------------------------------- | ---------- | -------- | --------------------------------------------- | ------------------------ |
+| `data`                            | `object`   | ✅       | —                                             |                          |
+| ​ ↳ `released_id`                 | `string`   | ✅       | —                                             |                          |
+| ​ ↳ `results[]`                   | `object[]` | ✅       | —                                             |                          |
+| ​   ↳ `id`                        | `string`   | ✅       | —                                             |                          |
+| ​   ↳ `created_at`                | `string`   | ✅       | —                                             |                          |
+| ​   ↳ `status`                    | `string`   | ✅       | `available`, `leased`, `acked`, `quarantined` | Message lifecycle status |
+| ​   ↳ `message_attributes`        | `object`   | ✅       | —                                             |                          |
+| ​     ↳ `lease_count`             | `number`   | ✅       | —                                             |                          |
+| ​     ↳ `error_message`           | `string`   | ✅       | —                                             |                          |
+| ​     ↳ `possible_duplicate_data` | `boolean`  | ✅       | —                                             |                          |
+
+**Example:**
+
+```typescript
+const result = await zapier.releaseTriggerInboxMessages({
+  inbox: "example-inbox",
+  lease: "example-lease",
+});
+```
+
+#### `resumeTriggerInbox` 🧪 _experimental_
+
+Resume a paused trigger inbox; events resume being collected
+
+**Parameters:**
+
+| Name        | Type     | Required | Default | Possible Values | Description                                                                                                |
+| ----------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`   | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox` | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.resumeTriggerInbox({
+  inbox: "example-inbox",
+});
+```
+
+#### `updateTriggerInbox` 🧪 _experimental_
+
+Update settings on an existing trigger inbox
+
+**Parameters:**
+
+| Name                  | Type     | Required | Default | Possible Values | Description                                                                                                |
+| --------------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
+| `options`             | `object` | ✅       | —       | —               |                                                                                                            |
+| ​ ↳ `inbox`           | `string` | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint. |
+| ​ ↳ `notificationUrl` | `string` | ❌       | —       | —               | Webhook URL to POST to when new messages arrive. Pass null to clear.                                       |
+
+**Returns:** `Promise<TriggerInboxItem>`
+
+| Name                   | Type             | Required | Possible Values                                                                                                                                                 | Description                             |
+| ---------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `data`                 | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `id`               | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `created_at`       | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `name`             | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `status`           | `string`         | ✅       | `initializing`, `active`, `paused`, `deleting`, `initialization_failure`                                                                                        | Inbox lifecycle status                  |
+| ​ ↳ `paused_reason`    | `string`         | ✅       | `user`, `authentication`, `authentication_access_revoked`, `partner_revoked`, `subscribe_failed`, `migrate_failed`, `abandoned`, `unknown`, `upstream_failures` | Why the inbox was paused, if applicable |
+| ​ ↳ `notification_url` | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​ ↳ `subscription`     | `object`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `connection_id`  | `string, number` | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `app_key`        | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `action_key`     | `string`         | ✅       | —                                                                                                                                                               |                                         |
+| ​   ↳ `inputs`         | `object`         | ✅       | —                                                                                                                                                               |                                         |
+
+**Example:**
+
+```typescript
+const result = await zapier.updateTriggerInbox({
+  inbox: "example-inbox",
+});
+```
+
+#### `watchTriggerInbox` 🧪 _experimental_
+
+Continuously consume a trigger inbox: drain currently-available messages via onMessage, then poll with backoff for new arrivals, until aborted. Resolves cleanly on signal abort or ZapierAbortDrainSignal from a handler; rejects on fatal SDK errors or fail-fast handler errors.
+
+**Parameters:**
+
+| Name                          | Type       | Required | Default | Possible Values | Description                                                                                                                                                                                                                 |
+| ----------------------------- | ---------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`                     | `object`   | ✅       | —       | —               |                                                                                                                                                                                                                             |
+| ​ ↳ `inbox`                   | `string`   | ✅       | —       | —               | Trigger inbox identifier — UUID or name. Non-UUID values are resolved by name via the inbox list endpoint.                                                                                                                  |
+| ​ ↳ `onMessage`               | `function` | ❌       | —       | —               | Per-message handler. Resolves to ack; rejects to release-or-leave per `releaseOnError`. Throw `ZapierReleaseTriggerMessageSignal` to release explicitly, or `ZapierAbortDrainSignal` to stop after the current batch.       |
+| ​ ↳ `concurrency`             | `number`   | ❌       | —       | —               | Per-message handler workers running in parallel. Defaults to `leaseLimit`, or 1 if neither is set.                                                                                                                          |
+| ​ ↳ `leaseLimit`              | `number`   | ❌       | —       | —               | Per-lease HTTP batch size. Defaults to `concurrency`, or 1 if neither is set.                                                                                                                                               |
+| ​ ↳ `leaseSeconds`            | `number`   | ❌       | —       | —               | Seconds until the lease expires; messages return to available if not acked. API default is 300 (5 minutes).                                                                                                                 |
+| ​ ↳ `releaseOnError`          | `boolean`  | ❌       | —       | —               | If true, errors immediately release the message. If false (default), errors leave it leased until the lease timeout. `ZapierReleaseTriggerMessageSignal` always releases regardless.                                        |
+| ​ ↳ `continueOnError`         | `boolean`  | ❌       | —       | —               | If false (default, fail-fast), the first handler error rejects and stops the drain. If true, handler errors are observed via `onError` and the drain continues. SDK-level errors (lease / ack / release) reject regardless. |
+| ​ ↳ `onError`                 | `function` | ❌       | —       | —               | Per-message error observer for `continueOnError: true`. Called with the failure and the message; control-flow signals are filtered out. Throws from `onError` are swallowed.                                                |
+| ​ ↳ `signal`                  | `any`      | ❌       | —       | —               | Abort signal. Aborting cancels in-flight HTTP, releases unprocessed messages, and resolves cleanly. Errors during shutdown still reject.                                                                                    |
+| ​ ↳ `maxDrainIntervalSeconds` | `number`   | ❌       | —       | —               | Maximum seconds between empty-inbox poll attempts (default: 60). Caps the back-off cadence.                                                                                                                                 |
+
+**Returns:** `Promise<void>`
+
+**Example:**
+
+```typescript
+const result = await zapier.watchTriggerInbox({
+  inbox: "example-inbox",
+  onMessage: async (message) => {
+    /* process message */
+  },
+});
+```