npm - @zapier/zapier-sdk - Versions diffs - 0.48.1 → 0.49.0 - Mend

@zapier/zapier-sdk 0.48.1 → 0.49.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (207) hide show

package/README.md CHANGED Viewed

@@ -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
@@ -452,7 +470,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 +490,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 +533,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 +541,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 +552,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 +563,7 @@ for await (const inputFieldChoice of zapier
 }
 ```
-#### `listInputFields`
+#### `listActionInputFields`
 Get the input fields required for a specific action
@@ -667,14 +628,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 +645,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 +655,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 +1786,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 */
+  },
+});
+```