diff --git a/apps/docs/components/icons.tsx b/apps/docs/components/icons.tsx index 606e5b0faf6..79e1c5da500 100644 --- a/apps/docs/components/icons.tsx +++ b/apps/docs/components/icons.tsx @@ -2581,6 +2581,25 @@ export function BrexIcon(props: SVGProps) { ) } +/** + * Official QuickBooks circular mark, cropped from the user-supplied + * Intuit_QuickBooks_logo.svg wordmark. + */ +export function QuickBooksIcon(props: SVGProps) { + return ( + + + + + ) +} + export function BrightDataIcon(props: SVGProps) { return ( = { pulse_v2: PulseIcon, qdrant: QdrantIcon, quartr: QuartrIcon, + quickbooks: QuickBooksIcon, quiver: QuiverIcon, railway: RailwayIcon, rb2b: RB2BIcon, diff --git a/apps/docs/content/docs/en/integrations/meta.json b/apps/docs/content/docs/en/integrations/meta.json index ef27475a3a9..02adf3270f9 100644 --- a/apps/docs/content/docs/en/integrations/meta.json +++ b/apps/docs/content/docs/en/integrations/meta.json @@ -187,6 +187,7 @@ "pulse", "qdrant", "quartr", + "quickbooks", "quiver", "railway", "rb2b", diff --git a/apps/docs/content/docs/en/integrations/quickbooks.mdx b/apps/docs/content/docs/en/integrations/quickbooks.mdx new file mode 100644 index 00000000000..cf2222d54c4 --- /dev/null +++ b/apps/docs/content/docs/en/integrations/quickbooks.mdx @@ -0,0 +1,2921 @@ +--- +title: QuickBooks +description: Manage QuickBooks Online company, transactions, reports, emails, PDFs, and attachments +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +Connect one QuickBooks Online company per credential. During OAuth, choose the company that the workflow should access; Sim binds that company to the credential automatically, so you do not enter a realm ID or API host. + +Master Data, Sales, and Purchasing transaction reads support **List** and **By ID** modes. List actions return at most one page. Use `nextStartPosition` in another workflow step when `hasMore` is true. Sim does not paginate, retry, or fetch related records automatically. + +QuickBooks updates are sparse: provide the record ID, its current `SyncToken`, and only the fields you want to change. Use the latest `SyncToken` returned by a read or mutation. Voiding keeps the transaction in QuickBooks with a zeroed financial effect; it is not deletion and requires explicit confirmation. Create actions accept an optional `requestId` that QuickBooks uses for idempotency when the same request may be submitted again. + +Sandbox credentials call only Intuit's sandbox API and are suitable for disposable test data. Production credentials call the production API and affect the selected live company. + +Run Financial Report exposes verified financial statements, aging, balance, sales, and expense reports while preserving QuickBooks' native columns and nested rows. Advanced controls appear only where QuickBooks supports them. Use Read Master Data to discover customer, vendor, account, item, class, and department IDs for report filters. Intuit recommends report periods of six months or less for performance, though Sim does not forbid longer accounting periods. + +Document actions can read attachment metadata, add one File or Note attachment, download an attachment file, and download supported transactions as PDFs. Downloaded files are stored as Sim files for downstream blocks. Attachment deletion, bulk upload/download, and bulk email remain outside this version of the block. +{/* MANUAL-CONTENT-END */} + + +## Usage Instructions + +Connect one QuickBooks Online company to manage bounded master-data, sales, purchasing, receivables, payables, accounting, reports, transaction delivery, and document workflows. + + + +## Actions + +### `quickbooks_get_company_info` + +Get information about the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `company` | json | Verified QuickBooks CompanyInfo object, including Id, CompanyName, LegalName, addresses, contact details, NameValue settings, and MetaData when populated | +| ↳ `Id` | string | QuickBooks CompanyInfo entity ID \(commonly "1"\); this is not the OAuth realmId | +| ↳ `SyncToken` | string | CompanyInfo sync token | +| ↳ `CompanyName` | string | Company display name | +| ↳ `LegalName` | string | Company legal name | +| ↳ `CompanyAddr` | json | Company address | +| ↳ `CustomerCommunicationAddr` | json | Customer communication address | +| ↳ `LegalAddr` | json | Company legal address | +| ↳ `PrimaryPhone` | json | Primary phone details | +| ↳ `Email` | json | Company email details | +| ↳ `WebAddr` | json | Company website details | +| ↳ `CompanyStartDate` | string | Company start date | +| ↳ `Country` | string | Company country code | +| ↳ `FiscalYearStartMonth` | string | Fiscal year starting month | +| ↳ `SupportedLanguages` | string | Comma-separated list of languages supported by the company | +| ↳ `EmployerId` | string | Employer Identification Number, when defined in company settings | +| ↳ `domain` | string | Originating Intuit domain | +| ↳ `sparse` | boolean | Whether QuickBooks returned a partial representation | +| ↳ `NameValue` | array | QuickBooks company settings represented as name/value entries | +| ↳ `MetaData` | json | CompanyInfo creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_read_master_data` + +List or read one account, class, customer, department, employee, item, or vendor + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `recordType` | string | Yes | Master-data entity to read: account, class, customer, department, employee, item, or vendor | +| `readMode` | string | Yes | Whether to list records or read one record by ID | +| `recordId` | string | No | QuickBooks record ID, required for by-ID reads | +| `startPosition` | number | No | One-based position of the first list record to return | +| `maxResults` | number | No | Number of list records to request \(1–100\) | +| `activeStatus` | string | No | List records using the QuickBooks default, active, or inactive status | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordType` | string | Master-data record type returned by this action | +| `item` | json | Single QuickBooks master-data record returned by a by-ID read | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `Name` | string | Account, item, class, or department name | +| ↳ `SubAccount` | boolean | Whether this is a subaccount | +| ↳ `ParentRef` | json | Parent account, item, class, or department reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FullyQualifiedName` | string | Hierarchical qualified account, item, class, or department name | +| ↳ `Classification` | string | Account classification | +| ↳ `AccountType` | string | Account type | +| ↳ `AccountSubType` | string | Account subtype | +| ↳ `CurrentBalance` | number | Account current balance | +| ↳ `CurrencyRef` | json | Account, customer, or vendor currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `DisplayName` | string | Customer, vendor, or employee display name | +| ↳ `CompanyName` | string | Customer or vendor company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `Taxable` | boolean | Taxable status for the customer or item | +| ↳ `PrimaryEmailAddr` | json | Customer, vendor, or employee primary email address | +| ↳ `PrimaryPhone` | json | Customer, vendor, or employee primary phone number | +| ↳ `BillAddr` | json | Customer or vendor billing address | +| ↳ `ShipAddr` | json | Customer shipping address | +| ↳ `Balance` | number | Customer or vendor balance | +| ↳ `PrintOnCheckName` | string | Vendor or employee name printed on checks | +| ↳ `Vendor1099` | boolean | Whether the vendor is tracked for 1099 reporting | +| ↳ `AcctNum` | string | Vendor account number | +| ↳ `Description` | string | Item sales description | +| ↳ `UnitPrice` | number | Item sale price | +| ↳ `Type` | string | Item type | +| ↳ `IncomeAccountRef` | json | Item income account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExpenseAccountRef` | json | Item expense account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PurchaseDesc` | string | Item purchase description | +| ↳ `PurchaseCost` | number | Item purchase cost | +| ↳ `AssetAccountRef` | json | Inventory asset account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `TrackQtyOnHand` | boolean | Whether QuickBooks tracks quantity on hand | +| ↳ `QtyOnHand` | number | Current quantity on hand | +| ↳ `InvStartDate` | string | Inventory tracking start date | +| ↳ `PrimaryAddr` | json | Employee primary address | +| ↳ `BillableTime` | boolean | Whether employee time is billable | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | +| ↳ `SubClass` | boolean | Whether the Class is nested under another Class | +| ↳ `SubDepartment` | boolean | Whether the Department is nested under another Department | +| `items` | array | QuickBooks master-data records returned by a list read | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `Name` | string | Account, item, class, or department name | +| ↳ `SubAccount` | boolean | Whether this is a subaccount | +| ↳ `ParentRef` | json | Parent account, item, class, or department reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FullyQualifiedName` | string | Hierarchical qualified account, item, class, or department name | +| ↳ `Classification` | string | Account classification | +| ↳ `AccountType` | string | Account type | +| ↳ `AccountSubType` | string | Account subtype | +| ↳ `CurrentBalance` | number | Account current balance | +| ↳ `CurrencyRef` | json | Account, customer, or vendor currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `DisplayName` | string | Customer, vendor, or employee display name | +| ↳ `CompanyName` | string | Customer or vendor company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `Taxable` | boolean | Taxable status for the customer or item | +| ↳ `PrimaryEmailAddr` | json | Customer, vendor, or employee primary email address | +| ↳ `PrimaryPhone` | json | Customer, vendor, or employee primary phone number | +| ↳ `BillAddr` | json | Customer or vendor billing address | +| ↳ `ShipAddr` | json | Customer shipping address | +| ↳ `Balance` | number | Customer or vendor balance | +| ↳ `PrintOnCheckName` | string | Vendor or employee name printed on checks | +| ↳ `Vendor1099` | boolean | Whether the vendor is tracked for 1099 reporting | +| ↳ `AcctNum` | string | Vendor account number | +| ↳ `Description` | string | Item sales description | +| ↳ `UnitPrice` | number | Item sale price | +| ↳ `Type` | string | Item type | +| ↳ `IncomeAccountRef` | json | Item income account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExpenseAccountRef` | json | Item expense account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PurchaseDesc` | string | Item purchase description | +| ↳ `PurchaseCost` | number | Item purchase cost | +| ↳ `AssetAccountRef` | json | Inventory asset account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `TrackQtyOnHand` | boolean | Whether QuickBooks tracks quantity on hand | +| ↳ `QtyOnHand` | number | Current quantity on hand | +| ↳ `InvStartDate` | string | Inventory tracking start date | +| ↳ `PrimaryAddr` | json | Employee primary address | +| ↳ `BillableTime` | boolean | Whether employee time is billable | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | +| ↳ `SubClass` | boolean | Whether the Class is nested under another Class | +| ↳ `SubDepartment` | boolean | Whether the Department is nested under another Department | +| `startPosition` | number | One-based position of the first record in this page | +| `maxResults` | number | Actual number of records returned in this page | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_create_customer` + +Create a customer in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `displayName` | string | Yes | Unique customer display name | +| `companyName` | string | No | Customer company name | +| `givenName` | string | No | Customer given name | +| `familyName` | string | No | Customer family name | +| `primaryEmail` | string | No | Customer primary email address | +| `primaryPhone` | string | No | Customer primary phone number | +| `billingAddress` | json | No | Customer billing address | +| `shippingAddress` | json | No | Customer shipping address | +| `taxable` | boolean | No | Whether sales to this customer are taxable | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created QuickBooks Customer record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Customer display name | +| ↳ `CompanyName` | string | Customer company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `Taxable` | boolean | Whether the customer is taxable | +| ↳ `PrimaryEmailAddr` | json | Customer primary email address | +| ↳ `PrimaryPhone` | json | Customer primary phone number | +| ↳ `BillAddr` | json | Customer billing address | +| ↳ `ShipAddr` | json | Customer shipping address | +| ↳ `Balance` | number | Customer balance | +| ↳ `CurrencyRef` | json | Customer currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_update_customer` + +Sparse-update a customer in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | ID of the customer to update | +| `syncToken` | string | Yes | Current customer sync token | +| `displayName` | string | No | Replacement customer display name | +| `companyName` | string | No | Replacement customer company name | +| `givenName` | string | No | Replacement customer given name | +| `familyName` | string | No | Replacement customer family name | +| `primaryEmail` | string | No | Replacement primary email address | +| `primaryPhone` | string | No | Replacement primary phone number | +| `billingAddress` | json | No | Replacement billing address | +| `shippingAddress` | json | No | Replacement shipping address | +| `taxable` | boolean | No | Whether sales to this customer are taxable | +| `activeStatus` | string | No | Customer status change: unchanged, active, or inactive | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated QuickBooks Customer record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Customer display name | +| ↳ `CompanyName` | string | Customer company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `Taxable` | boolean | Whether the customer is taxable | +| ↳ `PrimaryEmailAddr` | json | Customer primary email address | +| ↳ `PrimaryPhone` | json | Customer primary phone number | +| ↳ `BillAddr` | json | Customer billing address | +| ↳ `ShipAddr` | json | Customer shipping address | +| ↳ `Balance` | number | Customer balance | +| ↳ `CurrencyRef` | json | Customer currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_create_employee` + +Create a non-payroll employee profile in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `displayName` | string | No | Unique employee display name. When omitted QuickBooks derives it from the supplied name components, and it is read-only when QuickBooks Payroll is enabled | +| `givenName` | string | No | Employee given name. At least one of givenName or familyName is required | +| `familyName` | string | No | Employee family name. At least one of givenName or familyName is required | +| `primaryEmail` | string | No | Employee primary email address | +| `primaryPhone` | string | No | Employee primary phone number | +| `primaryAddress` | json | No | Employee primary address | +| `printOnCheckName` | string | No | Employee name printed on checks | +| `billableTime` | boolean | No | Whether employee time is billable | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created QuickBooks Employee record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Employee display name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `PrintOnCheckName` | string | Employee name printed on checks | +| ↳ `PrimaryEmailAddr` | json | Employee primary email address | +| ↳ `PrimaryPhone` | json | Employee primary phone number | +| ↳ `PrimaryAddr` | json | Employee primary address | +| ↳ `BillableTime` | boolean | Whether employee time is billable | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | + +### `quickbooks_update_employee` + +Sparse-update a non-payroll employee profile in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `employeeId` | string | Yes | ID of the employee to update | +| `syncToken` | string | Yes | Current employee sync token | +| `displayName` | string | No | Replacement employee display name | +| `givenName` | string | No | Replacement employee given name | +| `familyName` | string | No | Replacement employee family name | +| `primaryEmail` | string | No | Replacement employee primary email address | +| `primaryPhone` | string | No | Replacement employee primary phone number | +| `primaryAddress` | json | No | Replacement employee primary address | +| `printOnCheckName` | string | No | Replacement employee name printed on checks | +| `billableTime` | boolean | No | Whether employee time is billable | +| `activeStatus` | string | No | Employee status change: unchanged, active, or inactive | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated QuickBooks Employee record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Employee display name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `PrintOnCheckName` | string | Employee name printed on checks | +| ↳ `PrimaryEmailAddr` | json | Employee primary email address | +| ↳ `PrimaryPhone` | json | Employee primary phone number | +| ↳ `PrimaryAddr` | json | Employee primary address | +| ↳ `BillableTime` | boolean | Whether employee time is billable | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | + +### `quickbooks_create_vendor` + +Create a vendor in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `displayName` | string | Yes | Unique vendor display name | +| `companyName` | string | No | Vendor company name | +| `givenName` | string | No | Vendor given name | +| `familyName` | string | No | Vendor family name | +| `primaryEmail` | string | No | Vendor primary email address | +| `primaryPhone` | string | No | Vendor primary phone number | +| `billingAddress` | json | No | Vendor billing address | +| `printOnCheckName` | string | No | Name to print on checks | +| `accountNumber` | string | No | Vendor account number | +| `vendor1099` | boolean | No | Whether the vendor is tracked for 1099 reporting | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created QuickBooks Vendor record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Vendor display name | +| ↳ `CompanyName` | string | Vendor company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `PrintOnCheckName` | string | Name printed on checks | +| ↳ `Vendor1099` | boolean | Whether the vendor is tracked for 1099 reporting | +| ↳ `PrimaryEmailAddr` | json | Vendor primary email address | +| ↳ `PrimaryPhone` | json | Vendor primary phone number | +| ↳ `BillAddr` | json | Vendor billing address | +| ↳ `AcctNum` | string | Vendor account number | +| ↳ `Balance` | number | Vendor balance | +| ↳ `CurrencyRef` | json | Vendor currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_update_vendor` + +Sparse-update a vendor in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorId` | string | Yes | ID of the vendor to update | +| `syncToken` | string | Yes | Current vendor sync token | +| `displayName` | string | No | Replacement vendor display name | +| `companyName` | string | No | Replacement vendor company name | +| `givenName` | string | No | Replacement vendor given name | +| `familyName` | string | No | Replacement vendor family name | +| `primaryEmail` | string | No | Replacement primary email address | +| `primaryPhone` | string | No | Replacement primary phone number | +| `billingAddress` | json | No | Replacement billing address | +| `printOnCheckName` | string | No | Replacement name to print on checks | +| `accountNumber` | string | No | Replacement vendor account number | +| `vendor1099` | boolean | No | Whether the vendor is tracked for 1099 reporting | +| `activeStatus` | string | No | Vendor status change: unchanged, active, or inactive | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated QuickBooks Vendor record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `DisplayName` | string | Vendor display name | +| ↳ `CompanyName` | string | Vendor company name | +| ↳ `GivenName` | string | Given name | +| ↳ `FamilyName` | string | Family name | +| ↳ `PrintOnCheckName` | string | Name printed on checks | +| ↳ `Vendor1099` | boolean | Whether the vendor is tracked for 1099 reporting | +| ↳ `PrimaryEmailAddr` | json | Vendor primary email address | +| ↳ `PrimaryPhone` | json | Vendor primary phone number | +| ↳ `BillAddr` | json | Vendor billing address | +| ↳ `AcctNum` | string | Vendor account number | +| ↳ `Balance` | number | Vendor balance | +| ↳ `CurrencyRef` | json | Vendor currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_create_item` + +Create a Service or Non-inventory item in QuickBooks Online + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `name` | string | Yes | Unique item name | +| `itemType` | string | Yes | Writable item type: service or non_inventory | +| `incomeAccountId` | string | No | Sales of Product Income account ID recording proceeds from the sale. Required for Service items, optional for Non-inventory items and for France locales | +| `description` | string | No | Sales description | +| `unitPrice` | number | No | Sales price per unit | +| `purchaseDescription` | string | No | Purchase description | +| `purchaseCost` | number | No | Purchase cost per unit | +| `expenseAccountId` | string | Yes | Cost of Goods Sold account ID used to pay the vendor for this item. Required for both Service and Non-inventory items, except in France locales where it is optional | +| `taxable` | boolean | No | Whether the item is taxable | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created QuickBooks Item record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `Name` | string | Item name | +| ↳ `Description` | string | Item sales description | +| ↳ `FullyQualifiedName` | string | Hierarchical qualified item name | +| ↳ `Taxable` | boolean | Whether the item is taxable | +| ↳ `UnitPrice` | number | Item sale price | +| ↳ `Type` | string | Item type | +| ↳ `IncomeAccountRef` | json | Item income account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExpenseAccountRef` | json | Item expense account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PurchaseDesc` | string | Item purchase description | +| ↳ `PurchaseCost` | number | Item purchase cost | +| ↳ `AssetAccountRef` | json | Inventory asset account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `TrackQtyOnHand` | boolean | Whether QuickBooks tracks quantity on hand | +| ↳ `QtyOnHand` | number | Current quantity on hand | +| ↳ `InvStartDate` | string | Inventory tracking start date | +| ↳ `ParentRef` | json | Parent item or category reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_update_item` + +Sparse-update supported fields on an item without changing its type + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `itemId` | string | Yes | ID of the item to update | +| `syncToken` | string | Yes | Current item sync token | +| `name` | string | No | Replacement item name | +| `incomeAccountId` | string | No | Replacement income account ID | +| `description` | string | No | Replacement sales description | +| `unitPrice` | number | No | Replacement sales price per unit | +| `purchaseDescription` | string | No | Replacement purchase description | +| `purchaseCost` | number | No | Replacement purchase cost per unit | +| `expenseAccountId` | string | No | Replacement expense account ID | +| `taxable` | boolean | No | Whether the item is taxable | +| `activeStatus` | string | No | Item status change: unchanged, active, or inactive | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated QuickBooks Item record | +| ↳ `Id` | string | QuickBooks entity ID | +| ↳ `SyncToken` | string | Entity sync token | +| ↳ `Active` | boolean | Whether the entity is active | +| ↳ `MetaData` | json | Entity creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `Name` | string | Item name | +| ↳ `Description` | string | Item sales description | +| ↳ `FullyQualifiedName` | string | Hierarchical qualified item name | +| ↳ `Taxable` | boolean | Whether the item is taxable | +| ↳ `UnitPrice` | number | Item sale price | +| ↳ `Type` | string | Item type | +| ↳ `IncomeAccountRef` | json | Item income account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExpenseAccountRef` | json | Item expense account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PurchaseDesc` | string | Item purchase description | +| ↳ `PurchaseCost` | number | Item purchase cost | +| ↳ `AssetAccountRef` | json | Inventory asset account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `TrackQtyOnHand` | boolean | Whether QuickBooks tracks quantity on hand | +| ↳ `QtyOnHand` | number | Current quantity on hand | +| ↳ `InvStartDate` | string | Inventory tracking start date | +| ↳ `ParentRef` | json | Parent item or category reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | + +### `quickbooks_read_sales_transactions` + +List or read one estimate, invoice, sales receipt, payment, credit memo, or refund receipt + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionType` | string | Yes | Sales transaction type to read | +| `readMode` | string | Yes | Whether to list transactions or read one transaction by ID | +| `transactionId` | string | No | QuickBooks transaction ID, required for by-ID reads | +| `startPosition` | number | No | One-based position of the first list record to return | +| `maxResults` | number | No | Number of list records to request \(1–100\) | +| `startDate` | string | No | List transactions on or after this date in YYYY-MM-DD format | +| `endDate` | string | No | List transactions on or before this date in YYYY-MM-DD format | +| `customerId` | string | No | List transactions for one QuickBooks customer ID | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `transactionType` | string | Sales transaction type returned | +| `item` | json | Single native QuickBooks sales transaction | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `items` | array | Native QuickBooks sales transactions | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_create_estimate` + +Create an estimate with bounded item and description lines + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer receiving the estimate | +| `lines` | json | Yes | Bounded item and description lines | +| `transactionDate` | string | No | Estimate date in YYYY-MM-DD format | +| `expirationDate` | string | No | Estimate expiration date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional estimate number | +| `privateNote` | string | No | Internal estimate note | +| `customerMemo` | string | No | Customer-facing estimate memo | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks Estimate | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_estimate` + +Sparse-update an estimate using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Estimate ID to update | +| `syncToken` | string | Yes | Current estimate sync token | +| `customerId` | string | No | Replacement customer ID | +| `lines` | json | No | Complete replacement set of estimate lines: any existing line omitted here is deleted from the estimate | +| `transactionDate` | string | No | Replacement estimate date in YYYY-MM-DD format | +| `expirationDate` | string | No | Replacement expiration date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement estimate number | +| `privateNote` | string | No | Replacement internal note | +| `customerMemo` | string | No | Replacement customer-facing memo | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Estimate | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_invoice` + +Create an invoice without emailing or collecting payment + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer receiving the invoice | +| `lines` | json | Yes | Bounded item and description lines | +| `transactionDate` | string | No | Invoice date in YYYY-MM-DD format | +| `dueDate` | string | No | Invoice due date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional invoice number | +| `privateNote` | string | No | Internal invoice note | +| `customerMemo` | string | No | Customer-facing invoice memo | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks Invoice | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_invoice` + +Sparse-update an invoice using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Invoice ID to update | +| `syncToken` | string | Yes | Current invoice sync token | +| `customerId` | string | No | Replacement customer ID | +| `lines` | json | No | Complete replacement set of invoice lines: any existing line omitted here is deleted from the invoice | +| `transactionDate` | string | No | Replacement invoice date in YYYY-MM-DD format | +| `dueDate` | string | No | Replacement due date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement invoice number | +| `privateNote` | string | No | Replacement internal note | +| `customerMemo` | string | No | Replacement customer-facing memo | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Invoice | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_void_invoice` + +Void an invoice after explicit confirmation + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Invoice ID to void | +| `syncToken` | string | Yes | Current invoice sync token | +| `confirmVoid` | boolean | Yes | Explicit confirmation that the invoice should be voided | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `voided` | boolean | Whether QuickBooks voided the transaction | +| `record` | json | Voided native QuickBooks Invoice | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_sales_receipt` + +Create a sales receipt for a completed customer sale + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer for the sales receipt | +| `lines` | json | Yes | Bounded item and description lines | +| `transactionDate` | string | No | Sales receipt date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional sales receipt number | +| `privateNote` | string | No | Internal sales receipt note | +| `customerMemo` | string | No | Customer-facing sales receipt memo | +| `paymentMethodId` | string | No | QuickBooks payment method ID | +| `paymentReferenceNumber` | string | No | Payment reference number | +| `depositAccountId` | string | No | QuickBooks deposit account ID | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks SalesReceipt | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_sales_receipt` + +Sparse-update a sales receipt using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Sales receipt ID to update | +| `syncToken` | string | Yes | Current sales receipt sync token | +| `customerId` | string | No | Replacement customer ID | +| `lines` | json | No | Complete replacement set of sales receipt lines: any existing line omitted here is deleted from the sales receipt | +| `transactionDate` | string | No | Replacement receipt date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement sales receipt number | +| `privateNote` | string | No | Replacement internal note | +| `customerMemo` | string | No | Replacement customer-facing memo | +| `paymentMethodId` | string | No | Replacement payment method ID | +| `paymentReferenceNumber` | string | No | Replacement payment reference number | +| `depositAccountId` | string | No | Replacement deposit account ID | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks SalesReceipt | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_customer_payment` + +Record a customer payment with optional bounded invoice allocations + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer making the payment | +| `totalAmount` | number | Yes | Positive total payment amount | +| `transactionDate` | string | No | Payment date in YYYY-MM-DD format | +| `privateNote` | string | No | Internal payment note | +| `paymentReferenceNumber` | string | No | Payment reference number such as a check number | +| `paymentMethodId` | string | No | QuickBooks payment method ID | +| `depositAccountId` | string | No | QuickBooks deposit account ID | +| `invoiceAllocations` | json | No | Up to 100 invoice allocations with invoiceId and positive amount | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks Payment | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_customer_payment` + +Sparse-update a customer payment using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `paymentId` | string | Yes | Payment ID to update | +| `syncToken` | string | Yes | Current payment sync token | +| `customerId` | string | No | Replacement customer ID | +| `totalAmount` | number | No | Replacement positive payment total | +| `transactionDate` | string | No | Replacement payment date in YYYY-MM-DD format | +| `privateNote` | string | No | Replacement internal note | +| `paymentReferenceNumber` | string | No | Replacement payment reference number | +| `paymentMethodId` | string | No | Replacement payment method ID | +| `depositAccountId` | string | No | Replacement deposit account ID | +| `invoiceAllocations` | json | No | Bounded invoice allocations to apply. Each entry sets the amount applied to that invoice; invoices already applied on the payment and not listed here keep their current amounts | +| `unapplyOmittedInvoices` | boolean | No | Replace the payment allocations outright. Every invoice not listed in invoiceAllocations is UNAPPLIED and returns to open | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Payment | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_void_customer_payment` + +Void a customer payment after explicit confirmation + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Payment ID to void | +| `syncToken` | string | Yes | Current payment sync token | +| `confirmVoid` | boolean | Yes | Explicit confirmation that the payment should be voided | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `voided` | boolean | Whether QuickBooks voided the transaction | +| `record` | json | Voided native QuickBooks Payment | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_credit_memo` + +Create a customer credit memo with bounded sales lines + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer receiving the credit memo | +| `lines` | json | Yes | Bounded item and description lines | +| `transactionDate` | string | No | Credit memo date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional credit memo number | +| `privateNote` | string | No | Internal credit memo note | +| `customerMemo` | string | No | Customer-facing credit memo memo | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks CreditMemo | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_credit_memo` + +Sparse-update a credit memo using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Credit memo ID to update | +| `syncToken` | string | Yes | Current credit memo sync token | +| `customerId` | string | No | Replacement customer ID | +| `lines` | json | No | Complete replacement set of credit memo lines: any existing line omitted here is deleted from the credit memo | +| `transactionDate` | string | No | Replacement credit memo date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement credit memo number | +| `privateNote` | string | No | Replacement internal note | +| `customerMemo` | string | No | Replacement customer-facing memo | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks CreditMemo | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_refund_receipt` + +Create a customer refund receipt against a required deposit account + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `customerId` | string | Yes | Customer receiving the refund | +| `lines` | json | Yes | Bounded item and description lines | +| `depositAccountId` | string | Yes | QuickBooks bank account funding the refund | +| `transactionDate` | string | No | Refund receipt date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional refund receipt number | +| `privateNote` | string | No | Internal refund receipt note | +| `customerMemo` | string | No | Customer-facing refund memo | +| `paymentMethodId` | string | No | QuickBooks payment method ID | +| `paymentReferenceNumber` | string | No | Refund payment reference number | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks RefundReceipt | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_refund_receipt` + +Sparse-update a refund receipt using its current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionId` | string | Yes | Refund receipt ID to update | +| `syncToken` | string | Yes | Current refund receipt sync token | +| `customerId` | string | No | Replacement customer ID | +| `lines` | json | No | Complete replacement set of refund receipt lines: any existing line omitted here is deleted from the refund receipt | +| `transactionDate` | string | No | Replacement refund date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement refund receipt number | +| `privateNote` | string | No | Replacement internal note | +| `customerMemo` | string | No | Replacement customer-facing memo | +| `paymentMethodId` | string | No | Replacement payment method ID | +| `paymentReferenceNumber` | string | No | Replacement payment reference number | +| `depositAccountId` | string | No | Replacement deposit account ID | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks RefundReceipt | +| ↳ `Id` | string | QuickBooks sales transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Invoice due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Customer payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks transaction lines | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_read_purchasing_transactions` + +List or read one purchase order, bill, bill payment, vendor credit, or purchase + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionType` | string | Yes | Purchasing transaction type to read | +| `readMode` | string | Yes | Whether to list transactions or read one transaction by ID | +| `transactionId` | string | No | QuickBooks transaction ID, required for by-ID reads | +| `startPosition` | number | No | One-based position of the first list record to return | +| `maxResults` | number | No | Number of list records to request \(1–100\) | +| `startDate` | string | No | List transactions on or after this date in YYYY-MM-DD format | +| `endDate` | string | No | List transactions on or before this date in YYYY-MM-DD format | +| `vendorId` | string | No | List transactions for one supported QuickBooks vendor ID | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `transactionType` | string | Purchasing transaction type returned | +| `item` | json | Single native QuickBooks purchasing transaction | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `items` | array | Native QuickBooks purchasing transactions | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_create_purchase_order` + +Create a purchase order with bounded expense lines + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorId` | string | Yes | Purchase-order vendor ID | +| `apAccountId` | string | Yes | Accounts-payable account ID | +| `lines` | json | Yes | Bounded account-based or item-based expense lines | +| `transactionDate` | string | No | Purchase-order date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional purchase-order number | +| `privateNote` | string | No | Internal purchase-order note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks PurchaseOrder | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_purchase_order` + +Sparse-update purchase-order header fields using the current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `purchaseOrderId` | string | Yes | Purchase Order ID to update | +| `syncToken` | string | Yes | Current purchase-order sync token | +| `vendorId` | string | No | Replacement vendor ID | +| `apAccountId` | string | No | Replacement accounts-payable account ID | +| `transactionDate` | string | No | Replacement date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement purchase-order number | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks PurchaseOrder | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_bill` + +Create a vendor bill with optional Purchase Order line links without paying it + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorId` | string | Yes | Bill vendor ID | +| `lines` | json | Yes | Bounded account-based or item-based expense lines with optional paired Purchase Order and line IDs | +| `apAccountId` | string | No | Optional accounts-payable account ID | +| `transactionDate` | string | No | Bill date in YYYY-MM-DD format | +| `dueDate` | string | No | Bill due date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional bill number | +| `privateNote` | string | No | Internal bill note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `linkingRequested` | boolean | Whether any Purchase Order line links were requested | +| `linkingSucceeded` | boolean | Whether QuickBooks returned every requested Purchase Order line link | +| `linkedLines` | array | Requested Purchase Order line links confirmed by QuickBooks | +| ↳ `purchaseOrderId` | string | Requested Purchase Order ID | +| ↳ `purchaseOrderLineId` | string | Requested Purchase Order line ID | +| ↳ `billLineId` | string | Created Bill line ID carrying the confirmed link | +| `missingLinks` | array | Requested Purchase Order line links omitted by QuickBooks | +| ↳ `purchaseOrderId` | string | Requested Purchase Order ID | +| ↳ `purchaseOrderLineId` | string | Requested Purchase Order line ID | +| `linkingWarning` | string | Warning that the Bill was created without every requested Purchase Order link | +| `record` | json | Created native QuickBooks Bill | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_bill` + +Sparse-update bill header fields using its vendor and current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `billId` | string | Yes | Bill ID to update | +| `syncToken` | string | Yes | Current bill sync token | +| `vendorId` | string | Yes | Current or replacement vendor ID required by QuickBooks | +| `apAccountId` | string | No | Replacement accounts-payable account ID | +| `transactionDate` | string | No | Replacement bill date in YYYY-MM-DD format | +| `dueDate` | string | No | Replacement due date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement bill number | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Bill | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_bill_payment` + +Record a check or credit-card payment allocated to one or more bills + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorId` | string | Yes | Vendor whose bills are being paid | +| `totalAmount` | number | Yes | Positive total payment amount | +| `paymentType` | string | Yes | Check or credit-card payment type | +| `paymentAccountId` | string | Yes | Bank or credit-card account ID matching the payment type | +| `billAllocations` | json | Yes | Bounded Bill ID and amount allocations that equal totalAmount | +| `transactionDate` | string | No | Payment date in YYYY-MM-DD format | +| `privateNote` | string | No | Internal payment note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks BillPayment | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_bill_payment` + +Sparse-update BillPayment date or note without changing allocations or payment accounts + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `billPaymentId` | string | Yes | BillPayment ID to update | +| `syncToken` | string | Yes | Current BillPayment sync token | +| `vendorId` | string | Yes | Current vendor ID required by QuickBooks | +| `transactionDate` | string | No | Replacement payment date in YYYY-MM-DD format | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks BillPayment | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_vendor_credit` + +Create a vendor credit without applying it to a bill + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorId` | string | Yes | Vendor issuing the credit | +| `lines` | json | Yes | Bounded account-based or item-based expense lines | +| `apAccountId` | string | No | Optional accounts-payable account ID | +| `transactionDate` | string | No | Credit date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional vendor-credit number | +| `privateNote` | string | No | Internal vendor-credit note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks VendorCredit | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_vendor_credit` + +Sparse-update vendor-credit header fields using its vendor and current sync token + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `vendorCreditId` | string | Yes | VendorCredit ID to update | +| `syncToken` | string | Yes | Current vendor-credit sync token | +| `vendorId` | string | Yes | Current or replacement vendor ID required by QuickBooks | +| `apAccountId` | string | No | Replacement accounts-payable account ID | +| `transactionDate` | string | No | Replacement date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement vendor-credit number | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks VendorCredit | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_purchase` + +Record a cash, check, or credit-card purchase with bounded expense lines + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `paymentType` | string | Yes | Cash, check, or credit-card purchase type | +| `paymentAccountId` | string | Yes | Bank or credit-card account ID matching the purchase type | +| `lines` | json | Yes | Bounded account-based or item-based expense lines | +| `vendorId` | string | No | Optional vendor payee ID | +| `transactionDate` | string | No | Purchase date in YYYY-MM-DD format | +| `paymentReference` | string | No | Optional transaction reference number, such as a check number, sent as the purchase DocNumber | +| `privateNote` | string | No | Internal purchase note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks Purchase | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_purchase` + +Sparse-update purchase header fields without changing lines or payment accounts + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `purchaseId` | string | Yes | Purchase ID to update | +| `syncToken` | string | Yes | Current purchase sync token | +| `currentPaymentType` | string | Yes | Current purchase payment type, re-sent unchanged because QuickBooks requires it for sparse updates | +| `vendorId` | string | No | Replacement vendor payee ID | +| `transactionDate` | string | No | Replacement purchase date in YYYY-MM-DD format | +| `paymentReference` | string | No | Replacement transaction reference number, such as a check number, sent as the purchase DocNumber | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Purchase | +| ↳ `Id` | string | QuickBooks purchasing transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks expense or allocation lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_read_accounting_transactions` + +List or read one journal entry, deposit, or transfer + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionType` | string | Yes | Accounting transaction type to read | +| `readMode` | string | Yes | Whether to list transactions or read one transaction by ID | +| `transactionId` | string | No | QuickBooks transaction ID, required for by-ID reads | +| `startPosition` | number | No | One-based position of the first list record to return | +| `maxResults` | number | No | Number of list records to request \(1–100\) | +| `startDate` | string | No | List transactions on or after this date in YYYY-MM-DD format | +| `endDate` | string | No | List transactions on or before this date in YYYY-MM-DD format | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `transactionType` | string | Accounting transaction type returned | +| `item` | json | Single native QuickBooks accounting transaction | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `items` | array | Native QuickBooks accounting transactions | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_create_journal_entry` + +Post a balanced journal entry after explicit confirmation + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `lines` | json | Yes | Two to 100 balanced debit and credit lines | +| `confirmPosting` | boolean | Yes | Explicit confirmation that this journal entry should be posted | +| `transactionDate` | string | No | Journal-entry date in YYYY-MM-DD format | +| `documentNumber` | string | No | Optional journal-entry number | +| `privateNote` | string | No | Internal journal-entry note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks JournalEntry | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_journal_entry` + +Sparse-update journal-entry header fields after explicit confirmation + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `journalEntryId` | string | Yes | Journal Entry ID to update | +| `syncToken` | string | Yes | Current journal-entry sync token | +| `confirmPosting` | boolean | Yes | Explicit confirmation that this journal-entry update should be posted | +| `transactionDate` | string | No | Replacement date in YYYY-MM-DD format | +| `documentNumber` | string | No | Replacement journal-entry number | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks JournalEntry | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_create_deposit` + +Create a deposit with bounded account lines + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `depositAccountId` | string | Yes | Bank or asset account receiving the deposit | +| `lines` | json | Yes | One to 100 account-based deposit lines | +| `transactionDate` | string | No | Deposit date in YYYY-MM-DD format | +| `privateNote` | string | No | Internal deposit note | +| `requestId` | string | No | Optional Intuit idempotency request ID, up to 50 characters | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Created native QuickBooks Deposit | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_update_deposit` + +Sparse-update deposit header fields using the current sync token and destination account + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `depositId` | string | Yes | Deposit ID to update | +| `syncToken` | string | Yes | Current deposit sync token | +| `depositAccountId` | string | Yes | Current QuickBooks account receiving the deposit | +| `transactionDate` | string | No | Replacement date in YYYY-MM-DD format | +| `privateNote` | string | No | Replacement internal note | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `recordId` | string | ID of the created or updated QuickBooks entity | +| `syncToken` | string | Latest sync token required for a subsequent update | +| `time` | string | QuickBooks response timestamp | +| `record` | json | Updated native QuickBooks Deposit | +| ↳ `Id` | string | QuickBooks accounting transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `Adjustment` | boolean | Whether the journal entry is an adjusting entry | +| ↳ `DepositToAccountRef` | json | Account receiving a deposit | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `FromAccountRef` | json | Transfer source account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ToAccountRef` | json | Transfer destination account | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks journal or deposit lines | +| ↳ `Amount` | number | Transfer amount | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_run_financial_report` + +Run a fixed QuickBooks financial report with verified accountant-focused filters + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `reportType` | string | Yes | Fixed QuickBooks financial report to run | +| `startDate` | string | No | Report start date in YYYY-MM-DD format; Intuit recommends periods of six months or less for performance | +| `endDate` | string | No | Report end or as-of date in YYYY-MM-DD format | +| `accountingMethod` | string | No | Use the QuickBooks default, cash basis, or accrual basis | +| `summarizeBy` | string | No | Time period or business dimension used to summarize report columns | +| `customerId` | string | No | Single QuickBooks customer ID filter | +| `vendorId` | string | No | Single QuickBooks vendor ID filter | +| `accountId` | string | No | Single QuickBooks account ID filter | +| `itemId` | string | No | Single QuickBooks item ID filter | +| `classId` | string | No | Single QuickBooks class ID filter | +| `departmentId` | string | No | Single QuickBooks department ID filter | +| `agingMethod` | string | No | Age open balances from the report date or current date | +| `agingDays` | number | No | Positive number of days in each aging period | +| `transactionType` | string | No | Transaction type filter for Transaction List | +| `groupBy` | string | No | Grouping dimension for Transaction List | +| `accountsPayablePaid` | string | No | Accounts-payable paid status for Transaction List | +| `accountsReceivablePaid` | string | No | Accounts-receivable paid status for Transaction List | +| `clearedStatus` | string | No | Cleared status filter for Transaction List | +| `documentNumber` | string | No | Document number filter for Transaction List | +| `sourceAccountType` | string | No | Source account type filter for Transaction List | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `reportType` | string | Financial report type that was run | +| `header` | json | Native QuickBooks report header with name, periods, basis, currency, summarization, filters, and options | +| ↳ `Time` | string | QuickBooks report generation timestamp | +| ↳ `ReportName` | string | Native QuickBooks report name | +| ↳ `DateMacro` | string | QuickBooks date macro, when returned | +| ↳ `ReportBasis` | string | Cash or accrual basis | +| ↳ `StartPeriod` | string | Report start date | +| ↳ `EndPeriod` | string | Report end or as-of date | +| ↳ `SummarizeColumnsBy` | string | Dimension or time period used for report columns | +| ↳ `Currency` | string | Report currency | +| ↳ `Customer` | string | Applied customer filter | +| ↳ `Vendor` | string | Applied vendor filter | +| ↳ `Account` | string | Applied account filter | +| ↳ `Item` | string | Applied item filter | +| ↳ `Class` | string | Applied class filter | +| ↳ `Department` | string | Applied department filter | +| ↳ `Option` | array | Native QuickBooks report options, including no-data indicators when present | +| `columns` | json | Native QuickBooks report column definitions | +| ↳ `Column` | array | Native report column definitions with titles, types, and metadata | +| ↳ `ColTitle` | string | Column title | +| ↳ `ColType` | string | QuickBooks column data type | +| ↳ `MetaData` | array | Native column metadata name/value entries | +| `rows` | json | Native hierarchical QuickBooks report rows and section summaries | +| ↳ `Row` | array | Native hierarchical report rows; section rows may contain Header, nested Rows, and Summary, while data rows contain ColData values, IDs, and links | +| ↳ `type` | string | QuickBooks row type | +| ↳ `group` | string | QuickBooks section group | +| ↳ `Header` | json | Section header column data | +| ↳ `ColData` | array | Row values with optional operational IDs and links | +| ↳ `Rows` | json | Nested native QuickBooks report rows | +| ↳ `Summary` | json | Section summary column data | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_email_transaction` + +Send a supported QuickBooks transaction by email. This causes an external email and Intuit limits sandbox email delivery. + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionType` | string | Yes | Supported transaction type to email | +| `transactionId` | string | Yes | QuickBooks transaction ID | +| `recipient` | string | No | Required for Customer Payments; otherwise an optional single recipient override | +| `confirmSend` | boolean | Yes | Explicit confirmation that an external email should be sent | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `transactionType` | string | Emailed QuickBooks transaction type | +| `transactionId` | string | Emailed QuickBooks transaction ID | +| `sent` | boolean | Whether QuickBooks accepted the email send request | +| `record` | json | Native QuickBooks transaction returned after sending | +| ↳ `Id` | string | QuickBooks transaction ID | +| ↳ `SyncToken` | string | Current transaction sync token | +| ↳ `DocNumber` | string | Transaction document number | +| ↳ `TxnDate` | string | Transaction date | +| ↳ `DueDate` | string | Transaction due date | +| ↳ `ExpirationDate` | string | Estimate expiration date | +| ↳ `CustomerRef` | json | Customer reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CustomerMemo` | json | Customer-facing memo | +| ↳ `DepositToAccountRef` | json | Deposit account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentMethodRef` | json | Payment method reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `PaymentRefNum` | string | Payment reference number | +| ↳ `CurrencyRef` | json | Transaction currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `Line` | array | Native QuickBooks sales or purchasing transaction lines | +| ↳ `Id` | string | QuickBooks transaction line ID | +| ↳ `LineNum` | number | QuickBooks transaction line number | +| ↳ `Description` | string | Transaction line description | +| ↳ `Amount` | number | Transaction line amount | +| ↳ `DetailType` | string | QuickBooks line detail type | +| ↳ `LinkedTxn` | array | Transactions linked to this QuickBooks line | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `AccountBasedExpenseLineDetail` | json | Native QuickBooks account-based expense details | +| ↳ `ItemBasedExpenseLineDetail` | json | Native QuickBooks item-based expense details | +| ↳ `SalesItemLineDetail` | json | Native QuickBooks sales item line details | +| ↳ `DescriptionLineDetail` | json | Native QuickBooks description line details | +| ↳ `LinkedTxn` | array | Transactions linked by QuickBooks | +| ↳ `TxnId` | string | Linked QuickBooks transaction ID | +| ↳ `TxnType` | string | Linked QuickBooks transaction type | +| ↳ `TxnLineId` | string | Linked QuickBooks transaction line ID | +| ↳ `TotalAmt` | number | Transaction total amount | +| ↳ `Balance` | number | Remaining transaction balance | +| ↳ `UnappliedAmt` | number | Unapplied payment amount | +| ↳ `PrivateNote` | string | Internal transaction note | +| ↳ `TxnStatus` | string | Transaction status | +| ↳ `TxnTaxDetail` | json | Calculated tax details | +| ↳ `MetaData` | json | Transaction creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `VendorRef` | json | Vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts-payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `AccountRef` | json | Payment account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `EntityRef` | json | Purchase payee reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `type` | string | Referenced entity type | +| ↳ `PaymentType` | string | Purchase payment type | +| ↳ `PayType` | string | Bill-payment type | +| ↳ `CheckPayment` | json | Check payment account details | +| ↳ `CreditCardPayment` | json | Credit-card payment account details | +| ↳ `POStatus` | string | Purchase order status | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_download_transaction_pdf` + +Download a supported QuickBooks transaction as a bounded PDF file + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `transactionType` | string | Yes | Supported transaction type to download | +| `transactionId` | string | Yes | QuickBooks transaction ID | +| `fileName` | string | No | Optional safe PDF filename override | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `file` | file | Downloaded file stored in execution files | +| `fileName` | string | Safe downloaded filename | +| `mimeType` | string | Downloaded file MIME type | +| `size` | number | Downloaded file size in bytes | +| `transactionType` | string | Downloaded QuickBooks transaction type | +| `transactionId` | string | Downloaded QuickBooks transaction ID | + +### `quickbooks_read_attachments` + +List attachment metadata for a fixed QuickBooks entity or read one attachment by ID + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `readMode` | string | Yes | Read mode: list or by_id | +| `targetType` | string | No | Fixed QuickBooks entity type for List mode | +| `targetId` | string | No | QuickBooks entity ID for List mode | +| `attachmentId` | string | No | QuickBooks attachment ID for By ID mode | +| `startPosition` | number | No | One-based list start position; defaults to 1 | +| `maxResults` | number | No | List page size from 1 through 100; defaults to 25 | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | +| `item` | json | Native QuickBooks attachment metadata | +| ↳ `Id` | string | QuickBooks attachment ID | +| ↳ `SyncToken` | string | Attachment sync token | +| ↳ `FileName` | string | Attached file name | +| ↳ `ContentType` | string | Attached file MIME type | +| ↳ `Size` | number | Attached file size in bytes | +| ↳ `Note` | string | Attachment note or description | +| ↳ `Category` | string | Native QuickBooks attachment category | +| ↳ `AttachableRef` | array | QuickBooks entities referenced by this attachment | +| ↳ `EntityRef` | json | Attached entity type and operational ID | +| ↳ `IncludeOnSend` | boolean | Whether QuickBooks includes the attachment when sending | +| ↳ `MetaData` | json | Attachment creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | +| `items` | array | Native QuickBooks attachment metadata page | +| ↳ `Id` | string | QuickBooks attachment ID | +| ↳ `SyncToken` | string | Attachment sync token | +| ↳ `FileName` | string | Attached file name | +| ↳ `ContentType` | string | Attached file MIME type | +| ↳ `Size` | number | Attached file size in bytes | +| ↳ `Note` | string | Attachment note or description | +| ↳ `Category` | string | Native QuickBooks attachment category | +| ↳ `AttachableRef` | array | QuickBooks entities referenced by this attachment | +| ↳ `EntityRef` | json | Attached entity type and operational ID | +| ↳ `IncludeOnSend` | boolean | Whether QuickBooks includes the attachment when sending | +| ↳ `MetaData` | json | Attachment creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | + +### `quickbooks_add_attachment` + +Attach one supported file or one note to a fixed QuickBooks entity + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `attachmentKind` | string | Yes | Attachment kind: file or note | +| `targetType` | string | Yes | Fixed QuickBooks entity type to attach to | +| `targetId` | string | Yes | QuickBooks target entity ID | +| `file` | file | No | Single Sim file to upload | +| `fileName` | string | No | Optional safe filename override | +| `contentType` | string | No | Optional compatible QuickBooks MIME type override | +| `description` | string | No | Optional file attachment description | +| `note` | string | No | Required nonempty note text in Note mode | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `attachment` | json | Created native QuickBooks attachment metadata | +| ↳ `Id` | string | QuickBooks attachment ID | +| ↳ `SyncToken` | string | Attachment sync token | +| ↳ `FileName` | string | Attached file name | +| ↳ `ContentType` | string | Attached file MIME type | +| ↳ `Size` | number | Attached file size in bytes | +| ↳ `Note` | string | Attachment note or description | +| ↳ `Category` | string | Native QuickBooks attachment category | +| ↳ `AttachableRef` | array | QuickBooks entities referenced by this attachment | +| ↳ `EntityRef` | json | Attached entity type and operational ID | +| ↳ `IncludeOnSend` | boolean | Whether QuickBooks includes the attachment when sending | +| ↳ `MetaData` | json | Attachment creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| ↳ `domain` | string | QuickBooks domain | +| ↳ `sparse` | boolean | Whether this is a sparse entity | +| `attachmentId` | string | Created QuickBooks attachment ID | +| `attachmentKind` | string | Created attachment kind | +| `targetType` | string | QuickBooks target entity type | +| `targetId` | string | QuickBooks target entity ID | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_download_attachment` + +Download a QuickBooks file attachment through its short-lived URL + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `attachmentId` | string | Yes | QuickBooks attachment ID | +| `fileName` | string | No | Optional safe filename override | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `file` | file | Downloaded file stored in execution files | +| `fileName` | string | Safe downloaded filename | +| `mimeType` | string | Downloaded file MIME type | +| `size` | number | Downloaded file size in bytes | +| `attachmentId` | string | Downloaded QuickBooks attachment ID | + + diff --git a/apps/sim/.env.example b/apps/sim/.env.example index acb633776bf..fc275846d34 100644 --- a/apps/sim/.env.example +++ b/apps/sim/.env.example @@ -121,6 +121,11 @@ CRON_SECRET=your_cron_secret # Use `openssl rand -hex 32` to generate. Authentic # TIKTOK_CLIENT_ID= # TIKTOK_CLIENT_SECRET= +# QuickBooks Online OAuth (Optional - credentials from the Intuit Developer Portal) +# QUICKBOOKS_CLIENT_ID= +# QUICKBOOKS_CLIENT_SECRET= +# QUICKBOOKS_ENV=sandbox # Required when QuickBooks is configured: sandbox or production + # Azure Blob Storage takes precedence over S3 if both are configured # AZURE_ACCOUNT_NAME= # Azure storage account name # AZURE_ACCOUNT_KEY= # Azure storage account key diff --git a/apps/sim/app/api/auth/[...all]/route.test.ts b/apps/sim/app/api/auth/[...all]/route.test.ts index 4c577409990..29c3cc27425 100644 --- a/apps/sim/app/api/auth/[...all]/route.test.ts +++ b/apps/sim/app/api/auth/[...all]/route.test.ts @@ -30,6 +30,7 @@ vi.mock('@/lib/auth/anonymous', () => ({ createAnonymousSession: handlerMocks.createAnonymousSession, })) +import { getQuickBooksCallbackRealm } from '@/lib/oauth/quickbooks' import { GET, POST } from '@/app/api/auth/[...all]/route' afterAll(resetEnvFlagsMock) @@ -132,3 +133,67 @@ describe('auth catch-all route organization mutations', () => { expect(json).toEqual({ data: { ok: true } }) }) }) + +describe('auth catch-all route QuickBooks callback', () => { + beforeEach(() => { + vi.clearAllMocks() + setEnvFlags({ isAuthDisabled: false }) + }) + + it('binds the callback realm only while Better Auth processes the OAuth response', async () => { + const { NextResponse } = await import('next/server') + handlerMocks.betterAuthGET.mockImplementationOnce(async () => { + await Promise.resolve() + expect(getQuickBooksCallbackRealm()).toBe('123456789') + return new NextResponse(null, { status: 302 }) + }) + + const req = createMockRequest( + 'GET', + undefined, + {}, + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test&realmId=123456789' + ) + + const res = await GET(req as any) + + expect(res.status).toBe(302) + expect(handlerMocks.betterAuthGET).toHaveBeenCalledTimes(1) + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + }) + + it('delegates a denied callback without requiring a realm', async () => { + const { NextResponse } = await import('next/server') + handlerMocks.betterAuthGET.mockImplementationOnce(async () => { + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + return new NextResponse(null, { status: 302 }) + }) + + const req = createMockRequest( + 'GET', + undefined, + {}, + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?error=access_denied&state=test' + ) + + const res = await GET(req as any) + + expect(res.status).toBe(302) + expect(handlerMocks.betterAuthGET).toHaveBeenCalledTimes(1) + }) + + it.each([ + ['missing', 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test'], + [ + 'invalid', + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test&realmId=not-a-company', + ], + ])('rejects a %s callback realm before Better Auth exchanges the code', async (_, url) => { + const req = createMockRequest('GET', undefined, {}, url) + + const res = await GET(req as any) + + expect(res.status).toBe(400) + expect(handlerMocks.betterAuthGET).not.toHaveBeenCalled() + }) +}) diff --git a/apps/sim/app/api/auth/[...all]/route.ts b/apps/sim/app/api/auth/[...all]/route.ts index 8456afff4cf..68a94468967 100644 --- a/apps/sim/app/api/auth/[...all]/route.ts +++ b/apps/sim/app/api/auth/[...all]/route.ts @@ -4,6 +4,7 @@ import { auth } from '@/lib/auth' import { createAnonymousSession, ensureAnonymousUserExists } from '@/lib/auth/anonymous' import { isAuthDisabled } from '@/lib/core/config/env-flags' import { withRouteHandler } from '@/lib/core/utils/with-route-handler' +import { normalizeQuickBooksRealmId, withQuickBooksCallbackRealm } from '@/lib/oauth/quickbooks' export const dynamic = 'force-dynamic' @@ -27,6 +28,32 @@ export const GET = withRouteHandler(async (request: NextRequest) => { return NextResponse.json(createAnonymousSession()) } + if (path === 'oauth2/callback/quickbooks') { + const authorizationCode = request.nextUrl.searchParams.get('code') + if (!authorizationCode) { + return betterAuthGET(request) + } + + const realmId = request.nextUrl.searchParams.get('realmId') + if (!realmId) { + return NextResponse.json( + { error: 'QuickBooks callback did not include a company identity.' }, + { status: 400 } + ) + } + + try { + normalizeQuickBooksRealmId(realmId) + } catch { + return NextResponse.json( + { error: 'QuickBooks callback included an invalid company identity.' }, + { status: 400 } + ) + } + + return withQuickBooksCallbackRealm(realmId, () => betterAuthGET(request)) + } + return betterAuthGET(request) }) diff --git a/apps/sim/app/api/auth/oauth/token/route.test.ts b/apps/sim/app/api/auth/oauth/token/route.test.ts index e1ef6105675..67a36cb7558 100644 --- a/apps/sim/app/api/auth/oauth/token/route.test.ts +++ b/apps/sim/app/api/auth/oauth/token/route.test.ts @@ -67,12 +67,74 @@ describe('OAuth Token API Routes', () => { expect(response.status).toBe(200) expect(data).toHaveProperty('accessToken', 'fresh-token') + expect(data).not.toHaveProperty('realmId') expect(mockAuthorizeCredentialUse).toHaveBeenCalled() expect(authOAuthUtilsMockFns.mockGetCredential).toHaveBeenCalled() expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).toHaveBeenCalled() }) + it('returns realmId only for QuickBooks credentials', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'owner-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'quickbooks:123456789:intuit-subject-01234567-89ab-4def-8abc-0123456789ab', + accessToken: 'test-token', + refreshToken: 'refresh-token', + accessTokenExpiresAt: new Date(Date.now() + 3600 * 1000), + providerId: 'quickbooks', + }) + authOAuthUtilsMockFns.mockRefreshTokenIfNeeded.mockResolvedValueOnce({ + accessToken: 'fresh-token', + refreshed: false, + }) + + const response = await POST( + createMockRequest('POST', { + credentialId: 'credential-id', + }) + ) + + expect(response.status).toBe(200) + expect(await response.json()).toEqual({ + accessToken: 'fresh-token', + realmId: '123456789', + }) + }) + + it('rejects a malformed QuickBooks company identity with reconnect guidance', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'owner-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'malformed', + accessToken: 'test-token', + refreshToken: 'refresh-token', + accessTokenExpiresAt: new Date(Date.now() + 3600 * 1000), + providerId: 'quickbooks', + }) + + const response = await POST( + createMockRequest('POST', { + credentialId: 'credential-id', + }) + ) + const data = await response.json() + + expect(response.status).toBe(401) + expect(data.error).toMatch(/Reconnect the QuickBooks credential/) + expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).not.toHaveBeenCalled() + }) + it('should handle workflowId for server-side authentication', async () => { mockAuthorizeCredentialUse.mockResolvedValueOnce({ ok: true, @@ -517,6 +579,33 @@ describe('OAuth Token API Routes', () => { expect(data).toHaveProperty('error') }) + it('rejects a malformed QuickBooks identity before reporting a missing token', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'test-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'malformed', + accessToken: null, + refreshToken: 'refresh-token', + providerId: 'quickbooks', + }) + + const response = await GET( + new NextRequest( + 'http://localhost:3000/api/auth/oauth/token?credentialId=credential-id' + ) as any + ) + const data = await response.json() + + expect(response.status).toBe(401) + expect(data.error).toMatch(/Reconnect the QuickBooks credential/) + expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).not.toHaveBeenCalled() + }) + it('should handle token refresh failure', async () => { mockAuthorizeCredentialUse.mockResolvedValueOnce({ ok: true, diff --git a/apps/sim/app/api/auth/oauth/token/route.ts b/apps/sim/app/api/auth/oauth/token/route.ts index 302898717d0..8ad51b53f98 100644 --- a/apps/sim/app/api/auth/oauth/token/route.ts +++ b/apps/sim/app/api/auth/oauth/token/route.ts @@ -12,6 +12,7 @@ import { AuthType, checkSessionOrInternalAuth } from '@/lib/auth/hybrid' import { generateRequestId } from '@/lib/core/utils/request' import { withRouteHandler } from '@/lib/core/utils/with-route-handler' import { TokenServiceAccountValidationError } from '@/lib/credentials/token-service-accounts/errors' +import { parseQuickBooksAccountId } from '@/lib/oauth/quickbooks' import { captureServerEvent } from '@/lib/posthog/server' import { getCredential, @@ -254,6 +255,23 @@ export const POST = withRouteHandler(async (request: NextRequest) => { const oauthActorId = authz.requesterUserId const oauthWorkspaceId = authz.workspaceId ?? null + let realmId: string | undefined + if (credential.providerId === 'quickbooks') { + try { + realmId = parseQuickBooksAccountId(credential.accountId).realmId + } catch (error) { + return NextResponse.json( + { + error: getErrorMessage( + error, + 'QuickBooks company identity is invalid. Reconnect the QuickBooks credential.' + ), + }, + { status: 401 } + ) + } + } + try { const { accessToken } = await refreshTokenIfNeeded( requestId, @@ -311,6 +329,7 @@ export const POST = withRouteHandler(async (request: NextRequest) => { accessToken, idToken: credential.idToken || undefined, ...(instanceUrl && { instanceUrl }), + ...(realmId && { realmId }), ...(apiDomain && { apiDomain }), }, { status: 200 } @@ -369,14 +388,31 @@ export const GET = withRouteHandler(async (request: NextRequest) => { return NextResponse.json({ error: 'Credential not found' }, { status: 404 }) } + const actorId = authz.requesterUserId + const workspaceId = authz.workspaceId ?? null + + let realmId: string | undefined + if (credential.providerId === 'quickbooks') { + try { + realmId = parseQuickBooksAccountId(credential.accountId).realmId + } catch (error) { + return NextResponse.json( + { + error: getErrorMessage( + error, + 'QuickBooks company identity is invalid. Reconnect the QuickBooks credential.' + ), + }, + { status: 401 } + ) + } + } + if (!credential.accessToken) { logger.warn(`[${requestId}] No access token available for credential`) return NextResponse.json({ error: 'No access token available' }, { status: 400 }) } - const actorId = authz.requesterUserId - const workspaceId = authz.workspaceId ?? null - try { const { accessToken } = await refreshTokenIfNeeded( requestId, @@ -435,6 +471,7 @@ export const GET = withRouteHandler(async (request: NextRequest) => { accessToken, idToken: credential.idToken || undefined, ...(instanceUrl && { instanceUrl }), + ...(realmId && { realmId }), ...(apiDomain && { apiDomain }), }, { status: 200 } diff --git a/apps/sim/app/api/auth/oauth/utils.test.ts b/apps/sim/app/api/auth/oauth/utils.test.ts index 4a22a97b8fc..1657251722a 100644 --- a/apps/sim/app/api/auth/oauth/utils.test.ts +++ b/apps/sim/app/api/auth/oauth/utils.test.ts @@ -7,6 +7,20 @@ import { redisConfigMockFns } from '@sim/testing' import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest' +const { capturedLeaderLockOptions } = vi.hoisted(() => ({ + capturedLeaderLockOptions: [] as Array>, +})) +vi.mock('@/lib/concurrency/leader-lock', async (importOriginal) => { + const actual = await importOriginal() + return { + ...actual, + withLeaderLock: vi.fn((options) => { + capturedLeaderLockOptions.push(options as unknown as Record) + return actual.withLeaderLock(options) + }), + } +}) + vi.mock('@/lib/oauth/oauth', () => ({ refreshOAuthToken: vi.fn(), OAUTH_PROVIDERS: {}, @@ -70,6 +84,7 @@ function mockUpdateChain() { describe('OAuth Utils', () => { beforeEach(() => { vi.clearAllMocks() + capturedLeaderLockOptions.length = 0 __resetCoalesceLocallyForTests() redisConfigMockFns.mockGetRedisClient.mockReturnValue(null) redisConfigMockFns.mockAcquireLock.mockResolvedValue(true) @@ -420,6 +435,62 @@ describe('OAuth Utils', () => { }) }) + describe('QuickBooks refresh locking', () => { + it('keeps the lock and follower wait alive beyond the provider timeout', async () => { + const credential = { + id: 'quickbooks-row', + accessToken: 'expired-token', + refreshToken: 'rotating-refresh-token', + accessTokenExpiresAt: new Date(Date.now() - 3600 * 1000), + providerId: 'quickbooks', + } + mockRefreshOAuthToken.mockResolvedValueOnce({ + ok: true, + accessToken: 'new-token', + expiresIn: 3600, + refreshToken: 'new-rotating-refresh-token', + }) + mockUpdateChain() + + const result = await refreshTokenIfNeeded('request-id', credential, credential.id) + + expect(result).toEqual({ accessToken: 'new-token', refreshed: true }) + expect(redisConfigMockFns.mockAcquireLock).toHaveBeenCalledWith( + 'oauth:refresh:quickbooks-row', + expect.any(String), + 30 + ) + expect(capturedLeaderLockOptions[0]).toMatchObject({ ttlSec: 30, maxWaitMs: 30_000 }) + }) + + it('keeps the default refresh-lock budget for other providers', async () => { + const credential = { + id: 'google-row', + accessToken: 'expired-token', + refreshToken: 'refresh-token', + accessTokenExpiresAt: new Date(Date.now() - 3600 * 1000), + providerId: 'google', + } + mockRefreshOAuthToken.mockResolvedValueOnce({ + ok: true, + accessToken: 'new-token', + expiresIn: 3600, + refreshToken: 'new-refresh-token', + }) + mockUpdateChain() + + await refreshTokenIfNeeded('request-id', credential, credential.id) + + expect(redisConfigMockFns.mockAcquireLock).toHaveBeenCalledWith( + 'oauth:refresh:google-row', + expect.any(String), + 10 + ) + expect(capturedLeaderLockOptions[0]).not.toHaveProperty('ttlSec') + expect(capturedLeaderLockOptions[0]).not.toHaveProperty('maxWaitMs') + }) + }) + describe('resolveServiceAccountToken', () => { it('throws loudly for an unknown provider (never silently attempts Google)', async () => { await expect(resolveServiceAccountToken('cred-1', 'mystery-provider')).rejects.toThrow( diff --git a/apps/sim/app/api/auth/oauth/utils.ts b/apps/sim/app/api/auth/oauth/utils.ts index b004e1d3148..1d69d305820 100644 --- a/apps/sim/app/api/auth/oauth/utils.ts +++ b/apps/sim/app/api/auth/oauth/utils.ts @@ -701,6 +701,8 @@ interface CoalescedRefreshOptions { */ const SLACK_LOCK_TTL_SEC = 30 const SLACK_FOLLOWER_MAX_WAIT_MS = SLACK_LOCK_TTL_SEC * 1000 +const QUICKBOOKS_LOCK_TTL_SEC = 30 +const QUICKBOOKS_FOLLOWER_MAX_WAIT_MS = QUICKBOOKS_LOCK_TTL_SEC * 1000 async function performCoalescedRefresh({ accountId, @@ -716,6 +718,7 @@ async function performCoalescedRefresh({ * dead-flagged, and written per installation rather than per row. */ const slackTeamId = isSlackProvider(providerId) ? extractSlackTeamId(providerAccountId) : null + const isQuickBooks = providerId === 'quickbooks' const scopeKey = slackTeamId ? `slack:${slackTeamId}` : accountId const logContext = { @@ -744,7 +747,14 @@ async function performCoalescedRefresh({ // so their wait and the lock TTL must outlast the 15s provider timeout — // the 3s/10s defaults would fail followers early and let a second leader // start a concurrent rotation mid-refresh. - ...(slackTeamId ? { maxWaitMs: SLACK_FOLLOWER_MAX_WAIT_MS, ttlSec: SLACK_LOCK_TTL_SEC } : {}), + ...(slackTeamId + ? { maxWaitMs: SLACK_FOLLOWER_MAX_WAIT_MS, ttlSec: SLACK_LOCK_TTL_SEC } + : isQuickBooks + ? { + maxWaitMs: QUICKBOOKS_FOLLOWER_MAX_WAIT_MS, + ttlSec: QUICKBOOKS_LOCK_TTL_SEC, + } + : {}), onLeader: async () => { try { let refreshTokenToUse = refreshToken diff --git a/apps/sim/app/api/tools/quickbooks/add-attachment/route.ts b/apps/sim/app/api/tools/quickbooks/add-attachment/route.ts new file mode 100644 index 00000000000..24d92dd129d --- /dev/null +++ b/apps/sim/app/api/tools/quickbooks/add-attachment/route.ts @@ -0,0 +1,175 @@ +import { createLogger } from '@sim/logger' +import { getErrorMessage } from '@sim/utils/errors' +import { type NextRequest, NextResponse } from 'next/server' +import { quickBooksAddAttachmentContract } from '@/lib/api/contracts/tools/quickbooks' +import { getValidationErrorMessage, parseRequest } from '@/lib/api/server' +import { checkInternalAuth } from '@/lib/auth/hybrid' +import { assertKnownSizeWithinLimit, isPayloadSizeLimitError } from '@/lib/core/utils/stream-limits' +import { withRouteHandler } from '@/lib/core/utils/with-route-handler' +import { processFilesToUserFiles } from '@/lib/uploads/utils/file-utils' +import { downloadServableFileFromStorage } from '@/lib/uploads/utils/file-utils.server' +import { docNotReadyResponse } from '@/lib/uploads/utils/servable-file-response' +import { assertToolFileAccess } from '@/app/api/files/authorization' +import { buildQuickBooksCompanyUrl, buildQuickBooksHeaders } from '@/tools/quickbooks/client' +import { + assertQuickBooksAttachmentExtension, + assertSingleQuickBooksFile, + buildQuickBooksAttachableMetadata, + getQuickBooksDocumentError, + parseQuickBooksAttachableResponse, + QUICKBOOKS_DOCUMENT_METADATA_TIMEOUT_MS, + QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS, + QUICKBOOKS_MAX_ATTACHMENT_BYTES, + quickBooksDocumentSignal, + sanitizeQuickBooksFileName, + validateQuickBooksAttachmentFileType, +} from '@/tools/quickbooks/documents_utils' + +export const dynamic = 'force-dynamic' +const logger = createLogger('QuickBooksAddAttachmentAPI') + +export const POST = withRouteHandler(async (request: NextRequest) => { + const requestId = `quickbooks-attachment-${Date.now()}` + try { + const authResult = await checkInternalAuth(request, { requireWorkflowId: false }) + if (!authResult.success || !authResult.userId) { + return NextResponse.json( + { success: false, error: authResult.error || 'Unauthorized' }, + { status: 401 } + ) + } + + const parsed = await parseRequest( + quickBooksAddAttachmentContract, + request, + {}, + { + validationErrorResponse: (error) => + NextResponse.json( + { success: false, error: getValidationErrorMessage(error, 'Invalid request') }, + { status: 400 } + ), + } + ) + if (!parsed.success) return parsed.response + const data = parsed.data.body + request.signal.throwIfAborted() + const url = buildQuickBooksCompanyUrl( + data.realmId, + data.attachmentKind === 'file' ? 'upload' : 'attachable' + ) + let response: Response + + if (data.attachmentKind === 'note') { + const metadata = buildQuickBooksAttachableMetadata(data.targetType, data.targetId, { + note: data.note!, + }) + response = await fetch(url, { + method: 'POST', + headers: { + ...buildQuickBooksHeaders(data.accessToken), + 'Content-Type': 'application/json', + }, + body: JSON.stringify(metadata), + signal: quickBooksDocumentSignal(request.signal, QUICKBOOKS_DOCUMENT_METADATA_TIMEOUT_MS), + }) + } else { + request.signal.throwIfAborted() + const rawFile = assertSingleQuickBooksFile(data.file ?? undefined) + const files = processFilesToUserFiles([rawFile], requestId, logger) + if (files.length !== 1) throw new Error('Exactly one valid file is required') + const file = files[0] + assertKnownSizeWithinLimit( + file.size, + QUICKBOOKS_MAX_ATTACHMENT_BYTES, + 'QuickBooks attachment file' + ) + const resolvedName = sanitizeQuickBooksFileName(data.fileName ?? undefined, file.name) + assertQuickBooksAttachmentExtension(resolvedName) + const denied = await assertToolFileAccess(file.key, authResult.userId, requestId, logger) + if (denied) return denied + let downloaded: Awaited> + try { + downloaded = await downloadServableFileFromStorage(file, requestId, logger, { + maxBytes: QUICKBOOKS_MAX_ATTACHMENT_BYTES, + signal: request.signal, + }) + } catch (error) { + const notReady = docNotReadyResponse(error) + if (notReady) return notReady + throw error + } + request.signal.throwIfAborted() + assertKnownSizeWithinLimit( + downloaded.buffer.length, + QUICKBOOKS_MAX_ATTACHMENT_BYTES, + 'QuickBooks attachment file' + ) + if (downloaded.buffer.length === 0) + throw new Error('QuickBooks attachment file cannot be empty') + const storedMime = (downloaded.contentType || file.type || '') + .split(';', 1)[0] + .trim() + .toLowerCase() + const requestedMime = data.contentType?.trim().toLowerCase() || storedMime + const mimeType = validateQuickBooksAttachmentFileType(resolvedName, requestedMime) + if (data.contentType && storedMime && requestedMime !== storedMime) { + validateQuickBooksAttachmentFileType(resolvedName, storedMime) + } + const metadata = buildQuickBooksAttachableMetadata(data.targetType, data.targetId, { + fileName: resolvedName, + contentType: mimeType, + description: data.description ?? undefined, + }) + const formData = new FormData() + formData.append( + 'file_metadata_01', + new Blob([JSON.stringify(metadata)], { type: 'application/json' }), + 'attachment.json' + ) + formData.append( + 'file_content_01', + new Blob( + [ + new Uint8Array( + downloaded.buffer.buffer as ArrayBuffer, + downloaded.buffer.byteOffset, + downloaded.buffer.byteLength + ), + ], + { type: mimeType } + ), + resolvedName + ) + request.signal.throwIfAborted() + response = await fetch(url, { + method: 'POST', + headers: buildQuickBooksHeaders(data.accessToken), + body: formData, + signal: quickBooksDocumentSignal(request.signal, QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS), + }) + } + + if (!response.ok) throw await getQuickBooksDocumentError(response, request.signal) + const transformed = await parseQuickBooksAttachableResponse(response, request.signal) + return NextResponse.json({ + success: true, + output: { + attachment: transformed.attachment, + attachmentId: transformed.attachment.Id.trim(), + attachmentKind: data.attachmentKind, + targetType: data.targetType, + targetId: data.targetId, + time: transformed.time, + }, + }) + } catch (error) { + logger.error(`[${requestId}] QuickBooks attachment creation failed`, { + error: getErrorMessage(error), + }) + return NextResponse.json( + { success: false, error: getErrorMessage(error, 'Failed to add QuickBooks attachment') }, + { status: isPayloadSizeLimitError(error) ? 413 : 500 } + ) + } +}) diff --git a/apps/sim/app/api/tools/quickbooks/download-document/route.ts b/apps/sim/app/api/tools/quickbooks/download-document/route.ts new file mode 100644 index 00000000000..f788583fe3d --- /dev/null +++ b/apps/sim/app/api/tools/quickbooks/download-document/route.ts @@ -0,0 +1,244 @@ +import { createLogger } from '@sim/logger' +import { getErrorMessage } from '@sim/utils/errors' +import { type NextRequest, NextResponse } from 'next/server' +import { userFileSchema } from '@/lib/api/contracts/primitives' +import { + type QuickBooksDownloadDocumentBody, + quickBooksDownloadDocumentContract, +} from '@/lib/api/contracts/tools/quickbooks' +import { getValidationErrorMessage, parseRequest } from '@/lib/api/server' +import { checkInternalAuth } from '@/lib/auth/hybrid' +import { + secureFetchWithPinnedIP, + validateUrlWithDNS, +} from '@/lib/core/security/input-validation.server' +import { + assertContentLengthWithinLimit, + isPayloadSizeLimitError, + readResponseTextWithLimit, + readResponseToBufferWithLimit, +} from '@/lib/core/utils/stream-limits' +import { withRouteHandler } from '@/lib/core/utils/with-route-handler' +import { storeToolOutputFile } from '@/lib/uploads/store-tool-output-file' +import { buildQuickBooksCompanyUrl, buildQuickBooksHeaders } from '@/tools/quickbooks/client' +import { + getQuickBooksDocumentError, + getQuickBooksDocumentTransaction, + QUICKBOOKS_DOCUMENT_METADATA_TIMEOUT_MS, + QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS, + QUICKBOOKS_MAX_ATTACHMENT_BYTES, + QUICKBOOKS_TEMP_URL_MAX_BYTES, + quickBooksDocumentSignal, + sanitizeQuickBooksFileName, +} from '@/tools/quickbooks/documents_utils' + +export const dynamic = 'force-dynamic' +const logger = createLogger('QuickBooksDownloadDocumentAPI') + +interface DownloadedDocument { + buffer: Buffer + mimeType: string + fileName: string +} + +function contentDispositionFileName(value: string | null): string | undefined { + if (!value) return undefined + const utf8 = value.match(/filename\*=UTF-8''([^;]+)/i)?.[1] + if (utf8) { + try { + return decodeURIComponent(utf8) + } catch { + return utf8 + } + } + return value.match(/filename="?([^";]+)"?/i)?.[1] +} + +/** + * Resolves the short-lived Intuit URL for an attachment, then reads the file + * through the SSRF-guarded pinned-IP client. + */ +async function downloadQuickBooksAttachment( + body: Extract, + signal: AbortSignal +): Promise { + const metadataUrl = buildQuickBooksCompanyUrl( + body.realmId, + `download/${encodeURIComponent(body.attachmentId)}` + ) + const metadataResponse = await fetch(metadataUrl, { + method: 'GET', + headers: { ...buildQuickBooksHeaders(body.accessToken), Accept: 'text/plain' }, + signal: quickBooksDocumentSignal(signal, QUICKBOOKS_DOCUMENT_METADATA_TIMEOUT_MS), + }) + if (!metadataResponse.ok) throw await getQuickBooksDocumentError(metadataResponse, signal) + const temporaryUrl = ( + await readResponseTextWithLimit(metadataResponse, { + maxBytes: QUICKBOOKS_TEMP_URL_MAX_BYTES, + label: 'QuickBooks temporary attachment URL', + signal, + }) + ).trim() + if (!temporaryUrl) throw new Error('This QuickBooks attachment has no downloadable file') + const validation = await validateUrlWithDNS(temporaryUrl, 'QuickBooks attachment URL') + if (!validation.isValid || !validation.resolvedIP) + throw new Error(validation.error || 'QuickBooks attachment URL is invalid') + signal.throwIfAborted() + + const transferSignal = quickBooksDocumentSignal(signal, QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS) + const downloadResponse = await secureFetchWithPinnedIP(temporaryUrl, validation.resolvedIP, { + method: 'GET', + maxResponseBytes: QUICKBOOKS_MAX_ATTACHMENT_BYTES, + stripAuthOnRedirect: true, + timeout: QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS, + signal: transferSignal, + }) + if (downloadResponse.status === 404) + throw new Error('This QuickBooks attachment has no downloadable file') + if (!downloadResponse.ok) + throw new Error(`QuickBooks attachment download failed with HTTP ${downloadResponse.status}`) + assertContentLengthWithinLimit( + downloadResponse.headers, + QUICKBOOKS_MAX_ATTACHMENT_BYTES, + 'QuickBooks attachment file' + ) + const buffer = await readResponseToBufferWithLimit(downloadResponse, { + maxBytes: QUICKBOOKS_MAX_ATTACHMENT_BYTES, + label: 'QuickBooks attachment file', + signal: transferSignal, + }) + if (buffer.length === 0) throw new Error('QuickBooks attachment file is empty') + + let fallbackName = `quickbooks-attachment-${body.attachmentId}` + try { + const urlName = new URL(temporaryUrl).pathname.split('/').pop() + if (urlName) fallbackName = decodeURIComponent(urlName) + } catch { + // The URL was already validated; keep the deterministic fallback. + } + return { + buffer, + mimeType: + downloadResponse.headers.get('content-type')?.split(';', 1)[0]?.trim().toLowerCase() || + 'application/octet-stream', + fileName: sanitizeQuickBooksFileName( + body.fileName ?? undefined, + contentDispositionFileName(downloadResponse.headers.get('content-disposition')) || + fallbackName + ), + } +} + +/** + * Renders a supported transaction as a PDF. The filename is resolved and + * validated first so a bad override fails before any bytes are transferred. + */ +async function downloadQuickBooksTransactionPdf( + body: Extract, + signal: AbortSignal +): Promise { + const fileName = sanitizeQuickBooksFileName( + body.fileName ?? undefined, + `quickbooks-${body.transactionType.replaceAll('_', '-')}-${body.transactionId}.pdf` + ) + if (!fileName.toLowerCase().endsWith('.pdf')) throw new Error('PDF filename must end in .pdf') + + const { resource } = getQuickBooksDocumentTransaction(body.transactionType) + const url = buildQuickBooksCompanyUrl( + body.realmId, + `${resource}/${encodeURIComponent(body.transactionId)}/pdf` + ) + const transferSignal = quickBooksDocumentSignal(signal, QUICKBOOKS_DOCUMENT_TRANSFER_TIMEOUT_MS) + const response = await fetch(url, { + method: 'GET', + headers: { ...buildQuickBooksHeaders(body.accessToken), Accept: 'application/pdf' }, + signal: transferSignal, + }) + if (!response.ok) throw await getQuickBooksDocumentError(response, signal) + + const mimeType = + response.headers.get('content-type')?.split(';', 1)[0]?.trim().toLowerCase() ?? '' + if (mimeType !== 'application/pdf') throw new Error('QuickBooks returned a non-PDF response') + const buffer = await readResponseToBufferWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_ATTACHMENT_BYTES, + label: 'QuickBooks transaction PDF', + signal: transferSignal, + }) + if (buffer.length === 0) throw new Error('QuickBooks returned an empty PDF') + if (buffer.subarray(0, 5).toString('ascii') !== '%PDF-') + throw new Error('QuickBooks returned malformed PDF content') + + return { buffer, mimeType, fileName } +} + +export const POST = withRouteHandler(async (request: NextRequest) => { + try { + const authResult = await checkInternalAuth(request, { requireWorkflowId: false }) + if (!authResult.success || !authResult.userId) { + return NextResponse.json( + { success: false, error: authResult.error || 'Unauthorized' }, + { status: 401 } + ) + } + + const parsed = await parseRequest( + quickBooksDownloadDocumentContract, + request, + {}, + { + validationErrorResponse: (error) => + NextResponse.json( + { success: false, error: getValidationErrorMessage(error, 'Invalid request') }, + { status: 400 } + ), + } + ) + if (!parsed.success) return parsed.response + const body = parsed.data.body + request.signal.throwIfAborted() + + const downloaded = + body.documentKind === 'attachment' + ? await downloadQuickBooksAttachment(body, request.signal) + : await downloadQuickBooksTransactionPdf(body, request.signal) + + request.signal.throwIfAborted() + const storedFile = userFileSchema.parse( + await storeToolOutputFile({ + buffer: downloaded.buffer, + fileName: downloaded.fileName, + contentType: downloaded.mimeType, + userId: authResult.userId, + context: { + workspaceId: body.workspaceId, + workflowId: body.workflowId, + executionId: body.executionId, + }, + }) + ) + + const shared = { + file: storedFile, + fileName: downloaded.fileName, + mimeType: downloaded.mimeType, + size: downloaded.buffer.length, + } + return NextResponse.json({ + success: true, + output: + body.documentKind === 'attachment' + ? { ...shared, attachmentId: body.attachmentId } + : { + ...shared, + transactionType: body.transactionType, + transactionId: body.transactionId, + }, + }) + } catch (error) { + logger.error('QuickBooks document download failed', { error: getErrorMessage(error) }) + return NextResponse.json( + { success: false, error: getErrorMessage(error, 'Failed to download QuickBooks document') }, + { status: isPayloadSizeLimitError(error) ? 413 : 500 } + ) + } +}) diff --git a/apps/sim/blocks/blocks/quickbooks.ts b/apps/sim/blocks/blocks/quickbooks.ts new file mode 100644 index 00000000000..9f60068370c --- /dev/null +++ b/apps/sim/blocks/blocks/quickbooks.ts @@ -0,0 +1,3048 @@ +import { QuickBooksIcon } from '@/components/icons' +import { getScopesForService } from '@/lib/oauth/utils' +import type { BlockConfig, BlockMeta, OutputCondition } from '@/blocks/types' +import { AuthMode, IntegrationType } from '@/blocks/types' +import { normalizeFileInput } from '@/blocks/utils' +import { + parseQuickBooksDepositLines, + parseQuickBooksJournalLines, +} from '@/tools/quickbooks/accounting_utils' +import { + parseQuickBooksBillAllocations, + parseQuickBooksBillLines, + parseQuickBooksPurchasingLines, +} from '@/tools/quickbooks/purchasing_utils' +import { + getQuickBooksReportTypesSupporting, + QUICKBOOKS_REPORT_TYPES_WITH_ALL_SUMMARIES, + QUICKBOOKS_REPORT_TYPES_WITH_CUSTOMER_SALES_SUMMARIES, + QUICKBOOKS_REPORT_TYPES_WITH_TIME_SUMMARIES, + QUICKBOOKS_REPORT_TYPES_WITH_VENDOR_EXPENSE_SUMMARIES, + type QuickBooksReportControl, +} from '@/tools/quickbooks/reports' +import { + parseQuickBooksInvoiceAllocations, + parseQuickBooksSalesLines, +} from '@/tools/quickbooks/sales_utils' +import type { QuickBooksReportType, QuickBooksResponse } from '@/tools/quickbooks/types' +import { parseQuickBooksAddress } from '@/tools/quickbooks/values' + +const MASTER_DATA_OPERATION = 'quickbooks_read_master_data' +const SALES_READ_OPERATION = 'quickbooks_read_sales_transactions' +const PURCHASING_READ_OPERATION = 'quickbooks_read_purchasing_transactions' +const ACCOUNTING_READ_OPERATION = 'quickbooks_read_accounting_transactions' +const REPORT_OPERATION = 'quickbooks_run_financial_report' +const EMAIL_TRANSACTION_OPERATION = 'quickbooks_email_transaction' +const DOWNLOAD_TRANSACTION_PDF_OPERATION = 'quickbooks_download_transaction_pdf' +const READ_ATTACHMENTS_OPERATION = 'quickbooks_read_attachments' +const ADD_ATTACHMENT_OPERATION = 'quickbooks_add_attachment' +const DOWNLOAD_ATTACHMENT_OPERATION = 'quickbooks_download_attachment' +const CUSTOMER_OPERATIONS = ['quickbooks_create_customer', 'quickbooks_update_customer'] as const +const EMPLOYEE_OPERATIONS = ['quickbooks_create_employee', 'quickbooks_update_employee'] as const +const VENDOR_OPERATIONS = ['quickbooks_create_vendor', 'quickbooks_update_vendor'] as const +const ITEM_OPERATIONS = ['quickbooks_create_item', 'quickbooks_update_item'] as const +const MASTER_DATA_CREATE_OPERATIONS = [ + 'quickbooks_create_customer', + 'quickbooks_create_employee', + 'quickbooks_create_item', + 'quickbooks_create_vendor', +] as const +const SALES_DOCUMENT_CREATE_OPERATIONS = [ + 'quickbooks_create_estimate', + 'quickbooks_create_invoice', + 'quickbooks_create_sales_receipt', + 'quickbooks_create_credit_memo', + 'quickbooks_create_refund_receipt', +] as const +const SALES_DOCUMENT_UPDATE_OPERATIONS = [ + 'quickbooks_update_estimate', + 'quickbooks_update_invoice', + 'quickbooks_update_sales_receipt', + 'quickbooks_update_credit_memo', + 'quickbooks_update_refund_receipt', +] as const +const SALES_DOCUMENT_OPERATIONS = [ + ...SALES_DOCUMENT_CREATE_OPERATIONS, + ...SALES_DOCUMENT_UPDATE_OPERATIONS, +] as const +const PAYMENT_OPERATIONS = [ + 'quickbooks_create_customer_payment', + 'quickbooks_update_customer_payment', +] as const +const SALES_CREATE_OPERATIONS = [ + ...SALES_DOCUMENT_CREATE_OPERATIONS, + 'quickbooks_create_customer_payment', +] as const +const PURCHASING_CREATE_OPERATIONS = [ + 'quickbooks_create_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_create_bill_payment', + 'quickbooks_create_vendor_credit', + 'quickbooks_create_purchase', +] as const +const ACCOUNTING_CREATE_OPERATIONS = [ + 'quickbooks_create_journal_entry', + 'quickbooks_create_deposit', +] as const +const CREATE_OPERATIONS = [ + ...MASTER_DATA_CREATE_OPERATIONS, + ...SALES_CREATE_OPERATIONS, + ...PURCHASING_CREATE_OPERATIONS, + ...ACCOUNTING_CREATE_OPERATIONS, +] as const +const SALES_UPDATE_OPERATIONS = [ + ...SALES_DOCUMENT_UPDATE_OPERATIONS, + 'quickbooks_update_customer_payment', +] as const +const SALES_VOID_OPERATIONS = [ + 'quickbooks_void_invoice', + 'quickbooks_void_customer_payment', +] as const +const MASTER_DATA_UPDATE_OPERATIONS = [ + 'quickbooks_update_customer', + 'quickbooks_update_employee', + 'quickbooks_update_item', + 'quickbooks_update_vendor', +] as const +const PURCHASING_UPDATE_OPERATIONS = [ + 'quickbooks_update_purchase_order', + 'quickbooks_update_bill', + 'quickbooks_update_bill_payment', + 'quickbooks_update_vendor_credit', + 'quickbooks_update_purchase', +] as const +const ACCOUNTING_UPDATE_OPERATIONS = [ + 'quickbooks_update_journal_entry', + 'quickbooks_update_deposit', +] as const +const SALES_MUTATION_OPERATIONS = [ + ...SALES_CREATE_OPERATIONS, + ...SALES_UPDATE_OPERATIONS, + ...SALES_VOID_OPERATIONS, +] as const +const PURCHASING_MUTATION_OPERATIONS = [ + ...PURCHASING_CREATE_OPERATIONS, + ...PURCHASING_UPDATE_OPERATIONS, +] as const +const ACCOUNTING_MUTATION_OPERATIONS = [ + ...ACCOUNTING_CREATE_OPERATIONS, + ...ACCOUNTING_UPDATE_OPERATIONS, +] as const +const UPDATE_OPERATIONS = [ + ...MASTER_DATA_UPDATE_OPERATIONS, + ...SALES_UPDATE_OPERATIONS, + ...SALES_VOID_OPERATIONS, + ...PURCHASING_UPDATE_OPERATIONS, + ...ACCOUNTING_UPDATE_OPERATIONS, +] as const +const MUTATION_OPERATIONS = [ + ...CUSTOMER_OPERATIONS, + ...EMPLOYEE_OPERATIONS, + ...ITEM_OPERATIONS, + ...VENDOR_OPERATIONS, + ...SALES_MUTATION_OPERATIONS, + ...PURCHASING_MUTATION_OPERATIONS, + ...ACCOUNTING_MUTATION_OPERATIONS, +] as const +const PAGINATED_OPERATIONS = [ + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + READ_ATTACHMENTS_OPERATION, +] as const +const LIST_OUTPUT_CONDITION: OutputCondition = { + field: 'operation', + value: [ + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + READ_ATTACHMENTS_OPERATION, + ], + and: { field: 'readMode', value: 'list' }, +} +const QUICKBOOKS_OPERATIONS = [ + 'quickbooks_get_company_info', + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + REPORT_OPERATION, + EMAIL_TRANSACTION_OPERATION, + DOWNLOAD_TRANSACTION_PDF_OPERATION, + READ_ATTACHMENTS_OPERATION, + ADD_ATTACHMENT_OPERATION, + DOWNLOAD_ATTACHMENT_OPERATION, + ...MUTATION_OPERATIONS, +] as const + +const REPORT_TIME_SUMMARY_OPTIONS = [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Total', id: 'total' }, + { label: 'Day', id: 'day' }, + { label: 'Week', id: 'week' }, + { label: 'Month', id: 'month' }, + { label: 'Quarter', id: 'quarter' }, + { label: 'Year', id: 'year' }, +] as const + +/** + * Wand config for a QuickBooks `YYYY-MM-DD` date field. `subject` names the + * specific date so the generated value lands in the right field. + */ +function dateWandConfig(subject: string) { + return { + enabled: true, + prompt: `Generate the ${subject} in YYYY-MM-DD format from the user description. Return ONLY the date - no explanations, no extra text.`, + generationType: 'timestamp' as const, + placeholder: 'Describe the date (e.g., "the last day of last month")...', + } +} + +function reportControlCondition(control: QuickBooksReportControl) { + return { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: getQuickBooksReportTypesSupporting(control) }, + } +} + +function reportSupports(reportType: unknown, control: QuickBooksReportControl): boolean { + return getQuickBooksReportTypesSupporting(control).includes(reportType as QuickBooksReportType) +} + +function reportSummarizeValue(params: Record, reportType: unknown): unknown { + if ( + QUICKBOOKS_REPORT_TYPES_WITH_ALL_SUMMARIES.includes( + reportType as (typeof QUICKBOOKS_REPORT_TYPES_WITH_ALL_SUMMARIES)[number] + ) + ) { + return params.reportSummarizeBy ?? 'default' + } + if ( + QUICKBOOKS_REPORT_TYPES_WITH_CUSTOMER_SALES_SUMMARIES.includes( + reportType as (typeof QUICKBOOKS_REPORT_TYPES_WITH_CUSTOMER_SALES_SUMMARIES)[number] + ) + ) { + return params.reportCustomerSalesSummarizeBy ?? 'default' + } + if ( + QUICKBOOKS_REPORT_TYPES_WITH_VENDOR_EXPENSE_SUMMARIES.includes( + reportType as (typeof QUICKBOOKS_REPORT_TYPES_WITH_VENDOR_EXPENSE_SUMMARIES)[number] + ) + ) { + return params.reportVendorExpenseSummarizeBy ?? 'default' + } + if ( + QUICKBOOKS_REPORT_TYPES_WITH_TIME_SUMMARIES.includes( + reportType as (typeof QUICKBOOKS_REPORT_TYPES_WITH_TIME_SUMMARIES)[number] + ) + ) { + return params.reportTimeSummarizeBy ?? 'default' + } + return undefined +} + +function parseOptionalPositiveInteger(value: unknown, fieldName: string): number | undefined { + if (value == null || (typeof value === 'string' && value.trim() === '')) return undefined + const parsed = typeof value === 'number' ? value : Number(value) + if (!Number.isInteger(parsed) || parsed < 1) { + throw new Error(`${fieldName} must be a positive integer`) + } + return parsed +} + +function parsePaginationInteger( + value: unknown, + fieldName: 'startPosition' | 'maxResults', + fallback: number +): number { + if (value == null || (typeof value === 'string' && value.trim() === '')) return fallback + const parsed = typeof value === 'number' ? value : Number(value) + if (!Number.isInteger(parsed)) throw new Error(`${fieldName} must be an integer`) + if (fieldName === 'startPosition' && parsed < 1) { + throw new Error('startPosition must be a positive integer') + } + if (fieldName === 'maxResults' && (parsed < 1 || parsed > 100)) { + throw new Error('maxResults must be an integer from 1 through 100') + } + return parsed +} + +function parseOptionalNumber(value: unknown, fieldName: string): number | undefined { + if (value == null || (typeof value === 'string' && value.trim() === '')) return undefined + const parsed = typeof value === 'number' ? value : Number(value) + if (!Number.isFinite(parsed)) throw new Error(`${fieldName} must be a finite number`) + return parsed +} + +function parseTriStateBoolean(value: unknown, fieldName: string): boolean | undefined { + if (value == null || value === '' || value === 'not_specified') return undefined + if (value === true || value === 'yes') return true + if (value === false || value === 'no') return false + throw new Error(`${fieldName} must be not specified, yes, or no`) +} + +function optionalValue(value: unknown): unknown { + if (value == null) return undefined + return typeof value === 'string' && value.trim() === '' ? undefined : value +} + +function paginationCondition(values?: Record) { + if (!values) { + return { field: 'operation', value: [...PAGINATED_OPERATIONS] } + } + if (values?.operation === MASTER_DATA_OPERATION) { + return { field: 'readMode', value: 'list' } + } + if (values?.operation === SALES_READ_OPERATION) { + return { field: 'readMode', value: 'list' } + } + if (values?.operation === PURCHASING_READ_OPERATION) { + return { field: 'readMode', value: 'list' } + } + if (values?.operation === ACCOUNTING_READ_OPERATION) { + return { field: 'readMode', value: 'list' } + } + if (values?.operation === READ_ATTACHMENTS_OPERATION) { + return { field: 'readMode', value: 'list' } + } + return { field: 'operation', value: [] } +} + +function salesTransactionIdCondition(values?: Record) { + if (!values) { + return { + field: 'operation', + value: [ + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + ...SALES_UPDATE_OPERATIONS, + ...SALES_VOID_OPERATIONS, + ...PURCHASING_UPDATE_OPERATIONS, + ...ACCOUNTING_UPDATE_OPERATIONS, + ], + } + } + if ( + values?.operation === SALES_READ_OPERATION || + values?.operation === PURCHASING_READ_OPERATION || + values?.operation === ACCOUNTING_READ_OPERATION + ) { + return { field: 'readMode', value: 'by_id' } + } + return { + field: 'operation', + value: [ + ...SALES_UPDATE_OPERATIONS, + ...SALES_VOID_OPERATIONS, + ...PURCHASING_UPDATE_OPERATIONS, + ...ACCOUNTING_UPDATE_OPERATIONS, + ], + } +} + +function parseConfirmation(value: unknown, fieldName: string): boolean { + if (value === true || value === 'yes') return true + if (value === false || value === 'no' || value == null || value === '') return false + throw new Error(`${fieldName} must be yes or no`) +} + +function attachmentTargetCondition(values?: Record) { + if (!values) { + return { field: 'operation', value: [READ_ATTACHMENTS_OPERATION, ADD_ATTACHMENT_OPERATION] } + } + if (values.operation === READ_ATTACHMENTS_OPERATION) { + return { field: 'readMode', value: 'list' } + } + return { field: 'operation', value: ADD_ATTACHMENT_OPERATION } +} + +function attachmentIdCondition(values?: Record) { + if (!values) { + return { + field: 'operation', + value: [READ_ATTACHMENTS_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + } + } + if (values.operation === READ_ATTACHMENTS_OPERATION) { + return { field: 'readMode', value: 'by_id' } + } + return { field: 'operation', value: DOWNLOAD_ATTACHMENT_OPERATION } +} + +export const QuickBooksBlock: BlockConfig = { + type: 'quickbooks', + name: 'QuickBooks', + description: + 'Manage QuickBooks Online company, transactions, reports, emails, PDFs, and attachments', + authMode: AuthMode.OAuth, + longDescription: + 'Connect one QuickBooks Online company to manage bounded master-data, sales, purchasing, receivables, payables, accounting, reports, transaction delivery, and document workflows.', + docsLink: 'https://docs.sim.ai/integrations/quickbooks', + category: 'tools', + integrationType: IntegrationType.Commerce, + bgColor: '#2CA01C', + icon: QuickBooksIcon, + subBlocks: [ + { + id: 'operation', + title: 'Operation', + type: 'dropdown', + options: [ + { label: 'Get Company Info', id: 'quickbooks_get_company_info' }, + { label: 'Read Master Data', id: 'quickbooks_read_master_data' }, + { label: 'Create Customer', id: 'quickbooks_create_customer' }, + { label: 'Update Customer', id: 'quickbooks_update_customer' }, + { label: 'Create Employee', id: 'quickbooks_create_employee' }, + { label: 'Update Employee', id: 'quickbooks_update_employee' }, + { label: 'Create Vendor', id: 'quickbooks_create_vendor' }, + { label: 'Update Vendor', id: 'quickbooks_update_vendor' }, + { label: 'Create Item', id: 'quickbooks_create_item' }, + { label: 'Update Item', id: 'quickbooks_update_item' }, + { label: 'Read Sales Transactions', id: 'quickbooks_read_sales_transactions' }, + { label: 'Create Estimate', id: 'quickbooks_create_estimate' }, + { label: 'Update Estimate', id: 'quickbooks_update_estimate' }, + { label: 'Create Invoice', id: 'quickbooks_create_invoice' }, + { label: 'Update Invoice', id: 'quickbooks_update_invoice' }, + { label: 'Void Invoice', id: 'quickbooks_void_invoice' }, + { label: 'Create Sales Receipt', id: 'quickbooks_create_sales_receipt' }, + { label: 'Update Sales Receipt', id: 'quickbooks_update_sales_receipt' }, + { label: 'Create Customer Payment', id: 'quickbooks_create_customer_payment' }, + { label: 'Update Customer Payment', id: 'quickbooks_update_customer_payment' }, + { label: 'Void Customer Payment', id: 'quickbooks_void_customer_payment' }, + { label: 'Create Credit Memo', id: 'quickbooks_create_credit_memo' }, + { label: 'Update Credit Memo', id: 'quickbooks_update_credit_memo' }, + { label: 'Create Refund Receipt', id: 'quickbooks_create_refund_receipt' }, + { label: 'Update Refund Receipt', id: 'quickbooks_update_refund_receipt' }, + { + label: 'Read Purchasing Transactions', + id: 'quickbooks_read_purchasing_transactions', + }, + { label: 'Create Purchase Order', id: 'quickbooks_create_purchase_order' }, + { label: 'Update Purchase Order', id: 'quickbooks_update_purchase_order' }, + { label: 'Create Bill', id: 'quickbooks_create_bill' }, + { label: 'Update Bill', id: 'quickbooks_update_bill' }, + { label: 'Create Bill Payment', id: 'quickbooks_create_bill_payment' }, + { label: 'Update Bill Payment', id: 'quickbooks_update_bill_payment' }, + { label: 'Create Vendor Credit', id: 'quickbooks_create_vendor_credit' }, + { label: 'Update Vendor Credit', id: 'quickbooks_update_vendor_credit' }, + { label: 'Create Purchase or Expense', id: 'quickbooks_create_purchase' }, + { label: 'Update Purchase or Expense', id: 'quickbooks_update_purchase' }, + { + label: 'Read Accounting Transactions', + id: 'quickbooks_read_accounting_transactions', + }, + { label: 'Create Journal Entry', id: 'quickbooks_create_journal_entry' }, + { label: 'Update Journal Entry', id: 'quickbooks_update_journal_entry' }, + { label: 'Create Deposit', id: 'quickbooks_create_deposit' }, + { label: 'Update Deposit', id: 'quickbooks_update_deposit' }, + { label: 'Run Financial Report', id: 'quickbooks_run_financial_report' }, + { label: 'Email Transaction', id: 'quickbooks_email_transaction' }, + { label: 'Download Transaction PDF', id: 'quickbooks_download_transaction_pdf' }, + { label: 'Read Attachments', id: 'quickbooks_read_attachments' }, + { label: 'Add Attachment', id: 'quickbooks_add_attachment' }, + { label: 'Download Attachment', id: 'quickbooks_download_attachment' }, + ], + value: () => 'quickbooks_get_company_info', + }, + { + id: 'credential', + title: 'QuickBooks Account', + type: 'oauth-input', + canonicalParamId: 'oauthCredential', + mode: 'basic', + serviceId: 'quickbooks', + requiredScopes: getScopesForService('quickbooks'), + placeholder: 'Select QuickBooks company', + required: true, + }, + { + id: 'manualCredential', + title: 'QuickBooks Account', + type: 'short-input', + canonicalParamId: 'oauthCredential', + mode: 'advanced', + placeholder: 'Enter credential ID', + required: true, + }, + { + id: 'documentTransactionType', + title: 'Transaction Type', + type: 'dropdown', + options: [ + { label: 'Invoice', id: 'invoice' }, + { label: 'Customer Payment', id: 'payment' }, + { label: 'Estimate', id: 'estimate' }, + { label: 'Sales Receipt', id: 'sales_receipt' }, + { label: 'Credit Memo', id: 'credit_memo' }, + { label: 'Refund Receipt', id: 'refund_receipt' }, + { label: 'Purchase Order', id: 'purchase_order' }, + ], + condition: { + field: 'operation', + value: [EMAIL_TRANSACTION_OPERATION, DOWNLOAD_TRANSACTION_PDF_OPERATION], + }, + required: { + field: 'operation', + value: [EMAIL_TRANSACTION_OPERATION, DOWNLOAD_TRANSACTION_PDF_OPERATION], + }, + value: () => 'invoice', + }, + { + id: 'documentTransactionId', + title: 'Transaction ID', + type: 'short-input', + placeholder: 'QuickBooks transaction ID', + condition: { + field: 'operation', + value: [EMAIL_TRANSACTION_OPERATION, DOWNLOAD_TRANSACTION_PDF_OPERATION], + }, + required: { + field: 'operation', + value: [EMAIL_TRANSACTION_OPERATION, DOWNLOAD_TRANSACTION_PDF_OPERATION], + }, + }, + { + id: 'confirmSend', + title: 'Confirm Send', + type: 'dropdown', + options: [ + { label: 'No', id: 'no' }, + { label: 'Yes', id: 'yes' }, + ], + condition: { field: 'operation', value: EMAIL_TRANSACTION_OPERATION }, + required: { field: 'operation', value: EMAIL_TRANSACTION_OPERATION }, + value: () => 'no', + }, + { + id: 'recipientOverride', + title: 'Recipient', + type: 'short-input', + placeholder: 'Required for Customer Payments; otherwise optional', + condition: { field: 'operation', value: EMAIL_TRANSACTION_OPERATION }, + required: { + field: 'operation', + value: EMAIL_TRANSACTION_OPERATION, + and: { field: 'documentTransactionType', value: 'payment' }, + }, + description: + 'Required for Customer Payments. For other transactions, leave blank to use the email stored in QuickBooks or provide one override address.', + }, + { + id: 'documentFileName', + title: 'File Name', + type: 'short-input', + placeholder: 'Optional PDF filename', + condition: { field: 'operation', value: DOWNLOAD_TRANSACTION_PDF_OPERATION }, + mode: 'advanced', + }, + { + id: 'attachmentTargetType', + title: 'Target Type', + type: 'dropdown', + options: [ + { label: 'Bill', id: 'bill' }, + { label: 'Bill Payment', id: 'bill_payment' }, + { label: 'Credit Memo', id: 'credit_memo' }, + { label: 'Deposit', id: 'deposit' }, + { label: 'Estimate', id: 'estimate' }, + { label: 'Invoice', id: 'invoice' }, + { label: 'Item', id: 'item' }, + { label: 'Journal Entry', id: 'journal_entry' }, + { label: 'Customer Payment', id: 'payment' }, + { label: 'Purchase or Expense', id: 'purchase' }, + { label: 'Purchase Order', id: 'purchase_order' }, + { label: 'Refund Receipt', id: 'refund_receipt' }, + { label: 'Sales Receipt', id: 'sales_receipt' }, + { label: 'Vendor Credit', id: 'vendor_credit' }, + ], + condition: attachmentTargetCondition, + required: attachmentTargetCondition, + value: () => 'invoice', + }, + { + id: 'attachmentTargetId', + title: 'Target ID', + type: 'short-input', + placeholder: 'QuickBooks target entity ID', + condition: attachmentTargetCondition, + required: attachmentTargetCondition, + }, + { + id: 'attachmentId', + title: 'Attachment ID', + type: 'short-input', + placeholder: 'QuickBooks attachment ID', + condition: attachmentIdCondition, + required: attachmentIdCondition, + }, + { + id: 'attachmentKind', + title: 'Attachment Kind', + type: 'dropdown', + options: [ + { label: 'File', id: 'file' }, + { label: 'Note', id: 'note' }, + ], + condition: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + required: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + value: () => 'file', + }, + { + id: 'attachmentFileUpload', + title: 'File', + type: 'file-upload', + canonicalParamId: 'attachmentFile', + placeholder: 'Upload one supported file', + condition: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + required: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + mode: 'basic', + multiple: false, + }, + { + id: 'attachmentFileReference', + title: 'File', + type: 'short-input', + canonicalParamId: 'attachmentFile', + placeholder: 'Reference one file from a previous block', + condition: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + required: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + mode: 'advanced', + }, + { + id: 'attachmentNote', + title: 'Note', + type: 'long-input', + placeholder: 'Note to attach in QuickBooks', + condition: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'note' }, + }, + required: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'note' }, + }, + }, + { + id: 'attachmentFileName', + title: 'File Name', + type: 'short-input', + placeholder: 'Optional safe filename override', + condition: { + field: 'operation', + value: [ADD_ATTACHMENT_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + mode: 'advanced', + }, + { + id: 'attachmentContentType', + title: 'Content Type', + type: 'short-input', + placeholder: 'Optional compatible MIME type', + condition: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + mode: 'advanced', + }, + { + id: 'attachmentDescription', + title: 'Description', + type: 'long-input', + placeholder: 'Optional file attachment description', + condition: { + field: 'operation', + value: ADD_ATTACHMENT_OPERATION, + and: { field: 'attachmentKind', value: 'file' }, + }, + mode: 'advanced', + }, + { + id: 'recordType', + title: 'Record Type', + type: 'dropdown', + options: [ + { label: 'Account', id: 'account' }, + { label: 'Class', id: 'class' }, + { label: 'Customer', id: 'customer' }, + { label: 'Department', id: 'department' }, + { label: 'Vendor', id: 'vendor' }, + { label: 'Item', id: 'item' }, + { label: 'Employee', id: 'employee' }, + ], + condition: { field: 'operation', value: MASTER_DATA_OPERATION }, + required: { field: 'operation', value: MASTER_DATA_OPERATION }, + value: () => 'account', + }, + { + id: 'readMode', + title: 'Read Mode', + type: 'dropdown', + options: [ + { label: 'List', id: 'list' }, + { label: 'By ID', id: 'by_id' }, + ], + condition: { + field: 'operation', + value: [ + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + READ_ATTACHMENTS_OPERATION, + ], + }, + required: { + field: 'operation', + value: [ + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + READ_ATTACHMENTS_OPERATION, + ], + }, + value: () => 'list', + }, + { + id: 'recordId', + title: 'Record ID', + type: 'short-input', + placeholder: 'QuickBooks record ID', + condition: { + field: 'operation', + value: MASTER_DATA_OPERATION, + and: { field: 'readMode', value: 'by_id' }, + }, + required: { + field: 'operation', + value: MASTER_DATA_OPERATION, + and: { field: 'readMode', value: 'by_id' }, + }, + }, + { + id: 'readActiveStatus', + title: 'Active Status', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Active', id: 'active' }, + { label: 'Inactive', id: 'inactive' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: MASTER_DATA_OPERATION, + and: { field: 'readMode', value: 'list' }, + }, + value: () => 'default', + }, + { + id: 'readStartDate', + title: 'Start Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + mode: 'advanced', + wandConfig: dateWandConfig('transaction list start date'), + condition: { + field: 'operation', + value: [SALES_READ_OPERATION, PURCHASING_READ_OPERATION, ACCOUNTING_READ_OPERATION], + and: { field: 'readMode', value: 'list' }, + }, + }, + { + id: 'readEndDate', + title: 'End Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + mode: 'advanced', + wandConfig: dateWandConfig('transaction list end date'), + condition: { + field: 'operation', + value: [SALES_READ_OPERATION, PURCHASING_READ_OPERATION, ACCOUNTING_READ_OPERATION], + and: { field: 'readMode', value: 'list' }, + }, + }, + { + id: 'readCustomerId', + title: 'Customer ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a customer ID', + mode: 'advanced', + condition: { + field: 'operation', + value: SALES_READ_OPERATION, + and: { field: 'readMode', value: 'list' }, + }, + }, + { + id: 'readVendorId', + title: 'Vendor ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a vendor ID', + description: + 'Supported for purchase orders, bills, bill payments, and vendor credits. Purchase/Expense filtering is not exposed because its reference contract differs.', + mode: 'advanced', + condition: (values) => ({ + field: 'operation', + value: PURCHASING_READ_OPERATION, + and: + values?.purchasingTransactionType === 'purchase' + ? { field: 'purchasingTransactionType', value: 'purchase', not: true } + : { field: 'readMode', value: 'list' }, + }), + }, + { + id: 'transactionType', + title: 'Transaction Type', + type: 'dropdown', + options: [ + { label: 'Estimate', id: 'estimate' }, + { label: 'Invoice', id: 'invoice' }, + { label: 'Sales Receipt', id: 'sales_receipt' }, + { label: 'Customer Payment', id: 'payment' }, + { label: 'Credit Memo', id: 'credit_memo' }, + { label: 'Refund Receipt', id: 'refund_receipt' }, + ], + condition: { field: 'operation', value: SALES_READ_OPERATION }, + required: { field: 'operation', value: SALES_READ_OPERATION }, + value: () => 'invoice', + }, + { + id: 'purchasingTransactionType', + title: 'Transaction Type', + type: 'dropdown', + options: [ + { label: 'Purchase Order', id: 'purchase_order' }, + { label: 'Bill', id: 'bill' }, + { label: 'Bill Payment', id: 'bill_payment' }, + { label: 'Vendor Credit', id: 'vendor_credit' }, + { label: 'Purchase/Expense', id: 'purchase' }, + ], + condition: { field: 'operation', value: PURCHASING_READ_OPERATION }, + required: { field: 'operation', value: PURCHASING_READ_OPERATION }, + value: () => 'bill', + }, + { + id: 'accountingTransactionType', + title: 'Transaction Type', + type: 'dropdown', + options: [ + { label: 'Journal Entry', id: 'journal_entry' }, + { label: 'Deposit', id: 'deposit' }, + { label: 'Transfer', id: 'transfer' }, + ], + condition: { field: 'operation', value: ACCOUNTING_READ_OPERATION }, + required: { field: 'operation', value: ACCOUNTING_READ_OPERATION }, + value: () => 'journal_entry', + }, + { + id: 'transactionId', + title: 'Transaction ID', + type: 'short-input', + placeholder: 'QuickBooks transaction ID', + condition: salesTransactionIdCondition, + required: salesTransactionIdCondition, + }, + { + id: 'reportType', + title: 'Report Type', + type: 'dropdown', + options: [ + { label: 'Balance Sheet', id: 'balance_sheet' }, + { label: 'Profit and Loss', id: 'profit_and_loss' }, + { label: 'Profit and Loss Detail', id: 'profit_and_loss_detail' }, + { label: 'Trial Balance', id: 'trial_balance' }, + { label: 'Statement of Cash Flows', id: 'cash_flow' }, + { label: 'A/P Aging Summary', id: 'ap_aging_summary' }, + { label: 'A/P Aging Detail', id: 'ap_aging_detail' }, + { label: 'A/R Aging Summary', id: 'ar_aging_summary' }, + { label: 'A/R Aging Detail', id: 'ar_aging_detail' }, + { label: 'Vendor Balance Summary', id: 'vendor_balance' }, + { label: 'Customer Balance Summary', id: 'customer_balance' }, + { label: 'Sales by Customer Summary', id: 'sales_by_customer' }, + { label: 'Sales by Product/Service Summary', id: 'sales_by_item' }, + { label: 'Expenses by Vendor', id: 'expenses_by_vendor' }, + { label: 'Transaction List', id: 'transaction_list' }, + ], + condition: { field: 'operation', value: REPORT_OPERATION }, + required: { field: 'operation', value: REPORT_OPERATION }, + value: () => 'profit_and_loss', + }, + { + id: 'reportStartDate', + title: 'Start Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + description: + 'Intuit recommends report periods of six months or less for performance, but longer periods remain supported.', + mode: 'advanced', + wandConfig: dateWandConfig('report start date'), + condition: reportControlCondition('startDate'), + }, + { + id: 'reportEndDate', + title: 'End or Report Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + description: 'End date for range reports or as-of date for balance and aging reports.', + mode: 'advanced', + wandConfig: dateWandConfig('report end or as-of date'), + condition: reportControlCondition('endDate'), + }, + { + id: 'reportAccountingMethod', + title: 'Accounting Method', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Cash', id: 'cash' }, + { label: 'Accrual', id: 'accrual' }, + ], + mode: 'advanced', + condition: reportControlCondition('accountingMethod'), + value: () => 'default', + }, + { + id: 'reportSummarizeBy', + title: 'Summarize Columns By', + type: 'dropdown', + options: [ + ...REPORT_TIME_SUMMARY_OPTIONS, + { label: 'Customer', id: 'customer' }, + { label: 'Vendor', id: 'vendor' }, + { label: 'Product/Service', id: 'item' }, + { label: 'Class', id: 'class' }, + { label: 'Department', id: 'department' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: [...QUICKBOOKS_REPORT_TYPES_WITH_ALL_SUMMARIES] }, + }, + value: () => 'default', + }, + { + id: 'reportCustomerSalesSummarizeBy', + title: 'Summarize Columns By', + type: 'dropdown', + options: [ + ...REPORT_TIME_SUMMARY_OPTIONS, + { label: 'Customer', id: 'customer' }, + { label: 'Product/Service', id: 'item' }, + { label: 'Class', id: 'class' }, + { label: 'Department', id: 'department' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { + field: 'reportType', + value: [...QUICKBOOKS_REPORT_TYPES_WITH_CUSTOMER_SALES_SUMMARIES], + }, + }, + value: () => 'default', + }, + { + id: 'reportVendorExpenseSummarizeBy', + title: 'Summarize Columns By', + type: 'dropdown', + options: [ + ...REPORT_TIME_SUMMARY_OPTIONS, + { label: 'Customer', id: 'customer' }, + { label: 'Vendor', id: 'vendor' }, + { label: 'Class', id: 'class' }, + { label: 'Department', id: 'department' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { + field: 'reportType', + value: [...QUICKBOOKS_REPORT_TYPES_WITH_VENDOR_EXPENSE_SUMMARIES], + }, + }, + value: () => 'default', + }, + { + id: 'reportTimeSummarizeBy', + title: 'Summarize Columns By', + type: 'dropdown', + options: [...REPORT_TIME_SUMMARY_OPTIONS], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: [...QUICKBOOKS_REPORT_TYPES_WITH_TIME_SUMMARIES] }, + }, + value: () => 'default', + }, + { + id: 'reportCustomerId', + title: 'Customer ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a customer ID', + mode: 'advanced', + condition: reportControlCondition('customerId'), + }, + { + id: 'reportVendorId', + title: 'Vendor ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a vendor ID', + mode: 'advanced', + condition: reportControlCondition('vendorId'), + }, + { + id: 'reportAccountId', + title: 'Account ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find an account ID', + mode: 'advanced', + condition: reportControlCondition('accountId'), + }, + { + id: 'reportItemId', + title: 'Product/Service ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find an item ID', + mode: 'advanced', + condition: reportControlCondition('itemId'), + }, + { + id: 'reportClassId', + title: 'Class ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a class ID', + mode: 'advanced', + condition: reportControlCondition('classId'), + }, + { + id: 'reportDepartmentId', + title: 'Department ID', + type: 'short-input', + placeholder: 'Use Read Master Data to find a department ID', + mode: 'advanced', + condition: reportControlCondition('departmentId'), + }, + { + id: 'reportAgingMethod', + title: 'Aging Method', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Report Date', id: 'report_date' }, + { label: 'Current Date', id: 'current' }, + ], + mode: 'advanced', + condition: reportControlCondition('agingMethod'), + value: () => 'default', + }, + { + id: 'reportAgingDays', + title: 'Days per Aging Period', + type: 'short-input', + placeholder: '30', + mode: 'advanced', + condition: reportControlCondition('agingPeriod'), + }, + { + id: 'reportTransactionType', + title: 'Transaction Type', + type: 'dropdown', + options: [ + { label: 'All', id: 'default' }, + { label: 'Bill', id: 'bill' }, + { label: 'Bill Payment (Check)', id: 'bill_payment_check' }, + { label: 'Bill Payment (Credit Card)', id: 'bill_payment_credit_card' }, + { label: 'Cash Purchase', id: 'cash_purchase' }, + { label: 'Check', id: 'check' }, + { label: 'Credit Card Charge', id: 'credit_card_charge' }, + { label: 'Credit Card Credit', id: 'credit_card_credit' }, + { label: 'Credit Memo', id: 'credit_memo' }, + { label: 'Deposit', id: 'deposit' }, + { label: 'Estimate', id: 'estimate' }, + { label: 'Invoice', id: 'invoice' }, + { label: 'Journal Entry', id: 'journal_entry' }, + { label: 'Customer Payment', id: 'payment' }, + { label: 'Purchase Order', id: 'purchase_order' }, + { label: 'Sales Receipt', id: 'sales_receipt' }, + { label: 'Transfer', id: 'transfer' }, + { label: 'Vendor Credit', id: 'vendor_credit' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'reportGroupBy', + title: 'Group By', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Account', id: 'account' }, + { label: 'Customer', id: 'customer' }, + { label: 'Day', id: 'day' }, + { label: 'Department', id: 'department' }, + { label: 'Employee', id: 'employee' }, + { label: 'Month', id: 'month' }, + { label: 'Name', id: 'name' }, + { label: 'None', id: 'none' }, + { label: 'Payment Method', id: 'payment_method' }, + { label: 'Quarter', id: 'quarter' }, + { label: 'Transaction Type', id: 'transaction_type' }, + { label: 'Vendor', id: 'vendor' }, + { label: 'Week', id: 'week' }, + { label: 'Year', id: 'year' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'reportAccountsPayablePaid', + title: 'A/P Paid Status', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'All', id: 'all' }, + { label: 'Paid', id: 'paid' }, + { label: 'Unpaid', id: 'unpaid' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'reportAccountsReceivablePaid', + title: 'A/R Paid Status', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'All', id: 'all' }, + { label: 'Paid', id: 'paid' }, + { label: 'Unpaid', id: 'unpaid' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'reportClearedStatus', + title: 'Cleared Status', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Cleared', id: 'cleared' }, + { label: 'Uncleared', id: 'uncleared' }, + { label: 'Reconciled', id: 'reconciled' }, + { label: 'Deposited', id: 'deposited' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'reportDocumentNumber', + title: 'Document Number', + type: 'short-input', + placeholder: 'Exact QuickBooks document number', + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + }, + { + id: 'reportSourceAccountType', + title: 'Source Account Type', + type: 'dropdown', + options: [ + { label: 'QuickBooks Default', id: 'default' }, + { label: 'Accounts Payable', id: 'accounts_payable' }, + { label: 'Accounts Receivable', id: 'accounts_receivable' }, + { label: 'Bank', id: 'bank' }, + { label: 'Cost of Goods Sold', id: 'cost_of_goods_sold' }, + { label: 'Credit Card', id: 'credit_card' }, + { label: 'Equity', id: 'equity' }, + { label: 'Expense', id: 'expense' }, + { label: 'Fixed Asset', id: 'fixed_asset' }, + { label: 'Income', id: 'income' }, + { label: 'Long-term Liability', id: 'long_term_liability' }, + { label: 'Non-posting', id: 'non_posting' }, + { label: 'Other Asset', id: 'other_asset' }, + { label: 'Other Current Asset', id: 'other_current_asset' }, + { label: 'Other Current Liability', id: 'other_current_liability' }, + { label: 'Other Expense', id: 'other_expense' }, + { label: 'Other Income', id: 'other_income' }, + ], + mode: 'advanced', + condition: { + field: 'operation', + value: REPORT_OPERATION, + and: { field: 'reportType', value: 'transaction_list' }, + }, + value: () => 'default', + }, + { + id: 'startPosition', + title: 'Start Position', + type: 'short-input', + placeholder: '1', + mode: 'advanced', + condition: paginationCondition, + value: () => '1', + }, + { + id: 'maxResults', + title: 'Max Results', + type: 'short-input', + placeholder: '25', + mode: 'advanced', + condition: paginationCondition, + value: () => '25', + }, + { + id: 'customerId', + title: 'Customer ID', + type: 'short-input', + placeholder: 'QuickBooks customer ID', + condition: { + field: 'operation', + value: ['quickbooks_update_customer', ...SALES_DOCUMENT_OPERATIONS, ...PAYMENT_OPERATIONS], + }, + required: { + field: 'operation', + value: ['quickbooks_update_customer', ...SALES_CREATE_OPERATIONS], + }, + }, + { + id: 'vendorId', + title: 'Vendor ID', + type: 'short-input', + placeholder: 'QuickBooks vendor ID', + condition: { + field: 'operation', + value: ['quickbooks_update_vendor', ...PURCHASING_MUTATION_OPERATIONS], + }, + required: { + field: 'operation', + value: [ + 'quickbooks_update_vendor', + 'quickbooks_create_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_update_bill', + 'quickbooks_create_bill_payment', + 'quickbooks_update_bill_payment', + 'quickbooks_create_vendor_credit', + 'quickbooks_update_vendor_credit', + ], + }, + }, + { + id: 'itemId', + title: 'Item ID', + type: 'short-input', + placeholder: 'QuickBooks item ID', + condition: { field: 'operation', value: 'quickbooks_update_item' }, + required: { field: 'operation', value: 'quickbooks_update_item' }, + }, + { + id: 'employeeId', + title: 'Employee ID', + type: 'short-input', + placeholder: 'QuickBooks employee ID', + condition: { field: 'operation', value: 'quickbooks_update_employee' }, + required: { field: 'operation', value: 'quickbooks_update_employee' }, + }, + { + id: 'syncToken', + title: 'Sync Token', + type: 'short-input', + placeholder: 'Current QuickBooks sync token', + condition: { field: 'operation', value: [...UPDATE_OPERATIONS] }, + required: { field: 'operation', value: [...UPDATE_OPERATIONS] }, + }, + { + id: 'displayName', + title: 'Display Name', + type: 'short-input', + placeholder: 'Unique display name', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + required: { + field: 'operation', + value: ['quickbooks_create_customer', 'quickbooks_create_vendor'], + }, + }, + { + id: 'companyName', + title: 'Company Name', + type: 'short-input', + placeholder: 'Company name', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...VENDOR_OPERATIONS], + }, + }, + { + id: 'givenName', + title: 'Given Name', + type: 'short-input', + placeholder: 'Given name', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + }, + { + id: 'familyName', + title: 'Family Name', + type: 'short-input', + placeholder: 'Family name', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + }, + { + id: 'primaryEmail', + title: 'Primary Email', + type: 'short-input', + placeholder: 'name@example.com', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + }, + { + id: 'primaryPhone', + title: 'Primary Phone', + type: 'short-input', + placeholder: 'Phone number', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + }, + { + id: 'billingAddress', + title: 'Billing Address (JSON)', + type: 'code', + language: 'json', + placeholder: + '{"line1":"123 Main St","city":"San Francisco","countrySubDivisionCode":"CA","postalCode":"94105"}', + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...VENDOR_OPERATIONS], + }, + mode: 'advanced', + wandConfig: { + enabled: true, + prompt: + 'Generate a QuickBooks address JSON object using only line1, line2, city, countrySubDivisionCode, postalCode, and country. Return ONLY the JSON object - no explanations, no extra text.', + generationType: 'json-object', + }, + }, + { + id: 'shippingAddress', + title: 'Shipping Address (JSON)', + type: 'code', + language: 'json', + placeholder: + '{"line1":"123 Main St","city":"San Francisco","countrySubDivisionCode":"CA","postalCode":"94105"}', + condition: { field: 'operation', value: [...CUSTOMER_OPERATIONS] }, + mode: 'advanced', + wandConfig: { + enabled: true, + prompt: + 'Generate a QuickBooks address JSON object using only line1, line2, city, countrySubDivisionCode, postalCode, and country. Return ONLY the JSON object - no explanations, no extra text.', + generationType: 'json-object', + }, + }, + { + id: 'primaryAddress', + title: 'Primary Address (JSON)', + type: 'code', + language: 'json', + placeholder: + '{"line1":"123 Main St","city":"San Francisco","countrySubDivisionCode":"CA","postalCode":"94105"}', + condition: { field: 'operation', value: [...EMPLOYEE_OPERATIONS] }, + mode: 'advanced', + wandConfig: { + enabled: true, + prompt: + 'Generate a QuickBooks address JSON object using only line1, line2, city, countrySubDivisionCode, postalCode, and country. Return ONLY the JSON object - no explanations, no extra text.', + generationType: 'json-object', + }, + }, + { + id: 'printOnCheckName', + title: 'Print on Check Name', + type: 'short-input', + placeholder: 'Name printed on checks', + condition: { + field: 'operation', + value: [...EMPLOYEE_OPERATIONS, ...VENDOR_OPERATIONS], + }, + mode: 'advanced', + }, + { + id: 'billableTime', + title: 'Billable Time', + type: 'dropdown', + options: [ + { label: 'Not specified', id: 'not_specified' }, + { label: 'Yes', id: 'yes' }, + { label: 'No', id: 'no' }, + ], + condition: { field: 'operation', value: [...EMPLOYEE_OPERATIONS] }, + mode: 'advanced', + value: () => 'not_specified', + }, + { + id: 'accountNumber', + title: 'Vendor Account Number', + type: 'short-input', + placeholder: 'Account number', + condition: { field: 'operation', value: [...VENDOR_OPERATIONS] }, + mode: 'advanced', + }, + { + id: 'vendor1099', + title: '1099 Vendor', + type: 'dropdown', + options: [ + { label: 'Not specified', id: 'not_specified' }, + { label: 'Yes', id: 'yes' }, + { label: 'No', id: 'no' }, + ], + condition: { field: 'operation', value: [...VENDOR_OPERATIONS] }, + mode: 'advanced', + value: () => 'not_specified', + }, + { + id: 'name', + title: 'Item Name', + type: 'short-input', + placeholder: 'Unique item name', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + required: { field: 'operation', value: 'quickbooks_create_item' }, + }, + { + id: 'itemType', + title: 'Item Type', + type: 'dropdown', + options: [ + { label: 'Service', id: 'service' }, + { label: 'Non-inventory', id: 'non_inventory' }, + ], + condition: { field: 'operation', value: 'quickbooks_create_item' }, + required: { field: 'operation', value: 'quickbooks_create_item' }, + value: () => 'service', + }, + { + id: 'incomeAccountId', + title: 'Income Account ID', + type: 'short-input', + placeholder: 'QuickBooks income account ID', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + required: { + field: 'operation', + value: 'quickbooks_create_item', + and: { field: 'itemType', value: 'service' }, + }, + }, + { + id: 'description', + title: 'Sales Description', + type: 'long-input', + placeholder: 'Item sales description', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + }, + { + id: 'unitPrice', + title: 'Unit Price', + type: 'short-input', + placeholder: '0.00', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + }, + { + id: 'purchaseDescription', + title: 'Purchase Description', + type: 'long-input', + placeholder: 'Item purchase description', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + mode: 'advanced', + }, + { + id: 'purchaseCost', + title: 'Purchase Cost', + type: 'short-input', + placeholder: '0.00', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + mode: 'advanced', + }, + { + id: 'expenseAccountId', + title: 'Expense Account ID', + type: 'short-input', + placeholder: 'QuickBooks expense account ID', + condition: { field: 'operation', value: [...ITEM_OPERATIONS] }, + required: { field: 'operation', value: 'quickbooks_create_item' }, + }, + { + id: 'taxable', + title: 'Taxable', + type: 'dropdown', + options: [ + { label: 'Not specified', id: 'not_specified' }, + { label: 'Yes', id: 'yes' }, + { label: 'No', id: 'no' }, + ], + condition: { + field: 'operation', + value: [...CUSTOMER_OPERATIONS, ...ITEM_OPERATIONS], + }, + mode: 'advanced', + value: () => 'not_specified', + }, + { + id: 'activeStatus', + title: 'Active Status', + type: 'dropdown', + options: [ + { label: 'Unchanged', id: 'unchanged' }, + { label: 'Active', id: 'active' }, + { label: 'Inactive', id: 'inactive' }, + ], + condition: { field: 'operation', value: [...MASTER_DATA_UPDATE_OPERATIONS] }, + value: () => 'unchanged', + }, + { + id: 'lines', + title: 'Lines (JSON)', + type: 'code', + language: 'json', + placeholder: '[{"lineType":"item","amount":100,"itemId":"7","description":"Consulting"}]', + condition: { field: 'operation', value: [...SALES_DOCUMENT_OPERATIONS] }, + required: { field: 'operation', value: [...SALES_DOCUMENT_CREATE_OPERATIONS] }, + wandConfig: { + enabled: true, + prompt: + 'Generate a JSON array of QuickBooks sales lines. Use item lines with lineType, positive amount, itemId, and optional description, positive quantity, positive unitPrice, and serviceDate. When quantity and unitPrice are both present, amount must equal quantity multiplied by unitPrice. Use description lines with lineType and description. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'purchasingLines', + title: 'Expense Lines (JSON)', + type: 'code', + language: 'json', + placeholder: '[{"lineType":"account","amount":100,"accountId":"7","description":"Supplies"}]', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_create_vendor_credit', + 'quickbooks_create_purchase', + ], + }, + required: { + field: 'operation', + value: [ + 'quickbooks_create_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_create_vendor_credit', + 'quickbooks_create_purchase', + ], + }, + wandConfig: { + enabled: true, + prompt: + 'Generate a JSON array of QuickBooks purchasing lines. Use account lines with lineType account, positive amount, accountId, and optional description; or item lines with lineType item, positive amount, itemId, and optional description, positive quantity, and positive unitPrice. When quantity and unitPrice are both present, amount must equal their product. For Create Bill only, a line may include both purchaseOrderId and purchaseOrderLineId to request an explicit Purchase Order line link; always supply both or neither. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'journalLines', + title: 'Journal Lines (JSON)', + type: 'code', + language: 'json', + placeholder: + '[{"postingType":"debit","amount":100,"accountId":"7"},{"postingType":"credit","amount":100,"accountId":"35"}]', + condition: { field: 'operation', value: 'quickbooks_create_journal_entry' }, + required: { field: 'operation', value: 'quickbooks_create_journal_entry' }, + wandConfig: { + enabled: true, + prompt: + 'Generate a balanced JSON array of QuickBooks journal lines. Each line needs postingType debit or credit, a positive amount, and accountId. Optional fields are description and an entityType/entityId pair. Debits and credits must total the same amount. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'depositLines', + title: 'Deposit Lines (JSON)', + type: 'code', + language: 'json', + placeholder: '[{"amount":100,"accountId":"7","description":"Deposit source"}]', + condition: { field: 'operation', value: 'quickbooks_create_deposit' }, + required: { field: 'operation', value: 'quickbooks_create_deposit' }, + wandConfig: { + enabled: true, + prompt: + 'Generate a JSON array of QuickBooks deposit lines. Each line needs a positive amount and accountId, with optional description. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'totalAmount', + title: 'Total Amount', + type: 'short-input', + placeholder: '100.00', + condition: { + field: 'operation', + value: [...PAYMENT_OPERATIONS, 'quickbooks_create_bill_payment'], + }, + required: { + field: 'operation', + value: ['quickbooks_create_customer_payment', 'quickbooks_create_bill_payment'], + }, + }, + { + id: 'apAccountId', + title: 'Accounts Payable Account ID', + type: 'short-input', + placeholder: 'QuickBooks A/P account ID', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_purchase_order', + 'quickbooks_update_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_update_bill', + 'quickbooks_create_vendor_credit', + 'quickbooks_update_vendor_credit', + ], + }, + required: { field: 'operation', value: 'quickbooks_create_purchase_order' }, + }, + { + id: 'billPaymentType', + title: 'Payment Type', + type: 'dropdown', + options: [ + { label: 'Check', id: 'check' }, + { label: 'Credit Card', id: 'credit_card' }, + ], + condition: { field: 'operation', value: 'quickbooks_create_bill_payment' }, + required: { field: 'operation', value: 'quickbooks_create_bill_payment' }, + value: () => 'check', + }, + { + id: 'purchasePaymentType', + title: 'Payment Type', + type: 'dropdown', + options: [ + { label: 'Cash', id: 'cash' }, + { label: 'Check', id: 'check' }, + { label: 'Credit Card', id: 'credit_card' }, + ], + condition: { field: 'operation', value: 'quickbooks_create_purchase' }, + required: { field: 'operation', value: 'quickbooks_create_purchase' }, + value: () => 'cash', + }, + { + id: 'currentPurchasePaymentType', + title: 'Current Payment Type', + type: 'dropdown', + options: [ + { label: 'Cash', id: 'cash' }, + { label: 'Check', id: 'check' }, + { label: 'Credit Card', id: 'credit_card' }, + ], + condition: { field: 'operation', value: 'quickbooks_update_purchase' }, + required: { field: 'operation', value: 'quickbooks_update_purchase' }, + }, + { + id: 'paymentAccountId', + title: 'Payment Account ID', + type: 'short-input', + placeholder: 'QuickBooks bank or credit-card account ID', + condition: { + field: 'operation', + value: ['quickbooks_create_bill_payment', 'quickbooks_create_purchase'], + }, + required: { + field: 'operation', + value: ['quickbooks_create_bill_payment', 'quickbooks_create_purchase'], + }, + }, + { + id: 'billAllocations', + title: 'Bill Allocations (JSON)', + type: 'code', + language: 'json', + placeholder: '[{"billId":"123","amount":75}]', + condition: { field: 'operation', value: 'quickbooks_create_bill_payment' }, + required: { field: 'operation', value: 'quickbooks_create_bill_payment' }, + wandConfig: { + enabled: true, + prompt: + 'Generate a JSON array of QuickBooks Bill allocations using only billId and a positive amount. Allocation amounts must total the payment amount. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'transactionDate', + title: 'Transaction Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + condition: { + field: 'operation', + value: [ + ...SALES_CREATE_OPERATIONS, + ...SALES_UPDATE_OPERATIONS, + ...PURCHASING_MUTATION_OPERATIONS, + ...ACCOUNTING_MUTATION_OPERATIONS, + ], + }, + mode: 'advanced', + wandConfig: dateWandConfig('transaction date'), + }, + { + id: 'dueDate', + title: 'Due Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_invoice', + 'quickbooks_update_invoice', + 'quickbooks_create_bill', + 'quickbooks_update_bill', + ], + }, + mode: 'advanced', + wandConfig: dateWandConfig('due date'), + }, + { + id: 'expirationDate', + title: 'Expiration Date', + type: 'short-input', + placeholder: 'YYYY-MM-DD', + condition: { + field: 'operation', + value: ['quickbooks_create_estimate', 'quickbooks_update_estimate'], + }, + mode: 'advanced', + wandConfig: dateWandConfig('estimate expiration date'), + }, + { + id: 'documentNumber', + title: 'Document Number', + type: 'short-input', + placeholder: 'Optional QuickBooks document number', + condition: { + field: 'operation', + value: [ + ...SALES_DOCUMENT_OPERATIONS, + 'quickbooks_create_purchase_order', + 'quickbooks_update_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_update_bill', + 'quickbooks_create_vendor_credit', + 'quickbooks_update_vendor_credit', + 'quickbooks_create_journal_entry', + 'quickbooks_update_journal_entry', + ], + }, + mode: 'advanced', + }, + { + id: 'privateNote', + title: 'Private Note', + type: 'long-input', + placeholder: 'Internal note', + condition: { + field: 'operation', + value: [ + ...SALES_CREATE_OPERATIONS, + ...SALES_UPDATE_OPERATIONS, + ...PURCHASING_MUTATION_OPERATIONS, + ...ACCOUNTING_MUTATION_OPERATIONS, + ], + }, + mode: 'advanced', + }, + { + id: 'customerMemo', + title: 'Customer Memo', + type: 'long-input', + placeholder: 'Customer-facing memo', + condition: { field: 'operation', value: [...SALES_DOCUMENT_OPERATIONS] }, + mode: 'advanced', + }, + { + id: 'paymentMethodId', + title: 'Payment Method ID', + type: 'short-input', + placeholder: 'QuickBooks payment method ID', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_sales_receipt', + 'quickbooks_update_sales_receipt', + 'quickbooks_create_refund_receipt', + 'quickbooks_update_refund_receipt', + ...PAYMENT_OPERATIONS, + ], + }, + mode: 'advanced', + }, + { + id: 'paymentReferenceNumber', + title: 'Payment Reference Number', + type: 'short-input', + placeholder: 'Check or payment reference', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_sales_receipt', + 'quickbooks_update_sales_receipt', + 'quickbooks_create_refund_receipt', + 'quickbooks_update_refund_receipt', + ...PAYMENT_OPERATIONS, + ], + }, + mode: 'advanced', + }, + { + id: 'depositAccountId', + title: 'Deposit Account ID', + type: 'short-input', + placeholder: 'QuickBooks deposit account ID', + condition: { + field: 'operation', + value: [ + 'quickbooks_create_sales_receipt', + 'quickbooks_update_sales_receipt', + 'quickbooks_create_refund_receipt', + 'quickbooks_update_refund_receipt', + ...PAYMENT_OPERATIONS, + 'quickbooks_create_deposit', + 'quickbooks_update_deposit', + ], + }, + required: { + field: 'operation', + value: [ + 'quickbooks_create_refund_receipt', + 'quickbooks_create_deposit', + 'quickbooks_update_deposit', + ], + }, + }, + { + id: 'invoiceAllocations', + title: 'Invoice Allocations (JSON)', + type: 'code', + language: 'json', + placeholder: '[{"invoiceId":"42","amount":75}]', + condition: { field: 'operation', value: [...PAYMENT_OPERATIONS] }, + mode: 'advanced', + wandConfig: { + enabled: true, + prompt: + 'Generate a JSON array of QuickBooks invoice allocations using only invoiceId and a positive amount. On an update these are merged into the allocations the payment already has, so list only the invoices whose applied amount should change; any invoice already applied and not listed keeps its current amount. Return ONLY the JSON array - no explanations, no extra text.', + }, + }, + { + id: 'unapplyOmittedInvoices', + title: 'Replace Invoice Allocations', + type: 'dropdown', + options: [ + { label: 'No', id: 'no' }, + { label: 'Yes', id: 'yes' }, + ], + description: + 'Yes removes every invoice not listed in the allocations from this payment, returning it to open.', + condition: { field: 'operation', value: 'quickbooks_update_customer_payment' }, + mode: 'advanced', + value: () => 'no', + }, + { + id: 'paymentReference', + title: 'Payment Reference', + type: 'short-input', + placeholder: 'Optional check or payment reference', + condition: { + field: 'operation', + value: ['quickbooks_create_purchase', 'quickbooks_update_purchase'], + }, + mode: 'advanced', + }, + { + id: 'requestId', + title: 'Request ID', + type: 'short-input', + placeholder: 'Optional idempotency key (max 50 characters)', + condition: { field: 'operation', value: [...CREATE_OPERATIONS] }, + mode: 'advanced', + }, + { + id: 'confirmVoid', + title: 'Confirm Void', + type: 'dropdown', + options: [ + { label: 'No', id: 'no' }, + { label: 'Yes', id: 'yes' }, + ], + condition: { field: 'operation', value: [...SALES_VOID_OPERATIONS] }, + required: { field: 'operation', value: [...SALES_VOID_OPERATIONS] }, + value: () => 'no', + }, + { + id: 'confirmPosting', + title: 'Confirm Posting', + type: 'dropdown', + options: [ + { label: 'No', id: 'no' }, + { label: 'Yes', id: 'yes' }, + ], + condition: { + field: 'operation', + value: ['quickbooks_create_journal_entry', 'quickbooks_update_journal_entry'], + }, + required: { + field: 'operation', + value: ['quickbooks_create_journal_entry', 'quickbooks_update_journal_entry'], + }, + value: () => 'no', + }, + ], + tools: { + access: [ + 'quickbooks_get_company_info', + 'quickbooks_read_master_data', + 'quickbooks_create_customer', + 'quickbooks_update_customer', + 'quickbooks_create_employee', + 'quickbooks_update_employee', + 'quickbooks_create_vendor', + 'quickbooks_update_vendor', + 'quickbooks_create_item', + 'quickbooks_update_item', + 'quickbooks_read_sales_transactions', + 'quickbooks_create_estimate', + 'quickbooks_update_estimate', + 'quickbooks_create_invoice', + 'quickbooks_update_invoice', + 'quickbooks_void_invoice', + 'quickbooks_create_sales_receipt', + 'quickbooks_update_sales_receipt', + 'quickbooks_create_customer_payment', + 'quickbooks_update_customer_payment', + 'quickbooks_void_customer_payment', + 'quickbooks_create_credit_memo', + 'quickbooks_update_credit_memo', + 'quickbooks_create_refund_receipt', + 'quickbooks_update_refund_receipt', + 'quickbooks_read_purchasing_transactions', + 'quickbooks_create_purchase_order', + 'quickbooks_update_purchase_order', + 'quickbooks_create_bill', + 'quickbooks_update_bill', + 'quickbooks_create_bill_payment', + 'quickbooks_update_bill_payment', + 'quickbooks_create_vendor_credit', + 'quickbooks_update_vendor_credit', + 'quickbooks_create_purchase', + 'quickbooks_update_purchase', + 'quickbooks_read_accounting_transactions', + 'quickbooks_create_journal_entry', + 'quickbooks_update_journal_entry', + 'quickbooks_create_deposit', + 'quickbooks_update_deposit', + 'quickbooks_run_financial_report', + 'quickbooks_email_transaction', + 'quickbooks_download_transaction_pdf', + 'quickbooks_read_attachments', + 'quickbooks_add_attachment', + 'quickbooks_download_attachment', + ], + config: { + tool: (params) => { + const operation = String(params.operation) + if (!QUICKBOOKS_OPERATIONS.includes(operation as (typeof QUICKBOOKS_OPERATIONS)[number])) { + throw new Error(`Unknown QuickBooks operation: ${operation}`) + } + return operation + }, + params: (params) => { + const operation = String(params.operation) + const oauthCredentialValue = params.oauthCredential + + if (operation === EMAIL_TRANSACTION_OPERATION) { + return { + credential: oauthCredentialValue, + transactionType: params.documentTransactionType, + transactionId: optionalValue(params.documentTransactionId), + recipient: optionalValue(params.recipientOverride), + confirmSend: parseConfirmation(params.confirmSend, 'confirmSend'), + } + } + if (operation === DOWNLOAD_TRANSACTION_PDF_OPERATION) { + return { + credential: oauthCredentialValue, + transactionType: params.documentTransactionType, + transactionId: optionalValue(params.documentTransactionId), + fileName: optionalValue(params.documentFileName), + } + } + if (operation === READ_ATTACHMENTS_OPERATION) { + if (params.readMode === 'by_id') { + return { + credential: oauthCredentialValue, + readMode: 'by_id', + attachmentId: optionalValue(params.attachmentId), + } + } + return { + credential: oauthCredentialValue, + readMode: 'list', + targetType: params.attachmentTargetType, + targetId: optionalValue(params.attachmentTargetId), + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + } + if (operation === ADD_ATTACHMENT_OPERATION) { + const attachmentKind = params.attachmentKind + return { + credential: oauthCredentialValue, + attachmentKind, + targetType: params.attachmentTargetType, + targetId: optionalValue(params.attachmentTargetId), + file: + attachmentKind === 'file' + ? normalizeFileInput(params.attachmentFile, { single: true }) + : undefined, + fileName: + attachmentKind === 'file' ? optionalValue(params.attachmentFileName) : undefined, + contentType: + attachmentKind === 'file' ? optionalValue(params.attachmentContentType) : undefined, + description: + attachmentKind === 'file' ? optionalValue(params.attachmentDescription) : undefined, + note: attachmentKind === 'note' ? optionalValue(params.attachmentNote) : undefined, + } + } + if (operation === DOWNLOAD_ATTACHMENT_OPERATION) { + return { + credential: oauthCredentialValue, + attachmentId: optionalValue(params.attachmentId), + fileName: optionalValue(params.attachmentFileName), + } + } + + if (operation === MASTER_DATA_OPERATION) { + if (params.readMode === 'by_id') { + return { + credential: oauthCredentialValue, + recordType: params.recordType, + readMode: params.readMode, + recordId: optionalValue(params.recordId), + } + } + return { + credential: oauthCredentialValue, + recordType: params.recordType, + readMode: params.readMode, + activeStatus: params.readActiveStatus ?? 'default', + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + } + if (operation === SALES_READ_OPERATION) { + if (params.readMode === 'by_id') { + return { + credential: oauthCredentialValue, + transactionType: params.transactionType, + readMode: params.readMode, + transactionId: optionalValue(params.transactionId), + } + } + return { + credential: oauthCredentialValue, + transactionType: params.transactionType, + readMode: params.readMode, + startDate: optionalValue(params.readStartDate), + endDate: optionalValue(params.readEndDate), + customerId: optionalValue(params.readCustomerId), + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + } + if (operation === PURCHASING_READ_OPERATION) { + if (params.readMode === 'by_id') { + return { + credential: oauthCredentialValue, + transactionType: params.purchasingTransactionType, + readMode: params.readMode, + transactionId: optionalValue(params.transactionId), + } + } + return { + credential: oauthCredentialValue, + transactionType: params.purchasingTransactionType, + readMode: params.readMode, + startDate: optionalValue(params.readStartDate), + endDate: optionalValue(params.readEndDate), + vendorId: + params.purchasingTransactionType === 'purchase' + ? undefined + : optionalValue(params.readVendorId), + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + } + if (operation === ACCOUNTING_READ_OPERATION) { + if (params.readMode === 'by_id') { + return { + credential: oauthCredentialValue, + transactionType: params.accountingTransactionType, + readMode: params.readMode, + transactionId: optionalValue(params.transactionId), + } + } + return { + credential: oauthCredentialValue, + transactionType: params.accountingTransactionType, + readMode: params.readMode, + startDate: optionalValue(params.readStartDate), + endDate: optionalValue(params.readEndDate), + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + } + if (operation === REPORT_OPERATION) { + const reportType = params.reportType + return { + credential: oauthCredentialValue, + reportType, + startDate: reportSupports(reportType, 'startDate') + ? optionalValue(params.reportStartDate) + : undefined, + endDate: optionalValue(params.reportEndDate), + accountingMethod: reportSupports(reportType, 'accountingMethod') + ? (params.reportAccountingMethod ?? 'default') + : undefined, + summarizeBy: reportSupports(reportType, 'summarizeBy') + ? reportSummarizeValue(params, reportType) + : undefined, + customerId: reportSupports(reportType, 'customerId') + ? optionalValue(params.reportCustomerId) + : undefined, + vendorId: reportSupports(reportType, 'vendorId') + ? optionalValue(params.reportVendorId) + : undefined, + accountId: reportSupports(reportType, 'accountId') + ? optionalValue(params.reportAccountId) + : undefined, + itemId: reportSupports(reportType, 'itemId') + ? optionalValue(params.reportItemId) + : undefined, + classId: reportSupports(reportType, 'classId') + ? optionalValue(params.reportClassId) + : undefined, + departmentId: reportSupports(reportType, 'departmentId') + ? optionalValue(params.reportDepartmentId) + : undefined, + agingMethod: reportSupports(reportType, 'agingMethod') + ? (params.reportAgingMethod ?? 'default') + : undefined, + agingDays: reportSupports(reportType, 'agingPeriod') + ? parseOptionalPositiveInteger(params.reportAgingDays, 'agingDays') + : undefined, + transactionType: + reportType === 'transaction_list' && params.reportTransactionType !== 'default' + ? params.reportTransactionType + : undefined, + groupBy: + reportType === 'transaction_list' && params.reportGroupBy !== 'default' + ? params.reportGroupBy + : undefined, + accountsPayablePaid: + reportType === 'transaction_list' && params.reportAccountsPayablePaid !== 'default' + ? params.reportAccountsPayablePaid + : undefined, + accountsReceivablePaid: + reportType === 'transaction_list' && params.reportAccountsReceivablePaid !== 'default' + ? params.reportAccountsReceivablePaid + : undefined, + clearedStatus: + reportType === 'transaction_list' && params.reportClearedStatus !== 'default' + ? params.reportClearedStatus + : undefined, + documentNumber: + reportType === 'transaction_list' + ? optionalValue(params.reportDocumentNumber) + : undefined, + sourceAccountType: + reportType === 'transaction_list' && params.reportSourceAccountType !== 'default' + ? params.reportSourceAccountType + : undefined, + } + } + if (SALES_VOID_OPERATIONS.includes(operation as (typeof SALES_VOID_OPERATIONS)[number])) { + return { + credential: oauthCredentialValue, + transactionId: optionalValue(params.transactionId), + syncToken: optionalValue(params.syncToken), + confirmVoid: parseConfirmation(params.confirmVoid, 'confirmVoid'), + } + } + if ( + SALES_DOCUMENT_OPERATIONS.includes( + operation as (typeof SALES_DOCUMENT_OPERATIONS)[number] + ) + ) { + const isCreate = SALES_DOCUMENT_CREATE_OPERATIONS.includes( + operation as (typeof SALES_DOCUMENT_CREATE_OPERATIONS)[number] + ) + const isInvoice = + operation === 'quickbooks_create_invoice' || operation === 'quickbooks_update_invoice' + const isEstimate = + operation === 'quickbooks_create_estimate' || operation === 'quickbooks_update_estimate' + const isReceipt = + operation === 'quickbooks_create_sales_receipt' || + operation === 'quickbooks_update_sales_receipt' || + operation === 'quickbooks_create_refund_receipt' || + operation === 'quickbooks_update_refund_receipt' + return { + credential: oauthCredentialValue, + transactionId: isCreate ? undefined : optionalValue(params.transactionId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + customerId: optionalValue(params.customerId), + lines: parseQuickBooksSalesLines(params.lines), + transactionDate: optionalValue(params.transactionDate), + dueDate: isInvoice ? optionalValue(params.dueDate) : undefined, + expirationDate: isEstimate ? optionalValue(params.expirationDate) : undefined, + documentNumber: optionalValue(params.documentNumber), + privateNote: optionalValue(params.privateNote), + customerMemo: optionalValue(params.customerMemo), + paymentMethodId: isReceipt ? optionalValue(params.paymentMethodId) : undefined, + paymentReferenceNumber: isReceipt + ? optionalValue(params.paymentReferenceNumber) + : undefined, + depositAccountId: isReceipt ? optionalValue(params.depositAccountId) : undefined, + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if (PAYMENT_OPERATIONS.includes(operation as (typeof PAYMENT_OPERATIONS)[number])) { + const isCreate = operation === 'quickbooks_create_customer_payment' + return { + credential: oauthCredentialValue, + paymentId: isCreate ? undefined : optionalValue(params.transactionId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + customerId: optionalValue(params.customerId), + totalAmount: parseOptionalNumber(params.totalAmount, 'totalAmount'), + transactionDate: optionalValue(params.transactionDate), + privateNote: optionalValue(params.privateNote), + paymentReferenceNumber: optionalValue(params.paymentReferenceNumber), + paymentMethodId: optionalValue(params.paymentMethodId), + depositAccountId: optionalValue(params.depositAccountId), + invoiceAllocations: parseQuickBooksInvoiceAllocations(params.invoiceAllocations), + unapplyOmittedInvoices: isCreate + ? undefined + : parseConfirmation(params.unapplyOmittedInvoices, 'unapplyOmittedInvoices'), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if ( + PURCHASING_MUTATION_OPERATIONS.includes( + operation as (typeof PURCHASING_MUTATION_OPERATIONS)[number] + ) + ) { + const isCreate = PURCHASING_CREATE_OPERATIONS.includes( + operation as (typeof PURCHASING_CREATE_OPERATIONS)[number] + ) + const isPurchaseOrder = + operation === 'quickbooks_create_purchase_order' || + operation === 'quickbooks_update_purchase_order' + const isBill = + operation === 'quickbooks_create_bill' || operation === 'quickbooks_update_bill' + const isBillPayment = + operation === 'quickbooks_create_bill_payment' || + operation === 'quickbooks_update_bill_payment' + const isVendorCredit = + operation === 'quickbooks_create_vendor_credit' || + operation === 'quickbooks_update_vendor_credit' + const isPurchase = + operation === 'quickbooks_create_purchase' || operation === 'quickbooks_update_purchase' + return { + credential: oauthCredentialValue, + purchaseOrderId: + !isCreate && isPurchaseOrder ? optionalValue(params.transactionId) : undefined, + billId: !isCreate && isBill ? optionalValue(params.transactionId) : undefined, + billPaymentId: + !isCreate && isBillPayment ? optionalValue(params.transactionId) : undefined, + vendorCreditId: + !isCreate && isVendorCredit ? optionalValue(params.transactionId) : undefined, + purchaseId: !isCreate && isPurchase ? optionalValue(params.transactionId) : undefined, + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + vendorId: optionalValue(params.vendorId), + apAccountId: + isPurchaseOrder || isBill || isVendorCredit + ? optionalValue(params.apAccountId) + : undefined, + lines: + isCreate && (isPurchaseOrder || isBill || isVendorCredit || isPurchase) + ? isBill + ? parseQuickBooksBillLines(params.purchasingLines) + : parseQuickBooksPurchasingLines(params.purchasingLines) + : undefined, + totalAmount: + isCreate && isBillPayment + ? parseOptionalNumber(params.totalAmount, 'totalAmount') + : undefined, + paymentType: + isCreate && isBillPayment + ? optionalValue(params.billPaymentType) + : isCreate && isPurchase + ? optionalValue(params.purchasePaymentType) + : undefined, + currentPaymentType: + !isCreate && isPurchase + ? optionalValue(params.currentPurchasePaymentType) + : undefined, + paymentAccountId: + isCreate && (isBillPayment || isPurchase) + ? optionalValue(params.paymentAccountId) + : undefined, + billAllocations: + isCreate && isBillPayment + ? parseQuickBooksBillAllocations(params.billAllocations) + : undefined, + transactionDate: optionalValue(params.transactionDate), + dueDate: isBill ? optionalValue(params.dueDate) : undefined, + documentNumber: + isPurchaseOrder || isBill || isVendorCredit + ? optionalValue(params.documentNumber) + : undefined, + paymentReference: isPurchase ? optionalValue(params.paymentReference) : undefined, + privateNote: optionalValue(params.privateNote), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if ( + ACCOUNTING_MUTATION_OPERATIONS.includes( + operation as (typeof ACCOUNTING_MUTATION_OPERATIONS)[number] + ) + ) { + const isJournalEntry = + operation === 'quickbooks_create_journal_entry' || + operation === 'quickbooks_update_journal_entry' + const isCreate = ACCOUNTING_CREATE_OPERATIONS.includes( + operation as (typeof ACCOUNTING_CREATE_OPERATIONS)[number] + ) + return { + credential: oauthCredentialValue, + journalEntryId: + !isCreate && isJournalEntry ? optionalValue(params.transactionId) : undefined, + depositId: + !isCreate && !isJournalEntry ? optionalValue(params.transactionId) : undefined, + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + lines: + isCreate && isJournalEntry + ? parseQuickBooksJournalLines(params.journalLines) + : isCreate + ? parseQuickBooksDepositLines(params.depositLines) + : undefined, + confirmPosting: isJournalEntry + ? parseConfirmation(params.confirmPosting, 'confirmPosting') + : undefined, + depositAccountId: !isJournalEntry ? optionalValue(params.depositAccountId) : undefined, + transactionDate: optionalValue(params.transactionDate), + documentNumber: isJournalEntry ? optionalValue(params.documentNumber) : undefined, + privateNote: optionalValue(params.privateNote), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if ( + operation === 'quickbooks_create_customer' || + operation === 'quickbooks_update_customer' + ) { + const isCreate = operation === 'quickbooks_create_customer' + return { + credential: oauthCredentialValue, + customerId: isCreate ? undefined : optionalValue(params.customerId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + displayName: optionalValue(params.displayName), + companyName: optionalValue(params.companyName), + givenName: optionalValue(params.givenName), + familyName: optionalValue(params.familyName), + primaryEmail: optionalValue(params.primaryEmail), + primaryPhone: optionalValue(params.primaryPhone), + billingAddress: parseQuickBooksAddress(params.billingAddress, 'billingAddress'), + shippingAddress: parseQuickBooksAddress(params.shippingAddress, 'shippingAddress'), + taxable: parseTriStateBoolean(params.taxable, 'taxable'), + activeStatus: isCreate ? undefined : (params.activeStatus ?? 'unchanged'), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if ( + operation === 'quickbooks_create_employee' || + operation === 'quickbooks_update_employee' + ) { + const isCreate = operation === 'quickbooks_create_employee' + return { + credential: oauthCredentialValue, + employeeId: isCreate ? undefined : optionalValue(params.employeeId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + displayName: optionalValue(params.displayName), + givenName: optionalValue(params.givenName), + familyName: optionalValue(params.familyName), + primaryEmail: optionalValue(params.primaryEmail), + primaryPhone: optionalValue(params.primaryPhone), + primaryAddress: parseQuickBooksAddress(params.primaryAddress, 'primaryAddress'), + printOnCheckName: optionalValue(params.printOnCheckName), + billableTime: parseTriStateBoolean(params.billableTime, 'billableTime'), + activeStatus: isCreate ? undefined : (params.activeStatus ?? 'unchanged'), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if (operation === 'quickbooks_create_vendor' || operation === 'quickbooks_update_vendor') { + const isCreate = operation === 'quickbooks_create_vendor' + return { + credential: oauthCredentialValue, + vendorId: isCreate ? undefined : optionalValue(params.vendorId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + displayName: optionalValue(params.displayName), + companyName: optionalValue(params.companyName), + givenName: optionalValue(params.givenName), + familyName: optionalValue(params.familyName), + primaryEmail: optionalValue(params.primaryEmail), + primaryPhone: optionalValue(params.primaryPhone), + billingAddress: parseQuickBooksAddress(params.billingAddress, 'billingAddress'), + printOnCheckName: optionalValue(params.printOnCheckName), + accountNumber: optionalValue(params.accountNumber), + vendor1099: parseTriStateBoolean(params.vendor1099, 'vendor1099'), + activeStatus: isCreate ? undefined : (params.activeStatus ?? 'unchanged'), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + if (operation === 'quickbooks_create_item' || operation === 'quickbooks_update_item') { + const isCreate = operation === 'quickbooks_create_item' + return { + credential: oauthCredentialValue, + itemId: isCreate ? undefined : optionalValue(params.itemId), + syncToken: isCreate ? undefined : optionalValue(params.syncToken), + name: optionalValue(params.name), + itemType: isCreate ? optionalValue(params.itemType) : undefined, + incomeAccountId: optionalValue(params.incomeAccountId), + description: optionalValue(params.description), + unitPrice: parseOptionalNumber(params.unitPrice, 'unitPrice'), + purchaseDescription: optionalValue(params.purchaseDescription), + purchaseCost: parseOptionalNumber(params.purchaseCost, 'purchaseCost'), + expenseAccountId: optionalValue(params.expenseAccountId), + taxable: parseTriStateBoolean(params.taxable, 'taxable'), + activeStatus: isCreate ? undefined : (params.activeStatus ?? 'unchanged'), + requestId: isCreate ? optionalValue(params.requestId) : undefined, + } + } + return { credential: oauthCredentialValue } + }, + }, + }, + inputs: { + operation: { type: 'string', description: 'QuickBooks operation to perform' }, + oauthCredential: { + type: 'string', + description: 'OAuth credential bound to one QuickBooks company', + }, + recordType: { type: 'string', description: 'Master-data entity type' }, + readMode: { type: 'string', description: 'List or by-ID read mode' }, + recordId: { type: 'string', description: 'Master-data record ID' }, + transactionType: { type: 'string', description: 'Sales transaction entity type' }, + purchasingTransactionType: { + type: 'string', + description: 'Purchasing transaction entity type', + }, + accountingTransactionType: { + type: 'string', + description: 'Accounting transaction entity type', + }, + reportType: { type: 'string', description: 'Financial report type' }, + reportStartDate: { type: 'string', description: 'Report start date' }, + reportEndDate: { type: 'string', description: 'Report end or as-of date' }, + reportAccountingMethod: { type: 'string', description: 'Cash or accrual report basis' }, + reportSummarizeBy: { type: 'string', description: 'Report column summarization' }, + reportCustomerSalesSummarizeBy: { + type: 'string', + description: 'Sales report column summarization', + }, + reportVendorExpenseSummarizeBy: { + type: 'string', + description: 'Vendor expense report column summarization', + }, + reportTimeSummarizeBy: { + type: 'string', + description: 'Time-based report column summarization', + }, + reportCustomerId: { type: 'string', description: 'Customer report filter ID' }, + reportVendorId: { type: 'string', description: 'Vendor report filter ID' }, + reportAccountId: { type: 'string', description: 'Account report filter ID' }, + reportItemId: { type: 'string', description: 'Product or service report filter ID' }, + reportClassId: { type: 'string', description: 'Class report filter ID' }, + reportDepartmentId: { type: 'string', description: 'Department report filter ID' }, + reportAgingMethod: { type: 'string', description: 'Aging report calculation date' }, + reportAgingDays: { type: 'number', description: 'Days in each aging period' }, + reportTransactionType: { type: 'string', description: 'Transaction List type filter' }, + reportGroupBy: { type: 'string', description: 'Transaction List grouping' }, + reportAccountsPayablePaid: { type: 'string', description: 'Transaction List A/P status' }, + reportAccountsReceivablePaid: { type: 'string', description: 'Transaction List A/R status' }, + reportClearedStatus: { type: 'string', description: 'Transaction List cleared status' }, + reportDocumentNumber: { type: 'string', description: 'Transaction List document number' }, + reportSourceAccountType: { + type: 'string', + description: 'Transaction List source account type', + }, + readActiveStatus: { type: 'string', description: 'Master-data active-status filter' }, + readStartDate: { type: 'string', description: 'Transaction list start date' }, + readEndDate: { type: 'string', description: 'Transaction list end date' }, + readCustomerId: { type: 'string', description: 'Sales list customer filter' }, + readVendorId: { type: 'string', description: 'Purchasing list vendor filter' }, + transactionId: { type: 'string', description: 'QuickBooks transaction ID' }, + startPosition: { + type: 'number', + description: 'One-based position of the first list item to request', + }, + maxResults: { + type: 'number', + description: 'Number of list items to request, from 1 through 100', + }, + customerId: { type: 'string', description: 'QuickBooks customer ID' }, + vendorId: { type: 'string', description: 'QuickBooks vendor ID' }, + itemId: { type: 'string', description: 'Item ID for an update' }, + employeeId: { type: 'string', description: 'Employee ID for an update' }, + syncToken: { type: 'string', description: 'Current entity sync token' }, + displayName: { type: 'string', description: 'Customer, employee, or vendor display name' }, + companyName: { type: 'string', description: 'Customer or vendor company name' }, + givenName: { type: 'string', description: 'Customer, employee, or vendor given name' }, + familyName: { type: 'string', description: 'Customer, employee, or vendor family name' }, + primaryEmail: { type: 'string', description: 'Primary email address' }, + primaryPhone: { type: 'string', description: 'Primary phone number' }, + billingAddress: { type: 'json', description: 'Allowlisted billing address object' }, + shippingAddress: { type: 'json', description: 'Allowlisted shipping address object' }, + primaryAddress: { type: 'json', description: 'Allowlisted employee address object' }, + taxable: { type: 'boolean', description: 'Optional taxable value' }, + printOnCheckName: { type: 'string', description: 'Employee or vendor name printed on checks' }, + billableTime: { type: 'boolean', description: 'Optional employee billable-time value' }, + accountNumber: { type: 'string', description: 'Vendor account number' }, + vendor1099: { type: 'boolean', description: 'Optional vendor 1099 value' }, + name: { type: 'string', description: 'Item name' }, + itemType: { type: 'string', description: 'Service or Non-inventory item type' }, + incomeAccountId: { type: 'string', description: 'Item income account ID' }, + description: { type: 'string', description: 'Item sales description' }, + unitPrice: { type: 'number', description: 'Item sales price' }, + purchaseDescription: { type: 'string', description: 'Item purchase description' }, + purchaseCost: { type: 'number', description: 'Item purchase cost' }, + expenseAccountId: { type: 'string', description: 'Item expense account ID' }, + activeStatus: { type: 'string', description: 'Entity active-status change' }, + lines: { type: 'json', description: 'Bounded item and description sales lines' }, + purchasingLines: { + type: 'json', + description: + 'Bounded purchasing expense lines; Create Bill lines may include paired Purchase Order and line IDs', + }, + journalLines: { type: 'json', description: 'Bounded balanced journal-entry lines' }, + depositLines: { type: 'json', description: 'Bounded account-based deposit lines' }, + totalAmount: { type: 'number', description: 'Customer or Bill payment total' }, + apAccountId: { type: 'string', description: 'QuickBooks accounts-payable account ID' }, + billPaymentType: { type: 'string', description: 'Check or credit-card BillPayment type' }, + purchasePaymentType: { + type: 'string', + description: 'Cash, check, or credit-card Purchase type', + }, + currentPurchasePaymentType: { + type: 'string', + description: 'Current Purchase type required unchanged for a sparse update', + }, + paymentAccountId: { type: 'string', description: 'QuickBooks payment account ID' }, + billAllocations: { type: 'json', description: 'Bounded BillPayment allocations to Bills' }, + transactionDate: { type: 'string', description: 'Transaction date in YYYY-MM-DD format' }, + dueDate: { type: 'string', description: 'Invoice due date in YYYY-MM-DD format' }, + expirationDate: { + type: 'string', + description: 'Estimate expiration date in YYYY-MM-DD format', + }, + documentNumber: { type: 'string', description: 'QuickBooks document number' }, + privateNote: { type: 'string', description: 'Internal transaction note' }, + customerMemo: { type: 'string', description: 'Customer-facing transaction memo' }, + paymentMethodId: { type: 'string', description: 'QuickBooks payment method ID' }, + paymentReferenceNumber: { type: 'string', description: 'Payment reference number' }, + paymentReference: { type: 'string', description: 'Purchase payment reference number' }, + depositAccountId: { type: 'string', description: 'QuickBooks deposit account ID' }, + invoiceAllocations: { + type: 'json', + description: 'Bounded customer-payment allocations to invoices', + }, + unapplyOmittedInvoices: { + type: 'boolean', + description: 'Replace payment allocations outright, unapplying every invoice not listed', + }, + requestId: { type: 'string', description: 'Optional Intuit idempotency request ID' }, + confirmVoid: { type: 'boolean', description: 'Explicit confirmation for a void operation' }, + confirmPosting: { + type: 'boolean', + description: 'Explicit confirmation before posting a journal entry', + }, + documentTransactionType: { + type: 'string', + description: 'Supported transaction type for email or PDF download', + }, + documentTransactionId: { + type: 'string', + description: 'QuickBooks transaction ID for email or PDF download', + }, + confirmSend: { type: 'boolean', description: 'Explicit confirmation before sending email' }, + recipientOverride: { type: 'string', description: 'Optional single email recipient override' }, + documentFileName: { type: 'string', description: 'Optional PDF filename override' }, + attachmentTargetType: { type: 'string', description: 'QuickBooks attachment target type' }, + attachmentTargetId: { type: 'string', description: 'QuickBooks attachment target ID' }, + attachmentId: { type: 'string', description: 'QuickBooks attachment ID' }, + attachmentKind: { type: 'string', description: 'File or Note attachment kind' }, + attachmentFile: { type: 'file', description: 'Single file to attach to QuickBooks' }, + attachmentNote: { type: 'string', description: 'Note text to attach to QuickBooks' }, + attachmentFileName: { type: 'string', description: 'Optional attachment filename override' }, + attachmentContentType: { type: 'string', description: 'Optional compatible MIME type' }, + attachmentDescription: { type: 'string', description: 'Optional file attachment description' }, + }, + outputs: { + company: { + type: 'json', + description: + 'CompanyInfo with Id, CompanyName, LegalName, addresses, contact details, company settings, and MetaData', + condition: { field: 'operation', value: 'quickbooks_get_company_info' }, + }, + recordType: { + type: 'string', + description: 'Master-data record type returned by the read', + condition: { field: 'operation', value: MASTER_DATA_OPERATION }, + }, + transactionType: { + type: 'string', + description: 'Sales, purchasing, or accounting transaction type returned by the read', + condition: { + field: 'operation', + value: [ + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + EMAIL_TRANSACTION_OPERATION, + DOWNLOAD_TRANSACTION_PDF_OPERATION, + ], + }, + }, + transactionId: { + type: 'string', + description: 'QuickBooks transaction ID used by the document operation', + condition: { + field: 'operation', + value: [EMAIL_TRANSACTION_OPERATION, DOWNLOAD_TRANSACTION_PDF_OPERATION], + }, + }, + reportType: { + type: 'string', + description: 'Financial report type that was run', + condition: { field: 'operation', value: REPORT_OPERATION }, + }, + header: { + type: 'json', + description: 'Native QuickBooks report header, periods, basis, filters, and options', + condition: { field: 'operation', value: REPORT_OPERATION }, + }, + columns: { + type: 'json', + description: 'Native QuickBooks report column definitions', + condition: { field: 'operation', value: REPORT_OPERATION }, + }, + rows: { + type: 'json', + description: 'Native hierarchical QuickBooks report rows and summaries', + condition: { field: 'operation', value: REPORT_OPERATION }, + }, + item: { + type: 'json', + description: + 'Single master-data, transaction, or attachment record with native QuickBooks fields', + condition: { + field: 'operation', + value: [ + MASTER_DATA_OPERATION, + SALES_READ_OPERATION, + PURCHASING_READ_OPERATION, + ACCOUNTING_READ_OPERATION, + READ_ATTACHMENTS_OPERATION, + ], + and: { field: 'readMode', value: 'by_id' }, + }, + }, + items: { + type: 'array', + description: 'Master-data, transaction, or attachment objects with native QuickBooks fields', + condition: LIST_OUTPUT_CONDITION, + }, + startPosition: { + type: 'number', + description: 'One-based position of the first returned list item', + condition: LIST_OUTPUT_CONDITION, + }, + maxResults: { + type: 'number', + description: 'Actual number of items reported for the list response', + condition: LIST_OUTPUT_CONDITION, + }, + nextStartPosition: { + type: 'number', + description: 'Position to pass into an explicit next-page request', + condition: LIST_OUTPUT_CONDITION, + }, + hasMore: { + type: 'boolean', + description: 'Conservative indication that another list page may exist', + condition: LIST_OUTPUT_CONDITION, + }, + record: { + type: 'json', + description: + 'Created, updated, voided, or emailed record with native QuickBooks fields when QuickBooks returns one', + condition: { + field: 'operation', + value: [...MUTATION_OPERATIONS, EMAIL_TRANSACTION_OPERATION], + }, + }, + recordId: { + type: 'string', + description: 'ID of the created, updated, or voided QuickBooks record', + condition: { field: 'operation', value: [...MUTATION_OPERATIONS] }, + }, + syncToken: { + type: 'string', + description: 'Latest QuickBooks sync token for a subsequent update', + condition: { field: 'operation', value: [...MUTATION_OPERATIONS] }, + }, + voided: { + type: 'boolean', + description: 'True when QuickBooks successfully voided the transaction', + condition: { field: 'operation', value: [...SALES_VOID_OPERATIONS] }, + }, + linkingRequested: { + type: 'boolean', + description: 'Whether Create Bill requested any Purchase Order line links', + condition: { field: 'operation', value: 'quickbooks_create_bill' }, + }, + linkingSucceeded: { + type: 'boolean', + description: + 'Whether QuickBooks returned every requested Purchase Order line link; null when no links were requested', + condition: { field: 'operation', value: 'quickbooks_create_bill' }, + }, + linkedLines: { + type: 'array', + description: + 'Confirmed Purchase Order links as [{purchaseOrderId, purchaseOrderLineId, billLineId}]', + condition: { field: 'operation', value: 'quickbooks_create_bill' }, + }, + missingLinks: { + type: 'array', + description: + 'Requested links omitted by QuickBooks as [{purchaseOrderId, purchaseOrderLineId}]', + condition: { field: 'operation', value: 'quickbooks_create_bill' }, + }, + linkingWarning: { + type: 'string', + description: 'Warning that QuickBooks created the Bill without every requested link', + condition: { field: 'operation', value: 'quickbooks_create_bill' }, + }, + sent: { + type: 'boolean', + description: 'Whether QuickBooks accepted the transaction email request', + condition: { field: 'operation', value: EMAIL_TRANSACTION_OPERATION }, + }, + attachment: { + type: 'json', + description: 'Created native QuickBooks attachment metadata', + condition: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + }, + attachmentId: { + type: 'string', + description: 'QuickBooks attachment ID', + condition: { + field: 'operation', + value: [ADD_ATTACHMENT_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + }, + attachmentKind: { + type: 'string', + description: 'Created QuickBooks attachment kind', + condition: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + }, + targetType: { + type: 'string', + description: 'QuickBooks attachment target type', + condition: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + }, + targetId: { + type: 'string', + description: 'QuickBooks attachment target ID', + condition: { field: 'operation', value: ADD_ATTACHMENT_OPERATION }, + }, + file: { + type: 'file', + description: 'Downloaded QuickBooks file stored in execution files', + condition: { + field: 'operation', + value: [DOWNLOAD_TRANSACTION_PDF_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + }, + fileName: { + type: 'string', + description: 'Downloaded file name', + condition: { + field: 'operation', + value: [DOWNLOAD_TRANSACTION_PDF_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + }, + mimeType: { + type: 'string', + description: 'Downloaded file MIME type', + condition: { + field: 'operation', + value: [DOWNLOAD_TRANSACTION_PDF_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + }, + size: { + type: 'number', + description: 'Downloaded file size in bytes', + condition: { + field: 'operation', + value: [DOWNLOAD_TRANSACTION_PDF_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + }, + }, + time: { + type: 'string', + description: 'QuickBooks response timestamp', + condition: { + field: 'operation', + value: [DOWNLOAD_TRANSACTION_PDF_OPERATION, DOWNLOAD_ATTACHMENT_OPERATION], + not: true, + }, + }, + }, +} + +export const QuickBooksBlockMeta = { + tags: ['payments', 'automation', 'data-analytics'], + url: 'https://quickbooks.intuit.com', + templates: [ + { + icon: QuickBooksIcon, + title: 'QuickBooks customer onboarding', + prompt: + 'Build a workflow that receives an approved customer profile, creates the QuickBooks customer, and stores its ID and sync token in a Sim table.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'customers', 'onboarding'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks vendor onboarding', + prompt: + 'Create a workflow that receives approved vendor identity, contact, address, and 1099 details, creates the QuickBooks vendor, and stores the returned ID and sync token.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'vendors', 'procurement'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks catalogue maintenance', + prompt: + 'Build a workflow that reads filtered QuickBooks master data, creates approved non-payroll employees or Service and Non-inventory items, and safely updates exposed fields while retaining returned IDs and sync tokens.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'catalogue', 'operations'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks monthly and year-end reporting', + prompt: + 'Build a scheduled workflow that runs monthly and year-end Balance Sheet, Profit and Loss, Trial Balance, and Cash Flow reports, preserves their native rows and summaries, and stores review results in a Sim table.', + modules: ['scheduled', 'tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reporting', 'financial-close'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks estimate preparation', + prompt: + 'Build a workflow that receives an approved customer quote and line items, creates a QuickBooks estimate, and stores its ID and sync token for controlled revisions.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'estimates', 'sales'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks invoice creation and delivery', + prompt: + 'Create a workflow that validates approved customer and item IDs, creates a QuickBooks invoice, stores its ID and sync token, then—after explicit approval—emails it or downloads its PDF for controlled delivery and archiving.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'invoices', 'receivables'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks partial-payment application', + prompt: + 'Build a workflow that records a customer payment, applies bounded amounts to approved QuickBooks invoice IDs, and reports any unapplied remainder.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'payments', 'receivables'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks journal adjustments and deposits', + prompt: + 'Build a controlled workflow that posts an explicitly approved, balanced QuickBooks journal entry or records a bounded deposit, then runs cash- and accrual-basis reports to support the accounting review.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'accounting', 'journal-entries'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks receivables and payables aging', + prompt: + 'Create a scheduled workflow that runs A/R and A/P aging summaries and details with approved aging controls, optionally filters by customer or vendor, and flags balances requiring accountant review without changing records.', + modules: ['scheduled', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reporting', 'aging'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks bill entry and payment', + prompt: + 'Build a controlled workflow that reads an approved Purchase Order by ID, captures its Line IDs, creates a QuickBooks Bill with explicit PO-line mappings, checks linkingSucceeded and missingLinks, attaches one approved receipt or audit note, and records a separately approved payment only after reviewing the created Bill.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'payments', 'payables'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks customer, vendor, and expense analysis', + prompt: + 'Create a workflow that runs customer and vendor balance reports, expenses by vendor, or the Transaction List with bounded date, entity, paid-status, cleared-status, document-number, grouping, and source-account filters for accountant review.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reporting', 'analysis'], + }, + ], + skills: [ + { + name: 'onboard-quickbooks-customers', + description: 'Create approved QuickBooks customers and retain their IDs and sync tokens.', + content: + '# Onboard QuickBooks Customers\n\n## Steps\n1. Validate the approved customer identity and contact details.\n2. Use Create Customer with a unique display name.\n3. Store the returned `recordId` and `syncToken` for later updates.\n\n## Output\nReturn the created customer, ID, and sync token. Report duplicate-name faults for human review.', + }, + { + name: 'onboard-quickbooks-vendors', + description: 'Create approved QuickBooks vendors with bounded contact and 1099 fields.', + content: + '# Onboard QuickBooks Vendors\n\n## Steps\n1. Validate the approved vendor identity, contact, address, and optional 1099 status.\n2. Use Create Vendor.\n3. Store the returned `recordId` and `syncToken`.\n\n## Output\nReturn the created vendor and identifiers. Do not claim to merge vendors or administer tax identifiers.', + }, + { + name: 'maintain-products-and-services', + description: 'Create supported items or update exposed item fields without changing types.', + content: + '# Maintain QuickBooks Products and Services\n\n## Steps\n1. Read Account master data to obtain approved account IDs.\n2. Create a Service or Non-inventory Item, or update exposed basic fields without changing the existing item Type.\n3. Store the latest item ID and sync token.\n\n## Output\nReturn the native Item record. Do not claim to create Inventory, Category, or Group items or manage their specialized fields.', + }, + { + name: 'record-quickbooks-accounting-adjustments', + description: 'Post approved balanced journal entries, record deposits, and review transfers.', + content: + '# Record QuickBooks Accounting Adjustments\n\n## Steps\n1. Read the approved account IDs from Master Data.\n2. For a journal entry, verify that positive debit and credit lines balance and require explicit posting confirmation; for a deposit, verify the destination and source account IDs.\n3. Store the returned `recordId` and `syncToken`; use Read Accounting Transactions to review journal entries, deposits, or read-only transfers.\n4. Run an approved Trial Balance or financial statement on cash or accrual basis when an accountant requests post-adjustment review.\n\n## Output\nReturn the native accounting transaction and identifiers plus the native report hierarchy when requested. Do not claim to create transfers, replace transaction lines, or administer currencies.', + }, + { + name: 'prepare-quickbooks-estimates', + description: 'Create and revise bounded QuickBooks estimates from approved quote details.', + content: + '# Prepare QuickBooks Estimates\n\n## Steps\n1. Validate the customer, item IDs, amounts, and dates.\n2. Use Create Estimate with bounded item or description lines.\n3. For a revision, use the estimate ID and latest `syncToken` with Update Estimate.\n\n## Output\nReturn the native Estimate, ID, and latest sync token. Do not claim to email or accept the estimate.', + }, + { + name: 'create-quickbooks-invoices', + description: + 'Create approved QuickBooks invoices and explicitly deliver or archive their documents.', + content: + '# Create and Deliver QuickBooks Invoices\n\n## Steps\n1. Validate the approved customer, item IDs, positive amounts, and optional dates.\n2. Use Create Invoice with at least one bounded line.\n3. Store the returned `recordId` and `syncToken`.\n4. Only after explicit approval, use Email Transaction for one recipient or Download Transaction PDF for controlled archiving.\n5. Use Add Attachment for one approved receipt or audit note when needed, and Read Attachments to verify the metadata.\n\n## Output\nReturn the native Invoice and identifiers plus any sent status, downloaded file, or attachment ID. Do not claim bulk email, automatic resend, attachment deletion, or automatic payment collection.', + }, + { + name: 'record-quickbooks-payables', + description: + 'Create standalone or PO-linked bills and record bounded payments to approved Bill IDs.', + content: + '# Record QuickBooks Payables\n\n## Steps\n1. Validate the vendor, expense lines, and optional A/P account.\n2. For PO-linked billing, use Read Purchasing Transactions by ID and copy each approved Purchase Order `Line[].Id` into the matching Create Bill line with its PO ID.\n3. Use Create Bill, store its ID and sync token, and inspect `linkingSucceeded` and `missingLinks`; QuickBooks may create the Bill while omitting an invalid or unavailable link.\n4. When payment is separately approved, use Create Bill Payment with bounded Bill allocations whose amounts equal the payment total.\n5. Run A/P Aging Summary or Detail with supported vendor, department, date, and aging controls for accountant review.\n\n## Output\nAlways return the created Bill ID and linkage result. Preserve the native aging report when requested. Never imply that a missing link prevented Bill creation, and never create a payment implicitly.', + }, + { + name: 'analyze-quickbooks-financial-reports', + description: + 'Run verified financial, balance, aging, sales, and expense reports with supported filters.', + content: + '# Analyze QuickBooks Financial Reports\n\n## Steps\n1. Choose a verified report and an accountant-approved date or as-of period.\n2. Use Read Master Data to discover customer, vendor, account, item, class, or department IDs required by supported filters.\n3. Run Financial Report with only the controls shown for that report; compare cash and accrual basis or time summaries when requested.\n4. Preserve the native Header, Columns, nested Rows, and summaries for review.\n\n## Output\nReturn the report hierarchy and applied report context. Do not claim to export spreadsheets, email reports, customize columns, schedule delivery in QuickBooks, or mutate accounting records from a report.', + }, + ], +} as const satisfies BlockMeta diff --git a/apps/sim/blocks/registry-maps.ts b/apps/sim/blocks/registry-maps.ts index 4ef1bad73a3..50f570f8c93 100644 --- a/apps/sim/blocks/registry-maps.ts +++ b/apps/sim/blocks/registry-maps.ts @@ -245,6 +245,7 @@ import { ProspeoBlock, ProspeoBlockMeta } from '@/blocks/blocks/prospeo' import { PulseBlock, PulseBlockMeta, PulseV2Block } from '@/blocks/blocks/pulse' import { QdrantBlock, QdrantBlockMeta } from '@/blocks/blocks/qdrant' import { QuartrBlock, QuartrBlockMeta } from '@/blocks/blocks/quartr' +import { QuickBooksBlock, QuickBooksBlockMeta } from '@/blocks/blocks/quickbooks' import { QuiverBlock, QuiverBlockMeta } from '@/blocks/blocks/quiver' import { RailwayBlock, RailwayBlockMeta } from '@/blocks/blocks/railway' import { RB2BBlock, RB2BBlockMeta } from '@/blocks/blocks/rb2b' @@ -561,6 +562,7 @@ export const BLOCK_REGISTRY: Record = { pulse_v2: PulseV2Block, qdrant: QdrantBlock, quartr: QuartrBlock, + quickbooks: QuickBooksBlock, quiver: QuiverBlock, railway: RailwayBlock, rb2b: RB2BBlock, @@ -855,6 +857,7 @@ export const BLOCK_META_REGISTRY: Record = { pulse: PulseBlockMeta, qdrant: QdrantBlockMeta, quartr: QuartrBlockMeta, + quickbooks: QuickBooksBlockMeta, quiver: QuiverBlockMeta, railway: RailwayBlockMeta, rb2b: RB2BBlockMeta, diff --git a/apps/sim/components/icons.tsx b/apps/sim/components/icons.tsx index 606e5b0faf6..79e1c5da500 100644 --- a/apps/sim/components/icons.tsx +++ b/apps/sim/components/icons.tsx @@ -2581,6 +2581,25 @@ export function BrexIcon(props: SVGProps) { ) } +/** + * Official QuickBooks circular mark, cropped from the user-supplied + * Intuit_QuickBooks_logo.svg wordmark. + */ +export function QuickBooksIcon(props: SVGProps) { + return ( + + + + + ) +} + export function BrightDataIcon(props: SVGProps) { return ( !/[\r\n]/.test(value), 'Access token is invalid'), + realmId: z + .string() + .trim() + .max(64, 'QuickBooks company ID is too long') + .regex(/^[1-9]\d*$/, 'QuickBooks company ID is invalid'), +}) + +const documentTransactionTypeSchema = z.enum([ + 'credit_memo', + 'estimate', + 'invoice', + 'payment', + 'purchase_order', + 'refund_receipt', + 'sales_receipt', +]) + +const attachmentTargetTypeSchema = z.enum([ + 'bill', + 'bill_payment', + 'credit_memo', + 'deposit', + 'estimate', + 'invoice', + 'item', + 'journal_entry', + 'payment', + 'purchase', + 'purchase_order', + 'refund_receipt', + 'sales_receipt', + 'vendor_credit', +]) + +const optionalFileName = z.string().trim().max(180, 'Filename is too long').optional().nullable() +const optionalContentType = z + .string() + .trim() + .max(255, 'Content type is too long') + .optional() + .nullable() +const optionalDescription = z + .string() + .trim() + .max(1000, 'Description is too long') + .optional() + .nullable() +const optionalNote = z.string().trim().max(4000, 'Note is too long').optional().nullable() +const boundedId = z.string().trim().min(1, 'ID is required').max(256, 'ID is too long') +const routeErrorSchema = z.object({ success: z.literal(false), error: z.string().min(1) }) +const attachableSchema = z + .object({ + Id: z.string().min(1), + FileName: z.string().optional(), + ContentType: z.string().optional(), + Size: z.number().optional(), + Note: z.string().optional(), + }) + .passthrough() + +const executionContextShape = { + workspaceId: workspaceIdSchema.optional(), + workflowId: workflowIdSchema.optional(), + executionId: nonEmptyIdSchema.optional(), +} + +/** + * Both QuickBooks document downloads share one route. `documentKind` selects how + * the bytes are obtained: an attachment resolves a short-lived Intuit URL, a + * transaction PDF is rendered directly by the accounting API. + */ +export const quickBooksDownloadDocumentBodySchema = z.discriminatedUnion('documentKind', [ + quickBooksAuthSchema.extend({ + documentKind: z.literal('attachment'), + attachmentId: boundedId, + fileName: optionalFileName, + ...executionContextShape, + }), + quickBooksAuthSchema.extend({ + documentKind: z.literal('transaction_pdf'), + transactionType: documentTransactionTypeSchema, + transactionId: boundedId, + fileName: optionalFileName, + ...executionContextShape, + }), +]) + +export type QuickBooksDownloadDocumentBody = z.output + +export const quickBooksAddAttachmentBodySchema = quickBooksAuthSchema + .extend({ + attachmentKind: z.enum(['file', 'note']), + targetType: attachmentTargetTypeSchema, + targetId: boundedId, + file: RawFileInputSchema.optional().nullable(), + fileName: optionalFileName, + contentType: optionalContentType, + description: optionalDescription, + note: optionalNote, + }) + .superRefine((value, context) => { + if (value.attachmentKind === 'file') { + if (!value.file) + context.addIssue({ + code: 'custom', + path: ['file'], + message: 'File is required in File mode', + }) + if (value.note) + context.addIssue({ + code: 'custom', + path: ['note'], + message: 'Note-only content is not allowed in File mode', + }) + } else { + if (!value.note) + context.addIssue({ + code: 'custom', + path: ['note'], + message: 'Note is required in Note mode', + }) + if (value.file) + context.addIssue({ + code: 'custom', + path: ['file'], + message: 'A file is not allowed in Note mode', + }) + if (value.fileName || value.contentType || value.description) { + context.addIssue({ + code: 'custom', + path: ['attachmentKind'], + message: 'File-only fields are not allowed in Note mode', + }) + } + } + }) + +const quickBooksStoredFileShape = { + file: userFileSchema, + fileName: z.string().min(1).max(180), + size: z.number().int().positive(), +} + +export const quickBooksDownloadDocumentContract = defineRouteContract({ + method: 'POST', + path: '/api/tools/quickbooks/download-document', + body: quickBooksDownloadDocumentBodySchema, + response: { + mode: 'json', + schema: z.union([ + z.object({ + success: z.literal(true), + output: z.object({ + ...quickBooksStoredFileShape, + attachmentId: boundedId, + mimeType: z.string().min(1).max(255), + }), + }), + z.object({ + success: z.literal(true), + output: z.object({ + ...quickBooksStoredFileShape, + transactionType: documentTransactionTypeSchema, + transactionId: boundedId, + mimeType: z.literal('application/pdf'), + }), + }), + routeErrorSchema, + ]), + }, +}) + +export const quickBooksAddAttachmentContract = defineRouteContract({ + method: 'POST', + path: '/api/tools/quickbooks/add-attachment', + body: quickBooksAddAttachmentBodySchema, + response: { + mode: 'json', + schema: z.union([ + z.object({ + success: z.literal(true), + output: z.object({ + attachment: attachableSchema, + attachmentId: boundedId, + attachmentKind: z.enum(['file', 'note']), + targetType: attachmentTargetTypeSchema, + targetId: boundedId, + time: z.string().nullable(), + }), + }), + routeErrorSchema, + ]), + }, +}) diff --git a/apps/sim/lib/auth/connectors/providers.ts b/apps/sim/lib/auth/connectors/providers.ts index af3a1928354..6d15370d93e 100644 --- a/apps/sim/lib/auth/connectors/providers.ts +++ b/apps/sim/lib/auth/connectors/providers.ts @@ -7,12 +7,21 @@ import type { GenericOAuthConfig } from 'better-auth/plugins' import { syntheticConnectorEmail } from '@/lib/auth/connector-email' import { env } from '@/lib/core/config/env' import { + DEFAULT_MAX_ERROR_BODY_BYTES, readResponseJsonWithLimit, readResponseTextWithLimit, } from '@/lib/core/utils/stream-limits' import { getBaseUrl } from '@/lib/core/utils/urls' import { getMicrosoftUserInfoFromIdToken } from '@/lib/oauth/microsoft' +import { + fetchQuickBooksConnectionProfile, + getQuickBooksCallbackRealm, + QUICKBOOKS_AUTHORIZATION_URL, + QUICKBOOKS_OIDC_CLAIMS, + QUICKBOOKS_TOKEN_URL, +} from '@/lib/oauth/quickbooks' import { getCanonicalScopesForProvider } from '@/lib/oauth/utils' +import { QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS } from '@/tools/quickbooks/client' import { deriveZohoDeskBaseFromApiDomain } from '@/tools/zoho_desk/host-allowlist' /** @@ -2357,6 +2366,88 @@ export function buildConnectorProviders(): GenericOAuthConfig[] { }, }, + { + providerId: 'quickbooks', + clientId: env.QUICKBOOKS_CLIENT_ID as string, + clientSecret: env.QUICKBOOKS_CLIENT_SECRET as string, + authorizationUrl: QUICKBOOKS_AUTHORIZATION_URL, + tokenUrl: QUICKBOOKS_TOKEN_URL, + scopes: getCanonicalScopesForProvider('quickbooks'), + responseType: 'code', + accessType: 'offline', + prompt: 'consent', + redirectURI: `${getBaseUrl()}/api/auth/oauth2/callback/quickbooks`, + authorizationUrlParams: { + claims: JSON.stringify(QUICKBOOKS_OIDC_CLAIMS), + }, + getToken: async ({ code, redirectURI }) => { + const clientId = env.QUICKBOOKS_CLIENT_ID + const clientSecret = env.QUICKBOOKS_CLIENT_SECRET + if (!clientId || !clientSecret) { + throw new Error('QuickBooks OAuth client credentials are not configured') + } + + const response = await fetch(QUICKBOOKS_TOKEN_URL, { + method: 'POST', + headers: { + Authorization: `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`, + 'Content-Type': 'application/x-www-form-urlencoded', + }, + body: new URLSearchParams({ + code, + grant_type: 'authorization_code', + redirect_uri: redirectURI, + }), + signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), + }) + if (!response.ok) { + await readResponseTextWithLimit(response, { + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, + label: 'QuickBooks OAuth token error response', + }).catch(() => {}) + throw new Error(`QuickBooks OAuth token exchange failed with HTTP ${response.status}`) + } + + const data = await readResponseJsonWithLimit>(response, { + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, + label: 'QuickBooks OAuth token response', + }) + if (!data || typeof data !== 'object' || Array.isArray(data)) { + throw new Error('QuickBooks OAuth token exchange returned an invalid response') + } + + const tokens = getOAuth2Tokens(data) + if (!tokens.accessToken || !tokens.refreshToken) { + throw new Error( + 'QuickBooks OAuth token response did not include access and refresh tokens' + ) + } + if (typeof data.scope === 'string') { + tokens.scopes = data.scope.split(/\s+/).filter(Boolean) + } + return tokens + }, + getUserInfo: async (tokens) => { + if (!tokens.accessToken) { + throw new Error('QuickBooks OAuth did not issue an access token') + } + + const profile = await fetchQuickBooksConnectionProfile( + tokens.accessToken, + getQuickBooksCallbackRealm() + ) + const now = new Date() + return { + id: profile.accountId, + name: profile.name, + email: profile.email, + emailVerified: profile.emailVerified, + createdAt: now, + updatedAt: now, + } + }, + }, + // Cal.com provider { providerId: 'calcom', diff --git a/apps/sim/lib/core/config/env.ts b/apps/sim/lib/core/config/env.ts index a2decad9680..90a974f51fa 100644 --- a/apps/sim/lib/core/config/env.ts +++ b/apps/sim/lib/core/config/env.ts @@ -417,6 +417,9 @@ export const env = createEnv({ WEALTHBOX_CLIENT_SECRET: z.string().optional(), // WealthBox OAuth client secret PIPEDRIVE_CLIENT_ID: z.string().optional(), // Pipedrive OAuth client ID PIPEDRIVE_CLIENT_SECRET: z.string().optional(), // Pipedrive OAuth client secret + QUICKBOOKS_CLIENT_ID: z.string().optional(), // QuickBooks Online OAuth client ID + QUICKBOOKS_CLIENT_SECRET: z.string().optional(), // QuickBooks Online OAuth client secret + QUICKBOOKS_ENV: z.enum(['sandbox', 'production']).optional(), // QuickBooks Online API environment (must be configured explicitly) LINEAR_CLIENT_ID: z.string().optional(), // Linear OAuth client ID LINEAR_CLIENT_SECRET: z.string().optional(), // Linear OAuth client secret CLICKUP_CLIENT_ID: z.string().optional(), // ClickUp OAuth client ID diff --git a/apps/sim/lib/core/security/input-validation.server.ts b/apps/sim/lib/core/security/input-validation.server.ts index 133c013a3eb..f2d819ed798 100644 --- a/apps/sim/lib/core/security/input-validation.server.ts +++ b/apps/sim/lib/core/security/input-validation.server.ts @@ -966,6 +966,7 @@ export async function secureFetchWithPinnedIP( options: SecureFetchOptions & { allowHttp?: boolean } = {}, redirectCount = 0 ): Promise { + options.signal?.throwIfAborted() const maxRedirects = options.maxRedirects ?? DEFAULT_MAX_REDIRECTS const requestedMaxResponseBytes = options.maxResponseBytes const maxResponseBytes = @@ -1014,6 +1015,7 @@ export async function secureFetchWithPinnedIP( validateUrlWithDNS(redirectUrl, 'redirectUrl', { allowHttp: options.allowHttp }) .then((validation) => { + options.signal?.throwIfAborted() if (!validation.isValid) { settledReject(new Error(`Redirect blocked: ${validation.error}`)) return diff --git a/apps/sim/lib/core/security/redaction.test.ts b/apps/sim/lib/core/security/redaction.test.ts index e5c60abf969..0cc35785af1 100644 --- a/apps/sim/lib/core/security/redaction.test.ts +++ b/apps/sim/lib/core/security/redaction.test.ts @@ -53,6 +53,10 @@ describe('isSensitiveKey', () => { expect(isSensitiveKey('refresh_token')).toBe(true) expect(isSensitiveKey('auth_token')).toBe(true) expect(isSensitiveKey('accessToken')).toBe(true) + expect(isSensitiveKey('sessionToken')).toBe(true) + expect(isSensitiveKey('webIdentityToken')).toBe(true) + expect(isSensitiveKey('verificationToken')).toBe(true) + expect(isSensitiveKey('githubToken')).toBe(true) }) it.concurrent('should match secret variations', () => { @@ -107,9 +111,28 @@ describe('isSensitiveKey', () => { it.concurrent('should match ssh passphrases', () => { expect(isSensitiveKey('passphrase')).toBe(true) }) + + it.concurrent('should not allow arbitrary keys ending in workflow token names', () => { + expect(isSensitiveKey('asyncToken')).toBe(true) + expect(isSensitiveKey('homepageToken')).toBe(true) + }) }) describe('non-sensitive keys (no false positives)', () => { + it.concurrent('should bypass the exact allowlisted non-secret token fields', () => { + expect(isSensitiveKey('nextPageToken')).toBe(false) + expect(isSensitiveKey('syncToken')).toBe(false) + expect(isSensitiveKey('SyncToken')).toBe(false) + expect(isSensitiveKey('subjectFromWebIdentityToken')).toBe(false) + }) + + it.concurrent('should keep the allowlist exact rather than suffix-based', () => { + expect(isSensitiveKey('nextSyncToken')).toBe(true) + expect(isSensitiveKey('pageToken')).toBe(true) + expect(isSensitiveKey('nextToken')).toBe(true) + expect(isSensitiveKey('webIdentityToken')).toBe(true) + }) + it.concurrent('should not match keys with sensitive words as prefix only', () => { expect(isSensitiveKey('tokenCount')).toBe(false) expect(isSensitiveKey('tokenizer')).toBe(false) @@ -230,6 +253,24 @@ describe('redactApiKeys', () => { expect(result.config.normalField).toBe('normal-value') }) + it.concurrent('should preserve allowlisted token fields while redacting credentials', () => { + const result = redactApiKeys({ + nextPageToken: 'page-2', + subjectFromWebIdentityToken: 'arn-subject', + record: { Id: '42', SyncToken: '3' }, + accessToken: 'access-secret', + sessionToken: 'session-secret', + }) + + expect(result).toEqual({ + nextPageToken: 'page-2', + subjectFromWebIdentityToken: 'arn-subject', + record: { Id: '42', SyncToken: '3' }, + accessToken: REDACTED_MARKER, + sessionToken: REDACTED_MARKER, + }) + }) + it.concurrent('should redact sensitive keys in arrays', () => { const arr = [{ apiKey: 'secret-key-1' }, { apiKey: 'secret-key-2' }] diff --git a/apps/sim/lib/core/security/redaction.ts b/apps/sim/lib/core/security/redaction.ts index 09bfb1890af..d66aee2be6a 100644 --- a/apps/sim/lib/core/security/redaction.ts +++ b/apps/sim/lib/core/security/redaction.ts @@ -7,7 +7,21 @@ import { filterUserFileForDisplay, isUserFile } from '@/lib/core/utils/user-file export const REDACTED_MARKER = '[REDACTED]' export const TRUNCATED_MARKER = '[TRUNCATED]' -const BYPASS_REDACTION_KEYS = new Set(['nextPageToken']) +/** + * Exact `*token` field names that carry workflow state rather than authorization. + * Entries are lowercased; lookup is case-insensitive. + * + * `SENSITIVE_KEY_PATTERNS` below contains `/^.*token$/i`, which over-redacts a + * small set of documented, non-secret outputs. Keep this allowlist exact and tiny — + * unknown `*token` fields must stay redacted by default. + * + * - `nextpagetoken` — pagination cursor users pass into the next request. + * - `synctoken` — QuickBooks Online optimistic-concurrency version; every update + * tool requires it as an input, so it must stay readable in tool output. + * - `subjectfromwebidentitytoken` — documented STS block output (a subject-claim + * identifier, not a credential). See `apps/sim/blocks/blocks/sts.ts`. + */ +const BYPASS_REDACTION_KEYS = new Set(['nextpagetoken', 'synctoken', 'subjectfromwebidentitytoken']) /** Keys that contain large binary/encoded data that should be truncated in logs */ const LARGE_DATA_KEYS = new Set(['base64']) @@ -74,10 +88,10 @@ const SENSITIVE_VALUE_PATTERNS: Array<{ ] export function isSensitiveKey(key: string): boolean { - if (BYPASS_REDACTION_KEYS.has(key)) { + const lowerKey = key.toLowerCase() + if (BYPASS_REDACTION_KEYS.has(lowerKey)) { return false } - const lowerKey = key.toLowerCase() return SENSITIVE_KEY_PATTERNS.some((pattern) => pattern.test(lowerKey)) } diff --git a/apps/sim/lib/core/security/secure-fetch-response-cap.server.test.ts b/apps/sim/lib/core/security/secure-fetch-response-cap.server.test.ts index 78d6f21805d..66a4578cd50 100644 --- a/apps/sim/lib/core/security/secure-fetch-response-cap.server.test.ts +++ b/apps/sim/lib/core/security/secure-fetch-response-cap.server.test.ts @@ -16,15 +16,18 @@ vi.mock('@/lib/core/config/env-flags', () => ({ getProxyUrl: () => undefined, })) +import { resolveHostAddresses } from '@sim/security/dns' import { DEFAULT_MAX_RESPONSE_BYTES, secureFetchWithPinnedIP, } from '@/lib/core/security/input-validation.server' const servers: http.Server[] = [] +const mockResolveHostAddresses = vi.mocked(resolveHostAddresses) afterEach(() => { for (const server of servers.splice(0)) server.close() + vi.clearAllMocks() }) /** Starts a throwaway loopback server and returns its origin. */ @@ -36,6 +39,49 @@ async function startServer(handler: http.RequestListener): Promise { } describe('secureFetchWithPinnedIP response cap', () => { + it('does not open a request when the signal is already aborted', async () => { + let requests = 0 + const origin = await startServer((_req, res) => { + requests += 1 + res.end('unexpected') + }) + const controller = new AbortController() + controller.abort(new Error('cancelled')) + + await expect( + secureFetchWithPinnedIP(origin, '127.0.0.1', { + allowHttp: true, + signal: controller.signal, + }) + ).rejects.toThrow('cancelled') + expect(requests).toBe(0) + }) + + it('does not follow a redirect when cancellation arrives during redirect DNS validation', async () => { + let targetRequests = 0 + const targetOrigin = await startServer((_req, res) => { + targetRequests += 1 + res.end('unexpected') + }) + const redirectOrigin = await startServer((_req, res) => { + res.writeHead(302, { Location: targetOrigin.replace('127.0.0.1', 'localhost') }) + res.end() + }) + const controller = new AbortController() + mockResolveHostAddresses.mockImplementationOnce(async () => { + controller.abort(new Error('cancelled during redirect DNS')) + return { addresses: ['127.0.0.1'], preferred: '127.0.0.1' } + }) + + await expect( + secureFetchWithPinnedIP(redirectOrigin, '127.0.0.1', { + allowHttp: true, + signal: controller.signal, + }) + ).rejects.toThrow('cancelled during redirect DNS') + expect(targetRequests).toBe(0) + }) + it('rejects a body that exceeds an explicit cap instead of buffering it', async () => { const origin = await startServer((_req, res) => { res.writeHead(200, { 'Content-Type': 'application/octet-stream' }) diff --git a/apps/sim/lib/integrations/icon-mapping.ts b/apps/sim/lib/integrations/icon-mapping.ts index 628a6dd91be..18ebe9d3b91 100644 --- a/apps/sim/lib/integrations/icon-mapping.ts +++ b/apps/sim/lib/integrations/icon-mapping.ts @@ -175,6 +175,7 @@ import { PulseIcon, QdrantIcon, QuartrIcon, + QuickBooksIcon, QuiverIcon, RailwayIcon, RB2BIcon, @@ -440,6 +441,7 @@ export const blockTypeToIconMap: Record = { pulse_v2: PulseIcon, qdrant: QdrantIcon, quartr: QuartrIcon, + quickbooks: QuickBooksIcon, quiver: QuiverIcon, railway: RailwayIcon, rb2b: RB2BIcon, diff --git a/apps/sim/lib/integrations/integrations.json b/apps/sim/lib/integrations/integrations.json index a2d27494361..ea5064ee1b3 100644 --- a/apps/sim/lib/integrations/integrations.json +++ b/apps/sim/lib/integrations/integrations.json @@ -1,5 +1,5 @@ { - "updatedAt": "2026-08-02", + "updatedAt": "2026-08-03", "integrations": [ { "type": "onepassword", @@ -14560,6 +14560,214 @@ "integrationType": "analytics", "tags": ["data-analytics", "enrichment", "document-processing"] }, + { + "type": "quickbooks", + "slug": "quickbooks", + "name": "QuickBooks", + "description": "Manage QuickBooks Online company, transactions, reports, emails, PDFs, and attachments", + "longDescription": "Connect one QuickBooks Online company to manage bounded master-data, sales, purchasing, receivables, payables, accounting, reports, transaction delivery, and document workflows.", + "bgColor": "#2CA01C", + "iconName": "QuickBooksIcon", + "docsUrl": "https://docs.sim.ai/integrations/quickbooks", + "operations": [ + { + "name": "Get Company Info", + "description": "Get information about the connected QuickBooks Online company" + }, + { + "name": "Read Master Data", + "description": "List or read one account, class, customer, department, employee, item, or vendor" + }, + { + "name": "Create Customer", + "description": "Create a customer in the connected QuickBooks Online company" + }, + { + "name": "Update Customer", + "description": "Sparse-update a customer in the connected QuickBooks Online company" + }, + { + "name": "Create Employee", + "description": "Create a non-payroll employee profile in the connected QuickBooks Online company" + }, + { + "name": "Update Employee", + "description": "Sparse-update a non-payroll employee profile in the connected QuickBooks Online company" + }, + { + "name": "Create Vendor", + "description": "Create a vendor in the connected QuickBooks Online company" + }, + { + "name": "Update Vendor", + "description": "Sparse-update a vendor in the connected QuickBooks Online company" + }, + { + "name": "Create Item", + "description": "Create a Service or Non-inventory item in QuickBooks Online" + }, + { + "name": "Update Item", + "description": "Sparse-update supported fields on an item without changing its type" + }, + { + "name": "Read Sales Transactions", + "description": "List or read one estimate, invoice, sales receipt, payment, credit memo, or refund receipt" + }, + { + "name": "Create Estimate", + "description": "Create an estimate with bounded item and description lines" + }, + { + "name": "Update Estimate", + "description": "Sparse-update an estimate using its current sync token" + }, + { + "name": "Create Invoice", + "description": "Create an invoice without emailing or collecting payment" + }, + { + "name": "Update Invoice", + "description": "Sparse-update an invoice using its current sync token" + }, + { + "name": "Void Invoice", + "description": "Void an invoice after explicit confirmation" + }, + { + "name": "Create Sales Receipt", + "description": "Create a sales receipt for a completed customer sale" + }, + { + "name": "Update Sales Receipt", + "description": "Sparse-update a sales receipt using its current sync token" + }, + { + "name": "Create Customer Payment", + "description": "Record a customer payment with optional bounded invoice allocations" + }, + { + "name": "Update Customer Payment", + "description": "Sparse-update a customer payment using its current sync token" + }, + { + "name": "Void Customer Payment", + "description": "Void a customer payment after explicit confirmation" + }, + { + "name": "Create Credit Memo", + "description": "Create a customer credit memo with bounded sales lines" + }, + { + "name": "Update Credit Memo", + "description": "Sparse-update a credit memo using its current sync token" + }, + { + "name": "Create Refund Receipt", + "description": "Create a customer refund receipt against a required deposit account" + }, + { + "name": "Update Refund Receipt", + "description": "Sparse-update a refund receipt using its current sync token" + }, + { + "name": "Read Purchasing Transactions", + "description": "List or read one purchase order, bill, bill payment, vendor credit, or purchase" + }, + { + "name": "Create Purchase Order", + "description": "Create a purchase order with bounded expense lines" + }, + { + "name": "Update Purchase Order", + "description": "Sparse-update purchase-order header fields using the current sync token" + }, + { + "name": "Create Bill", + "description": "Create a vendor bill with optional Purchase Order line links without paying it" + }, + { + "name": "Update Bill", + "description": "Sparse-update bill header fields using its vendor and current sync token" + }, + { + "name": "Create Bill Payment", + "description": "Record a check or credit-card payment allocated to one or more bills" + }, + { + "name": "Update Bill Payment", + "description": "Sparse-update BillPayment date or note without changing allocations or payment accounts" + }, + { + "name": "Create Vendor Credit", + "description": "Create a vendor credit without applying it to a bill" + }, + { + "name": "Update Vendor Credit", + "description": "Sparse-update vendor-credit header fields using its vendor and current sync token" + }, + { + "name": "Create Purchase or Expense", + "description": "Record a cash, check, or credit-card purchase with bounded expense lines" + }, + { + "name": "Update Purchase or Expense", + "description": "Sparse-update purchase header fields without changing lines or payment accounts" + }, + { + "name": "Read Accounting Transactions", + "description": "List or read one journal entry, deposit, or transfer" + }, + { + "name": "Create Journal Entry", + "description": "Post a balanced journal entry after explicit confirmation" + }, + { + "name": "Update Journal Entry", + "description": "Sparse-update journal-entry header fields after explicit confirmation" + }, + { + "name": "Create Deposit", + "description": "Create a deposit with bounded account lines" + }, + { + "name": "Update Deposit", + "description": "Sparse-update deposit header fields using the current sync token and destination account" + }, + { + "name": "Run Financial Report", + "description": "Run a fixed QuickBooks financial report with verified accountant-focused filters" + }, + { + "name": "Email Transaction", + "description": "Send a supported QuickBooks transaction by email. This causes an external email and Intuit limits sandbox email delivery." + }, + { + "name": "Download Transaction PDF", + "description": "Download a supported QuickBooks transaction as a bounded PDF file" + }, + { + "name": "Read Attachments", + "description": "List attachment metadata for a fixed QuickBooks entity or read one attachment by ID" + }, + { + "name": "Add Attachment", + "description": "Attach one supported file or one note to a fixed QuickBooks entity" + }, + { + "name": "Download Attachment", + "description": "Download a QuickBooks file attachment through its short-lived URL" + } + ], + "operationCount": 47, + "triggers": [], + "triggerCount": 0, + "authType": "oauth", + "oauthServiceId": "quickbooks", + "category": "tools", + "integrationType": "commerce", + "tags": ["payments", "automation", "data-analytics"] + }, { "type": "quiver", "slug": "quiver", diff --git a/apps/sim/lib/oauth/oauth.test.ts b/apps/sim/lib/oauth/oauth.test.ts index 6211943de41..f3f412f4636 100644 --- a/apps/sim/lib/oauth/oauth.test.ts +++ b/apps/sim/lib/oauth/oauth.test.ts @@ -1,4 +1,4 @@ -import { createMockFetch, resetEnvMock, setEnv } from '@sim/testing' +import { createMockFetch, loggerMock, resetEnvMock, setEnv } from '@sim/testing' import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest' beforeAll(() => { @@ -39,6 +39,8 @@ beforeAll(() => { ASANA_CLIENT_SECRET: 'asana_client_secret', PIPEDRIVE_CLIENT_ID: 'pipedrive_client_id', PIPEDRIVE_CLIENT_SECRET: 'pipedrive_client_secret', + QUICKBOOKS_CLIENT_ID: 'quickbooks_client_id', + QUICKBOOKS_CLIENT_SECRET: 'quickbooks_client_secret', HUBSPOT_CLIENT_ID: 'hubspot_client_id', HUBSPOT_CLIENT_SECRET: 'hubspot_client_secret', LINKEDIN_CLIENT_ID: 'linkedin_client_id', @@ -86,6 +88,20 @@ function withMockFetch(mockFetch: ReturnType, fn: () => Promise }) } +/** + * Every `logger.error(...)` argument list recorded by the `OAuth` logger instance + * created in `lib/oauth/oauth.ts`. + */ +function oauthLoggerErrorCalls(): unknown[][] { + const createLogger = vi.mocked(loggerMock.createLogger) + return createLogger.mock.calls.flatMap((call, index) => + call[0] === 'OAuth' + ? (createLogger.mock.results[index]?.value as { error: { mock: { calls: unknown[][] } } }) + .error.mock.calls + : [] + ) +} + describe('OAuth Token Refresh', () => { describe('Basic Auth Providers', () => { const basicAuthProviders = [ @@ -107,6 +123,11 @@ describe('OAuth Token Refresh', () => { providerId: 'reddit', endpoint: 'https://www.reddit.com/api/v1/access_token', }, + { + name: 'QuickBooks', + providerId: 'quickbooks', + endpoint: 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer', + }, { name: 'Asana', providerId: 'asana', @@ -382,13 +403,91 @@ describe('OAuth Token Refresh', () => { } }) - it.concurrent('should return failure for Slack-style body errors', async () => { - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - status: 200, - statusText: 'OK', - json: async () => ({ ok: false, error: 'invalid_refresh_token' }), + it.concurrent('should not expose provider error details or refresh tokens', async () => { + const sensitiveDetail = 'provider-secret-account-detail' + const refreshToken = 'sensitive-refresh-token' + const mockFetch = vi.fn().mockResolvedValue( + Response.json( + { + error: 'invalid_grant', + error_description: sensitiveDetail, + }, + { status: 400 } + ) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', refreshToken) + ) + + expect(result).toEqual({ + ok: false, + errorCode: 'invalid_grant', + message: 'Failed to refresh token: 400 (invalid_grant)', }) + expect(JSON.stringify(result)).not.toContain(sensitiveDetail) + expect(JSON.stringify(result)).not.toContain(refreshToken) + }) + + it.concurrent( + 'should log the provider error body without leaking it to the caller', + async () => { + const errorBody = 'Token has been expired or revoked.' + const refreshToken = 'sensitive-refresh-token' + const mockFetch = vi + .fn() + .mockResolvedValue(new Response(errorBody, { status: 400, statusText: 'Bad Request' })) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('google', refreshToken) + ) + + expect(result).toEqual({ ok: false, message: 'Failed to refresh token: 400' }) + expect(JSON.stringify(result)).not.toContain(errorBody) + + const loggedBodies = oauthLoggerErrorCalls().map( + (call) => (call[1] as { errorBody?: string } | undefined)?.errorBody + ) + expect(loggedBodies).toContain(errorBody) + } + ) + + it.concurrent('should not fail a successful refresh with an oversized body', async () => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_access_token', + expires_in: 3600, + padding: 'x'.repeat(DEFAULT_MAX_ERROR_BODY_BYTES), + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', 'old_refresh_token') + ) + + expect(result).toMatchObject({ ok: true, accessToken: 'new_access_token', expiresIn: 3600 }) + }) + + it.concurrent('should redact credentials echoed back in a provider error body', async () => { + const mockFetch = vi.fn().mockResolvedValue( + new Response(`{"error":"invalid_grant","refresh_token":"leaked-refresh-token"}`, { + status: 400, + }) + ) + + await withMockFetch(mockFetch, () => refreshOAuthToken('google', 'leaked-refresh-token')) + + const loggedBodies = oauthLoggerErrorCalls().map( + (call) => (call[1] as { errorBody?: string } | undefined)?.errorBody ?? '' + ) + expect(loggedBodies.some((body) => body.includes('invalid_grant'))).toBe(true) + expect(loggedBodies.some((body) => body.includes('leaked-refresh-token'))).toBe(false) + }) + + it.concurrent('should return failure for Slack-style body errors', async () => { + const mockFetch = vi + .fn() + .mockResolvedValue(Response.json({ ok: false, error: 'invalid_refresh_token' })) const refreshToken = 'test_refresh_token' const result = await withMockFetch(mockFetch, () => refreshOAuthToken('slack', refreshToken)) @@ -410,18 +509,82 @@ describe('OAuth Token Refresh', () => { }) describe('Token Response Handling', () => { + it.concurrent( + 'should preserve QuickBooks one-hour expiry and rotating refresh token', + async () => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_quickbooks_access_token', + expires_in: 3600, + refresh_token: 'rotated_quickbooks_refresh_token', + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', 'old_quickbooks_refresh_token') + ) + + expect(result).toEqual({ + ok: true, + accessToken: 'new_quickbooks_access_token', + expiresIn: 3600, + refreshToken: 'rotated_quickbooks_refresh_token', + }) + } + ) + + it.concurrent('should preserve numeric string token expiry values', async () => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_access_token', + expires_in: '7200', + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('google', 'old_refresh_token') + ) + + expect(result).toEqual({ + ok: true, + accessToken: 'new_access_token', + expiresIn: 7200, + refreshToken: 'old_refresh_token', + }) + }) + + it.concurrent.each([0, -1, '0', '-1'])( + 'should fall back when token expiry is not positive: %s', + async (expiresIn) => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_access_token', + expires_in: expiresIn, + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('google', 'old_refresh_token') + ) + + expect(result).toMatchObject({ + ok: true, + expiresIn: 3600, + }) + } + ) + it.concurrent('should handle providers that return new refresh tokens', async () => { const refreshToken = 'old_refresh_token' const newRefreshToken = 'new_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, refresh_token: newRefreshToken, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('airtable', refreshToken) @@ -453,14 +616,13 @@ describe('OAuth Token Refresh', () => { const rotatedRefreshToken = 'rotated_microsoft_refresh_token' for (const providerId of microsoftProviders) { - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, refresh_token: rotatedRefreshToken, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken(providerId, oldRefreshToken) @@ -479,13 +641,12 @@ describe('OAuth Token Refresh', () => { it.concurrent('should use original refresh token when new one is not provided', async () => { const refreshToken = 'original_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) @@ -500,12 +661,11 @@ describe('OAuth Token Refresh', () => { it.concurrent('should return failure when access token is missing', async () => { const refreshToken = 'test_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ expires_in: 3600, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) @@ -515,12 +675,9 @@ describe('OAuth Token Refresh', () => { it.concurrent('should use default expiration when not provided', async () => { const refreshToken = 'test_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ - access_token: 'new_access_token', - }), - }) + const mockFetch = vi + .fn() + .mockResolvedValue(Response.json({ access_token: 'new_access_token' })) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) diff --git a/apps/sim/lib/oauth/oauth.ts b/apps/sim/lib/oauth/oauth.ts index 2cd452358d0..c72f9521bb0 100644 --- a/apps/sim/lib/oauth/oauth.ts +++ b/apps/sim/lib/oauth/oauth.ts @@ -43,6 +43,7 @@ import { NotionIcon, OutlookIcon, PipedriveIcon, + QuickBooksIcon, RedditIcon, SalesforceIcon, ShopifyIcon, @@ -60,6 +61,7 @@ import { } from '@/components/icons' import { env } from '@/lib/core/config/env' import { isSlackExtendedScopesEnabled } from '@/lib/core/config/env-flags' +import { redactSensitiveValues } from '@/lib/core/security/redaction' import { DEFAULT_MAX_ERROR_BODY_BYTES, readResponseTextWithLimit, @@ -69,6 +71,9 @@ import type { OAuthProviderConfig } from './types' const logger = createLogger('OAuth') +/** Upper bound on how much of a provider error body is written to the log. */ +const MAX_LOGGED_ERROR_BODY_CHARS = 1000 + /** * Slack scopes requested only where the app is approved for them, gated by * {@link isSlackExtendedScopesEnabled}. Slack rejects the entire authorization @@ -1010,6 +1015,22 @@ export const OAUTH_PROVIDERS: Record = { }, defaultService: 'pipedrive', }, + quickbooks: { + name: 'QuickBooks', + icon: QuickBooksIcon, + services: { + quickbooks: { + name: 'QuickBooks', + description: + 'Access company data and manage customers, vendors, and items in QuickBooks Online.', + providerId: 'quickbooks', + icon: QuickBooksIcon, + baseProviderIcon: QuickBooksIcon, + scopes: ['openid', 'profile', 'email', 'com.intuit.quickbooks.accounting'], + }, + }, + defaultService: 'quickbooks', + }, hubspot: { name: 'HubSpot', icon: HubspotIcon, @@ -1532,6 +1553,19 @@ function getProviderAuthConfig(provider: string): ProviderAuthConfig { supportsRefreshTokenRotation: true, } } + case 'quickbooks': { + const { clientId, clientSecret } = getCredentials( + env.QUICKBOOKS_CLIENT_ID, + env.QUICKBOOKS_CLIENT_SECRET + ) + return { + tokenEndpoint: 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer', + clientId, + clientSecret, + useBasicAuth: true, + supportsRefreshTokenRotation: true, + } + } case 'hubspot': { const { clientId, clientSecret } = getCredentials( env.HUBSPOT_CLIENT_ID, @@ -1848,42 +1882,70 @@ export async function refreshOAuthToken( }) if (!response.ok) { - const errorText = await response.text() - let errorData: unknown = errorText - + /** + * Read the failure body defensively: the cap bounds memory, and a read + * failure degrades to an empty diagnostic rather than replacing the real + * HTTP status with a stream error. + */ + const errorText = await readResponseTextWithLimit(response, { + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, + label: `${provider} token refresh error response`, + }).catch(() => '') + let errorData: unknown = null try { errorData = JSON.parse(errorText) - } catch (_e) { - // Not JSON, keep as text + } catch { + errorData = null } + const errorCode = extractErrorCode(errorData) + /** + * `@sim/logger` performs no redaction, so the provider body is redacted and + * truncated here. It is deliberately kept out of the returned message, which + * is surfaced to users and persisted in workflow execution logs. + */ logger.error('Token refresh failed:', { status: response.status, statusText: response.statusText, - error: errorText, - parsedError: errorData, + errorCode, + errorBody: truncate(redactSensitiveValues(errorText), MAX_LOGGED_ERROR_BODY_CHARS), providerId, tokenEndpoint: config.tokenEndpoint, hasClientId: !!config.clientId, hasClientSecret: !!config.clientSecret, hasRefreshToken: !!refreshToken, - refreshTokenPrefix: refreshToken ? `${refreshToken.substring(0, 10)}...` : 'none', }) return { ok: false, - errorCode: extractErrorCode(errorData), - message: `Failed to refresh token: ${response.status} ${errorText}`, + errorCode, + message: `Failed to refresh token: ${response.status}${errorCode ? ` (${errorCode})` : ''}`, } } - const data = await response.json() + /** + * Parsed uncapped on the success path. A token response is a small JSON + * document, and `readResponseTextWithLimit` throws rather than truncating — + * capping here would let an oversized body turn a successful refresh into a + * spurious failure. + */ + const responseData: unknown = await response.json().catch(() => null) + + if (!responseData || typeof responseData !== 'object' || Array.isArray(responseData)) { + logger.error('Token refresh returned an invalid response:', { + status: response.status, + providerId, + tokenEndpoint: config.tokenEndpoint, + }) + return { ok: false, message: 'Token refresh returned an invalid response' } + } + const data = responseData as Record - if (data && typeof data === 'object' && data.ok === false) { + if (data.ok === false) { + const providerErrorCode = extractErrorCode(data) logger.error('Token refresh failed:', { status: response.status, statusText: response.statusText, - error: data.error, - parsedError: data, + errorCode: providerErrorCode, providerId, tokenEndpoint: config.tokenEndpoint, hasClientId: !!config.clientId, @@ -1892,20 +1954,28 @@ export async function refreshOAuthToken( }) return { ok: false, - errorCode: typeof data.error === 'string' ? data.error : undefined, - message: `Failed to refresh token: ${data.error ?? 'unknown'}`, + errorCode: providerErrorCode, + message: `Failed to refresh token${providerErrorCode ? `: ${providerErrorCode}` : ''}`, } } - const accessToken = data.access_token + const accessToken = typeof data.access_token === 'string' ? data.access_token : null let newRefreshToken = null - if (config.supportsRefreshTokenRotation && data.refresh_token) { + if (config.supportsRefreshTokenRotation && typeof data.refresh_token === 'string') { newRefreshToken = data.refresh_token logger.info(`Received new refresh token from ${provider}`) } - const expiresIn = data.expires_in || data.expiresIn || 3600 + const expiresInCandidate = data.expires_in ?? data.expiresIn + const parsedExpiresIn = + typeof expiresInCandidate === 'number' + ? expiresInCandidate + : typeof expiresInCandidate === 'string' && expiresInCandidate.trim() + ? Number(expiresInCandidate) + : Number.NaN + const expiresIn = + Number.isFinite(parsedExpiresIn) && parsedExpiresIn > 0 ? parsedExpiresIn : 3600 if (!accessToken) { // Log only the shape, never `data` itself - on a partial success it can diff --git a/apps/sim/lib/oauth/quickbooks.ts b/apps/sim/lib/oauth/quickbooks.ts new file mode 100644 index 00000000000..9b0550f2933 --- /dev/null +++ b/apps/sim/lib/oauth/quickbooks.ts @@ -0,0 +1,152 @@ +import { AsyncLocalStorage } from 'node:async_hooks' +import { generateId } from '@sim/utils/id' +import { + readResponseJsonWithLimit, + readResponseTextWithLimit, +} from '@/lib/core/utils/stream-limits' +import { + fetchValidatedQuickBooksCompanyInfo, + getQuickBooksUserInfoUrl, + normalizeQuickBooksRealmId as normalizeRealmId, + QUICKBOOKS_MAX_USER_INFO_BYTES, + QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS, +} from '@/tools/quickbooks/client' + +const QUICKBOOKS_ACCOUNT_PREFIX = 'quickbooks:' +const UUID_SUFFIX_PATTERN = + /-([0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$/i +const quickBooksCallbackRealmStorage = new AsyncLocalStorage() + +export const QUICKBOOKS_AUTHORIZATION_URL = 'https://appcenter.intuit.com/connect/oauth2' +export const QUICKBOOKS_TOKEN_URL = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer' +export const QUICKBOOKS_OIDC_CLAIMS = { + id_token: { realmId: null }, + userinfo: { realmId: null }, +} as const + +export interface QuickBooksAccountIdentity { + realmId: string + subject: string +} + +export interface QuickBooksConnectionProfile extends QuickBooksAccountIdentity { + accountId: string + name: string + email: string + emailVerified: boolean +} + +export const normalizeQuickBooksRealmId = normalizeRealmId + +export function withQuickBooksCallbackRealm(realmId: string, callback: () => T): T { + return quickBooksCallbackRealmStorage.run(normalizeQuickBooksRealmId(realmId), callback) +} + +export function getQuickBooksCallbackRealm(): string { + const realmId = quickBooksCallbackRealmStorage.getStore() + if (!realmId) { + throw new Error( + 'QuickBooks callback did not include a company identity. Reconnect the QuickBooks credential.' + ) + } + return realmId +} + +function normalizeSubject(subject: string): string { + const normalized = subject.trim() + if (!normalized || normalized.includes(':')) { + throw new Error('QuickBooks user identity is invalid. Reconnect the QuickBooks credential.') + } + return normalized +} + +export function createQuickBooksAccountId( + realmId: string, + subject: string, + uniqueId = generateId() +): string { + return `${QUICKBOOKS_ACCOUNT_PREFIX}${normalizeQuickBooksRealmId(realmId)}:${normalizeSubject(subject)}-${uniqueId}` +} + +export function parseQuickBooksAccountId(accountId: string): QuickBooksAccountIdentity { + if (!accountId.startsWith(QUICKBOOKS_ACCOUNT_PREFIX)) { + throw new Error('QuickBooks company identity is missing. Reconnect the QuickBooks credential.') + } + + const value = accountId.slice(QUICKBOOKS_ACCOUNT_PREFIX.length) + const separatorIndex = value.indexOf(':') + if (separatorIndex <= 0) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + + const realmId = normalizeQuickBooksRealmId(value.slice(0, separatorIndex)) + const subjectWithUuid = value.slice(separatorIndex + 1) + const uuidMatch = subjectWithUuid.match(UUID_SUFFIX_PATTERN) + if (!uuidMatch) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + + const subject = normalizeSubject(subjectWithUuid.slice(0, -uuidMatch[0].length)) + return { realmId, subject } +} + +export async function fetchQuickBooksConnectionProfile( + accessToken: string, + callbackRealmId: string +): Promise { + const realmId = normalizeQuickBooksRealmId(callbackRealmId) + const response = await fetch(getQuickBooksUserInfoUrl(), { + headers: { Authorization: `Bearer ${accessToken}` }, + signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), + }) + if (!response.ok) { + await readResponseTextWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + label: 'QuickBooks UserInfo error response', + }).catch(() => {}) + throw new Error(`QuickBooks UserInfo request failed with HTTP ${response.status}`) + } + + const profile = await readResponseJsonWithLimit<{ + sub?: string + realmId?: string + realmid?: string + name?: string + givenName?: string + familyName?: string + given_name?: string + family_name?: string + email?: string + emailVerified?: boolean + email_verified?: boolean + }>(response, { + maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + label: 'QuickBooks UserInfo response', + }) + + const subject = profile.sub?.trim() + const claimedRealmId = (profile.realmId ?? profile.realmid)?.trim() + const email = profile.email?.trim() + const givenName = (profile.givenName ?? profile.given_name)?.trim() + const familyName = (profile.familyName ?? profile.family_name)?.trim() + const name = profile.name?.trim() || [givenName, familyName].filter(Boolean).join(' ') + const emailVerified = profile.emailVerified ?? profile.email_verified ?? false + + if (!subject || !email || !name) { + throw new Error('QuickBooks UserInfo did not return the required user identity') + } + if (claimedRealmId && normalizeQuickBooksRealmId(claimedRealmId) !== realmId) { + throw new Error('QuickBooks callback and UserInfo returned different company identities') + } + + await fetchValidatedQuickBooksCompanyInfo(accessToken, realmId) + + return { + accountId: createQuickBooksAccountId(realmId, subject), + realmId, + subject: normalizeSubject(subject), + name, + email, + emailVerified, + } +} diff --git a/apps/sim/lib/oauth/types.ts b/apps/sim/lib/oauth/types.ts index 4a036e17dbe..d77cfa292f5 100644 --- a/apps/sim/lib/oauth/types.ts +++ b/apps/sim/lib/oauth/types.ts @@ -75,6 +75,7 @@ export type OAuthProvider = | 'asana' | 'attio' | 'pipedrive' + | 'quickbooks' | 'hubspot' | 'salesforce' | 'linkedin' @@ -130,6 +131,7 @@ export type OAuthService = | 'asana' | 'attio' | 'pipedrive' + | 'quickbooks' | 'hubspot' | 'salesforce' | 'linkedin' diff --git a/apps/sim/lib/oauth/utils.test.ts b/apps/sim/lib/oauth/utils.test.ts index acc0945270e..bc5e438c04e 100644 --- a/apps/sim/lib/oauth/utils.test.ts +++ b/apps/sim/lib/oauth/utils.test.ts @@ -71,6 +71,11 @@ describe('getAllOAuthServices', () => { expect(slackService).toBeDefined() expect(slackService?.name).toBe('Slack') expect(slackService?.baseProvider).toBe('slack') + + const quickbooksService = services.find((s) => s.providerId === 'quickbooks') + expect(quickbooksService).toBeDefined() + expect(quickbooksService?.name).toBe('QuickBooks') + expect(quickbooksService?.baseProvider).toBe('quickbooks') }) it.concurrent('should not include duplicate services', () => { @@ -252,6 +257,14 @@ describe('getServiceConfigByProviderId', () => { expect(service?.name).toBe('Slack') }) + it.concurrent('should work for QuickBooks', () => { + const service = getServiceConfigByProviderId('quickbooks') + + expect(service).toBeDefined() + expect(service?.providerId).toBe('quickbooks') + expect(service?.name).toBe('QuickBooks') + }) + it.concurrent('should return service with scopes', () => { const service = getServiceConfigByProviderId('google-drive') @@ -346,6 +359,13 @@ describe('getCanonicalScopesForProvider', () => { expect(excelScopes).toContain('Files.Read') }) + it.concurrent('should return the exact canonical QuickBooks scopes', () => { + const expected = ['openid', 'profile', 'email', 'com.intuit.quickbooks.accounting'] + + expect(getCanonicalScopesForProvider('quickbooks')).toEqual(expected) + expect(getScopesForService('quickbooks')).toEqual(expected) + }) + it.concurrent('should handle providers with empty scopes array', () => { const scopes = getCanonicalScopesForProvider('notion') diff --git a/apps/sim/lib/oauth/utils.ts b/apps/sim/lib/oauth/utils.ts index b0df084e0c4..326d07778dd 100644 --- a/apps/sim/lib/oauth/utils.ts +++ b/apps/sim/lib/oauth/utils.ts @@ -95,6 +95,8 @@ export const SCOPE_DESCRIPTIONS: Record = { openid: 'Standard authentication', profile: 'Access profile information', email: 'Access email address', + 'com.intuit.quickbooks.accounting': + 'Access and manage accounting data in the connected QuickBooks Online company', // Notion scopes 'database.read': 'Read database', diff --git a/apps/sim/lib/uploads/store-tool-output-file.ts b/apps/sim/lib/uploads/store-tool-output-file.ts new file mode 100644 index 00000000000..8464aa2bacc --- /dev/null +++ b/apps/sim/lib/uploads/store-tool-output-file.ts @@ -0,0 +1,46 @@ +import { uploadCopilotFile } from '@/lib/uploads/contexts/copilot' +import { uploadExecutionFile } from '@/lib/uploads/contexts/execution' +import type { UserFile } from '@/executor/types' + +/** + * Execution coordinates as they arrive from a tool request body. All three are + * required together; a partial context falls back to copilot storage. + */ +export interface ToolOutputExecutionContext { + workspaceId?: string | null + workflowId?: string | null + executionId?: string | null +} + +export interface StoreToolOutputFileInput { + buffer: Buffer + fileName: string + contentType: string + userId: string + context?: ToolOutputExecutionContext +} + +/** + * Persists a file produced by a tool route. Files created during a workflow run + * go to the execution store so they expire with the run; everything else goes to + * the caller's copilot store. + */ +export async function storeToolOutputFile({ + buffer, + fileName, + contentType, + userId, + context, +}: StoreToolOutputFileInput): Promise { + const { workspaceId, workflowId, executionId } = context ?? {} + if (workspaceId && workflowId && executionId) { + return uploadExecutionFile( + { workspaceId, workflowId, executionId }, + buffer, + fileName, + contentType, + userId + ) + } + return uploadCopilotFile({ buffer, fileName, contentType, userId }) +} diff --git a/apps/sim/scripts/quickbooks-sparse-probe.md b/apps/sim/scripts/quickbooks-sparse-probe.md new file mode 100644 index 00000000000..faa15f91ec2 --- /dev/null +++ b/apps/sim/scripts/quickbooks-sparse-probe.md @@ -0,0 +1,146 @@ +# QuickBooks sparse-update probe + +## The question + +Ten update tools in this PR send `sparse: true` to entities whose Intuit developer-docs +pages carry **no** "Sparse update" section: + +`CreditMemo`, `Payment`, `Bill`, `BillPayment`, `VendorCredit`, `Purchase`, +`PurchaseOrder`, `Vendor`, `Employee`, `Item`. + +Each of those pages states the full-update contract verbatim: + +> The request body must include all writable fields of the existing object as returned in +> a read response. Writable fields omitted from the request body are set to NULL. + +If QuickBooks honors `sparse` anyway, the missing doc section is a docs-only nit. If it +ignores `sparse` and applies full-update semantics, these tools **silently NULL fields in +customers' accounting books** — a partial update sends only the handful of fields the user +edited, so everything else is wiped. + +## Why it blocks the PR + +The evidence is genuinely mixed, and neither side can be assumed: + +- **Purchase is confirmed broken.** An Intuit support thread reports the structurally + identical body returning `SystemFault`: + + — *"The variables input contains a field name 'sparse' that is not defined for input + object type 'Commerce_V3Properties'"*. That same thread says **"This same request was + working previously"**, so the server behavior **changed**. A passing probe today does + not guarantee stability; re-run before each release that touches these tools. +- **The docs inventory does not predict behavior.** That thread also names `Deposit`, + which *does* have a documented sparse section and is reported failing anyway. +- **Absence of a section is sometimes just a docs gap.** The `Payment` page's prose says + *"A Payment can be updated as a full update or a sparse update"* while the page carries + no sparse heading at all. + +So the only way to settle this is to ask the server. + +## Getting sandbox credentials + +1. Sign in at and open your app under **My Hub → Apps**. +2. **Keys & credentials → Development** gives you the client id and secret. Development + keys only ever reach the sandbox host. +3. **Sandboxes** (under your developer account) lists your sandbox companies. The + **Company ID** shown there is the `realmId`. +4. Open the **OAuth 2.0 Playground** (Tools → OAuth 2.0 Playground), pick your app, select + the `com.intuit.quickbooks.accounting` scope, authorize against the sandbox company, and + copy the **access token** (valid 1 hour) and/or the **refresh token** (valid 100 days). + +The sandbox company must have its default seed data — the probe resolves a Bank, Expense, +Income and Accounts Payable account plus a Customer, Vendor and Service Item by query, and +fails with a clear message if any is missing. + +## Running it + +```bash +QUICKBOOKS_ENV=sandbox \ +QUICKBOOKS_REALM_ID= \ +QUICKBOOKS_ACCESS_TOKEN= \ + bun run apps/sim/scripts/quickbooks-sparse-probe.ts +``` + +Or let it mint its own access token from a refresh token: + +```bash +QUICKBOOKS_ENV=sandbox \ +QUICKBOOKS_REALM_ID= \ +QUICKBOOKS_REFRESH_TOKEN= \ +QUICKBOOKS_CLIENT_ID= \ +QUICKBOOKS_CLIENT_SECRET= \ + bun run apps/sim/scripts/quickbooks-sparse-probe.ts +``` + +Missing variables are reported by name before anything else happens. Never commit a token. + +### Sandbox only — no override + +The script **creates and mutates real accounting records**. It refuses to run unless +`QUICKBOOKS_ENV=sandbox` *and* the resolved API host is `sandbox-quickbooks.api.intuit.com` +— two independent checks, so one mis-set variable cannot arm it against a live company. +There is no bypass flag and none should be added. Pointing it at a production realm would +write junk transactions into a customer's books and, if `sparse` really is ignored, destroy +writable fields on every record it touches. + +### What it does per entity + +`Purchase` runs **first**, deliberately: it is the known-bad case, so if the harness does +not reproduce a failure there, the harness itself is suspect and no other result should be +trusted. `Deposit` and `Invoice` follow as controls — `Deposit` is documented yet reported +failing, `Invoice` is documented and expected to work. + +For each entity the script: creates a record with several populated writable fields +(including a multi-line `Line` array where the entity has one) → reads it back and logs the +full payload and `SyncToken` → POSTs +`{"Id":…, "SyncToken":…, "sparse":true, "":"probe"}` → reads it back +again → classifies. + +### Cleanup + +Transactions are deleted via `?operation=delete` in reverse creation order (so a +`BillPayment` is removed before the `Bill` it pays). **QuickBooks cannot delete name-list +entities**, so the `Vendor`, `Employee` and `Item` the probe creates are left behind and +printed under `MANUAL CLEANUP REQUIRED` — deactivate them by hand in the sandbox UI. +Anything that failed to delete is listed there too. + +## Reading the results + +The run prints an entity → classification table and exits non-zero if anything classifies +as `SPARSE_IGNORED_DATA_LOSS`. + +| Classification | What the server did | What it means for the tool | +| --- | --- | --- | +| `SPARSE_HONORED` | 200; the probe field changed and `Line` plus every other writable field is intact | `sparse: true` works. Docs-only nit — the tool is correct as written. | +| `SPARSE_IGNORED_DATA_LOSS` | 200, but `Line` emptied or other writable fields nulled | **Ship-blocker.** The tool silently destroys customer data. | +| `SPARSE_REJECTED` | 4xx / `SystemFault` | The tool is non-functional but loses no data. Ship-blocker for functionality, not for safety. | +| `INCONCLUSIVE` | anything else — non-200 non-4xx, probe field not applied, or fields that changed value without being dropped | Read the raw response the script prints and judge by hand. Do not treat as a pass. | + +Note on the classifier: fields **dropped** (present before, absent or null after) and a +**shrunken `Line` array** are the data-loss signature. Fields that merely changed value are +reported as `INCONCLUSIVE` rather than blocking, because QuickBooks recomputes some derived +amounts on every save — check those by eye. + +## What each outcome implies for the code + +Per entity, apply whichever row its classification lands on: + +- **`SPARSE_HONORED`** — leave the update tool as-is. Optionally note in a code comment that + the entity's sparse support is undocumented but empirically verified, with the date the + probe ran, since the Purchase thread proves this behavior can change under you. +- **`SPARSE_IGNORED_DATA_LOSS`** — remove `sparse: true` and convert that tool to a genuine + read-modify-write: GET the entity, merge the user's edits over the full read payload, + then POST the complete object with the fresh `SyncToken`. Nothing may ship for that entity + until this is done. +- **`SPARSE_REJECTED`** — same fix as above (full read-modify-write), for a different reason: + the request never succeeds at all, so the tool is dead in the water. Data is safe in the + meantime, so this can be sequenced after the data-loss cases if triage is needed. +- **`INCONCLUSIVE`** — do not ship that entity on an inconclusive result. Inspect the raw + request/response the script printed, adjust the probe payload if the entity needed a field + the probe did not supply, and re-run. + +Expected baselines when interpreting a run: `Invoice` should come back `SPARSE_HONORED` +(documented, and the control for "the harness works"). `Purchase` is expected to be +`SPARSE_REJECTED` per the support thread — if it comes back `SPARSE_HONORED`, that is not +automatically good news, it means the server behavior moved again and every other result in +the same run is only a point-in-time snapshot. diff --git a/apps/sim/scripts/quickbooks-sparse-probe.ts b/apps/sim/scripts/quickbooks-sparse-probe.ts new file mode 100644 index 00000000000..1a64c5f22e3 --- /dev/null +++ b/apps/sim/scripts/quickbooks-sparse-probe.ts @@ -0,0 +1,1036 @@ +#!/usr/bin/env bun + +/** + * Empirical probe for whether the QuickBooks Online API honors `sparse: true` on the + * ten entities whose developer-docs pages carry NO "Sparse update" section. + * + * DANGER — SANDBOX ONLY. This script CREATES and MUTATES real accounting records in + * whatever company the supplied realm id points at. Running it against a production + * QuickBooks company would write junk transactions into a customer's books and, if + * `sparse` turns out to be ignored, would NULL writable fields on the records it + * touches. It therefore hard-requires `QUICKBOOKS_ENV=sandbox`, additionally asserts + * the resolved API host is the `sandbox-quickbooks.api.intuit.com` host, and refuses + * to run otherwise. There is no override flag and none may be added. + * + * The question it settles: ten update tools in this PR send `sparse: true` to + * CreditMemo, Payment, Bill, BillPayment, VendorCredit, Purchase, PurchaseOrder, + * Vendor, Employee, and Item. Every one of those doc pages states the full-update + * contract verbatim: "The request body must include all writable fields of the + * existing object as returned in a read response. Writable fields omitted from the + * request body are set to NULL." If the server honors `sparse` regardless, the + * missing doc section is a docs-only nit. If it ignores `sparse`, those tools + * silently destroy customer data. + * + * The evidence is genuinely mixed and this script deliberately does not prejudge it: + * - Purchase is CONFIRMED broken by an Intuit support thread reporting a + * structurally identical body returning SystemFault. That thread also says the + * same request "was working previously" — so behavior CHANGED and a passing + * probe today does not prove stability. + * - That same thread names Deposit, which DOES have a documented sparse section. + * The docs inventory therefore does not predict server behavior either way. + * - The Payment page's prose says a Payment "can be updated as a full update or a + * sparse update" while the page carries no sparse heading — absence of a section + * is sometimes only a docs gap. + * + * Purchase runs FIRST so the harness is validated against the known-bad case before + * any other result is trusted. Deposit and Invoice run as controls: Deposit is + * documented yet reported failing, Invoice is documented and expected to work. + * + * Per entity the probe: creates a record with several populated writable fields + * (including a multi-line `Line` array where the entity supports one), reads it + * back, POSTs `{Id, SyncToken, sparse: true, : "probe"}`, + * reads it back again, and classifies the outcome as SPARSE_HONORED, + * SPARSE_IGNORED_DATA_LOSS, SPARSE_REJECTED, or INCONCLUSIVE. + * + * Exits non-zero if any entity classifies as SPARSE_IGNORED_DATA_LOSS (the + * ship-blocker) or if the run fails outright. + * + * Required environment: + * QUICKBOOKS_ENV=sandbox (hard requirement) + * QUICKBOOKS_REALM_ID= + * plus EITHER: + * QUICKBOOKS_ACCESS_TOKEN= + * OR: + * QUICKBOOKS_REFRESH_TOKEN + QUICKBOOKS_CLIENT_ID + QUICKBOOKS_CLIENT_SECRET + * + * Usage: + * QUICKBOOKS_ENV=sandbox QUICKBOOKS_REALM_ID=... QUICKBOOKS_ACCESS_TOKEN=... \ + * bun run apps/sim/scripts/quickbooks-sparse-probe.ts + * + * See QUICKBOOKS_SPARSE_PROBE.md at the repo root for how to obtain sandbox + * credentials and how to act on each classification. + */ + +import { getErrorMessage } from '@sim/utils/errors' +import { generateShortId } from '@sim/utils/id' +import { + buildQuickBooksCompanyUrl, + buildQuickBooksHeaders, + getQuickBooksApiBaseUrl, + getQuickBooksEnvironment, + normalizeQuickBooksRealmId, +} from '@/tools/quickbooks/client' + +const SANDBOX_API_HOST = 'sandbox-quickbooks.api.intuit.com' +const OAUTH_TOKEN_URL = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer' +const REQUEST_TIMEOUT_MS = 30_000 + +/** The literal written into the probe field. Its presence after the POST proves the write landed. */ +const PROBE_VALUE = 'probe' + +/** + * Fields QuickBooks legitimately rewrites on every save. Differences here are never + * evidence of sparse being ignored. + */ +const VOLATILE_FIELDS: ReadonlySet = new Set([ + 'SyncToken', + 'MetaData', + 'sparse', + 'domain', + 'time', +]) + +type Classification = + | 'SPARSE_HONORED' + | 'SPARSE_IGNORED_DATA_LOSS' + | 'SPARSE_REJECTED' + | 'INCONCLUSIVE' + +type QboRecord = Record + +interface QboResponse { + status: number + ok: boolean + rawBody: string + json: QboRecord | null +} + +interface CompanyRefs { + bankAccountId: string + expenseAccountId: string + incomeAccountId: string + apAccountId: string + customerId: string + vendorId: string + itemId: string +} + +interface CreatedRecord { + entity: string + resource: string + id: string + /** Transactions accept `?operation=delete`; name-list entities (Vendor/Employee/Item) do not. */ + deletable: boolean +} + +interface ProbeSession { + accessToken: string + realmId: string + created: CreatedRecord[] +} + +interface EntitySpec { + /** Wire entity name as it appears in the response envelope, e.g. `Purchase`. */ + entity: string + /** Lowercase path segment, e.g. `purchase`. */ + resource: string + /** Whether the entity's docs page carries a "Sparse update" section. */ + docsSparseSection: 'documented' | 'undocumented' + /** One innocuous scalar writable field set to PROBE_VALUE by the sparse POST. */ + probeField: string + deletable: boolean + build: (session: ProbeSession, refs: CompanyRefs) => Promise +} + +interface EntityOutcome { + entity: string + docsSparseSection: 'documented' | 'undocumented' + classification: Classification + detail: string +} + +function isRecord(value: unknown): value is QboRecord { + return typeof value === 'object' && value !== null && !Array.isArray(value) +} + +function readString(record: QboRecord, key: string): string | null { + const value = record[key] + return typeof value === 'string' && value.trim() ? value : null +} + +function requireString(record: QboRecord, key: string, context: string): string { + const value = readString(record, key) + if (!value) throw new Error(`${context} is missing a "${key}" string`) + return value +} + +function lineCount(record: QboRecord): number | null { + const line = record.Line + return Array.isArray(line) ? line.length : null +} + +function today(): string { + return new Date().toISOString().slice(0, 10) +} + +/** + * Refuses to proceed unless the resolved environment AND the resolved API host both + * say sandbox. Two independent checks so a single mis-set variable cannot arm the + * script against a live company. + */ +function assertSandboxOnly(): void { + const environment = getQuickBooksEnvironment() + if (environment !== 'sandbox') { + throw new Error( + `REFUSING TO RUN: QUICKBOOKS_ENV is "${environment}". This script creates and mutates real accounting records and may destroy writable fields. It runs against sandbox companies only. There is no override.` + ) + } + const host = new URL(getQuickBooksApiBaseUrl()).host + if (host !== SANDBOX_API_HOST) { + throw new Error( + `REFUSING TO RUN: resolved QuickBooks API host is "${host}", expected "${SANDBOX_API_HOST}". There is no override.` + ) + } +} + +function requireEnvVars(): { realmId: string } { + const missing: string[] = [] + if (!process.env.QUICKBOOKS_ENV) missing.push('QUICKBOOKS_ENV (must be "sandbox")') + if (!process.env.QUICKBOOKS_REALM_ID) missing.push('QUICKBOOKS_REALM_ID') + + const hasAccessToken = Boolean(process.env.QUICKBOOKS_ACCESS_TOKEN) + const hasRefreshFlow = + Boolean(process.env.QUICKBOOKS_REFRESH_TOKEN) && + Boolean(process.env.QUICKBOOKS_CLIENT_ID) && + Boolean(process.env.QUICKBOOKS_CLIENT_SECRET) + + if (!hasAccessToken && !hasRefreshFlow) { + missing.push( + 'QUICKBOOKS_ACCESS_TOKEN (or all three of QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET)' + ) + } + + if (missing.length > 0) { + throw new Error(`Missing required environment variables:\n - ${missing.join('\n - ')}`) + } + + return { realmId: normalizeQuickBooksRealmId(process.env.QUICKBOOKS_REALM_ID as string) } +} + +async function resolveAccessToken(): Promise { + const direct = process.env.QUICKBOOKS_ACCESS_TOKEN?.trim() + if (direct) return direct + + const clientId = process.env.QUICKBOOKS_CLIENT_ID as string + const clientSecret = process.env.QUICKBOOKS_CLIENT_SECRET as string + const refreshToken = process.env.QUICKBOOKS_REFRESH_TOKEN as string + + const response = await fetch(OAUTH_TOKEN_URL, { + method: 'POST', + headers: { + Accept: 'application/json', + 'Content-Type': 'application/x-www-form-urlencoded', + Authorization: `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`, + }, + body: new URLSearchParams({ grant_type: 'refresh_token', refresh_token: refreshToken }), + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }) + + const rawBody = await response.text() + if (!response.ok) { + throw new Error(`QuickBooks token refresh failed with HTTP ${response.status}: ${rawBody}`) + } + + const parsed: unknown = JSON.parse(rawBody) + if (!isRecord(parsed)) throw new Error('QuickBooks token refresh returned a non-object body') + const accessToken = readString(parsed, 'access_token') + if (!accessToken) throw new Error('QuickBooks token refresh response has no access_token') + return accessToken +} + +async function qboRequest( + session: ProbeSession, + resource: string, + init: { method: 'GET' | 'POST'; body?: QboRecord; query?: Record } +): Promise { + const url = buildQuickBooksCompanyUrl(session.realmId, resource) + for (const [key, value] of Object.entries(init.query ?? {})) url.searchParams.set(key, value) + + const headers: Record = buildQuickBooksHeaders(session.accessToken) + if (init.body) headers['Content-Type'] = 'application/json' + + const response = await fetch(url, { + method: init.method, + headers, + body: init.body ? JSON.stringify(init.body) : undefined, + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }) + + const rawBody = await response.text() + let json: QboRecord | null = null + try { + const parsed: unknown = JSON.parse(rawBody) + if (isRecord(parsed)) json = parsed + } catch { + json = null + } + + return { status: response.status, ok: response.ok, rawBody, json } +} + +function extractEntity(response: QboResponse, entity: string): QboRecord { + const payload = response.json?.[entity] + if (!isRecord(payload)) { + throw new Error( + `QuickBooks response did not contain a "${entity}" object (HTTP ${response.status}): ${response.rawBody}` + ) + } + return payload +} + +async function queryFirstId( + session: ProbeSession, + statement: string, + entity: string +): Promise { + const response = await qboRequest(session, 'query', { + method: 'GET', + query: { query: statement }, + }) + if (!response.ok) { + throw new Error( + `QuickBooks query failed (HTTP ${response.status}) for "${statement}": ${response.rawBody}` + ) + } + const queryResponse = response.json?.QueryResponse + const rows = isRecord(queryResponse) ? queryResponse[entity] : undefined + if (!Array.isArray(rows) || rows.length === 0 || !isRecord(rows[0])) { + throw new Error( + `QuickBooks sandbox has no ${entity} matching "${statement}". Seed the sandbox company before probing.` + ) + } + return requireString(rows[0], 'Id', `${entity} query result`) +} + +async function resolveCompanyRefs(session: ProbeSession): Promise { + const [ + bankAccountId, + expenseAccountId, + incomeAccountId, + apAccountId, + customerId, + vendorId, + itemId, + ] = await Promise.all([ + queryFirstId( + session, + "select Id from Account where AccountType = 'Bank' maxresults 1", + 'Account' + ), + queryFirstId( + session, + "select Id from Account where AccountType = 'Expense' maxresults 1", + 'Account' + ), + queryFirstId( + session, + "select Id from Account where AccountType = 'Income' maxresults 1", + 'Account' + ), + queryFirstId( + session, + "select Id from Account where AccountType = 'Accounts Payable' maxresults 1", + 'Account' + ), + queryFirstId(session, 'select Id from Customer maxresults 1', 'Customer'), + queryFirstId(session, 'select Id from Vendor maxresults 1', 'Vendor'), + queryFirstId(session, "select Id from Item where Type = 'Service' maxresults 1", 'Item'), + ]) + + return { + bankAccountId, + expenseAccountId, + incomeAccountId, + apAccountId, + customerId, + vendorId, + itemId, + } +} + +/** Creates a record and registers it for cleanup. Returns the created entity payload. */ +async function createRecord( + session: ProbeSession, + entity: string, + resource: string, + body: QboRecord, + deletable: boolean +): Promise { + const response = await qboRequest(session, resource, { method: 'POST', body }) + if (!response.ok) { + throw new Error(`Failed to create ${entity} (HTTP ${response.status}): ${response.rawBody}`) + } + const created = extractEntity(response, entity) + const id = requireString(created, 'Id', `created ${entity}`) + session.created.push({ entity, resource, id, deletable }) + return created +} + +async function readRecord( + session: ProbeSession, + entity: string, + resource: string, + id: string +): Promise { + const response = await qboRequest(session, `${resource}/${encodeURIComponent(id)}`, { + method: 'GET', + }) + if (!response.ok) { + throw new Error(`Failed to read ${entity} ${id} (HTTP ${response.status}): ${response.rawBody}`) + } + return extractEntity(response, entity) +} + +function accountExpenseLine(amount: number, accountId: string, description: string): QboRecord { + return { + Amount: amount, + DetailType: 'AccountBasedExpenseLineDetail', + Description: description, + AccountBasedExpenseLineDetail: { AccountRef: { value: accountId } }, + } +} + +function salesItemLine(amount: number, itemId: string, description: string): QboRecord { + return { + Amount: amount, + DetailType: 'SalesItemLineDetail', + Description: description, + SalesItemLineDetail: { ItemRef: { value: itemId }, Qty: 1, UnitPrice: amount }, + } +} + +function probeTag(): string { + return `sim-sparse-probe-${generateShortId(8)}` +} + +const ENTITY_SPECS: readonly EntitySpec[] = [ + { + entity: 'Purchase', + resource: 'purchase', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'Purchase', + 'purchase', + { + PaymentType: 'Cash', + AccountRef: { value: refs.bankAccountId }, + EntityRef: { value: refs.vendorId, type: 'Vendor' }, + TxnDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + Line: [ + accountExpenseLine(11.11, refs.expenseAccountId, 'probe line one'), + accountExpenseLine(22.22, refs.expenseAccountId, 'probe line two'), + ], + }, + true + ), + }, + { + entity: 'Deposit', + resource: 'deposit', + docsSparseSection: 'documented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'Deposit', + 'deposit', + { + DepositToAccountRef: { value: refs.bankAccountId }, + TxnDate: today(), + PrivateNote: probeTag(), + Line: [ + { + Amount: 33.33, + DetailType: 'DepositLineDetail', + Description: 'probe line one', + DepositLineDetail: { AccountRef: { value: refs.incomeAccountId } }, + }, + { + Amount: 44.44, + DetailType: 'DepositLineDetail', + Description: 'probe line two', + DepositLineDetail: { AccountRef: { value: refs.incomeAccountId } }, + }, + ], + }, + true + ), + }, + { + entity: 'Invoice', + resource: 'invoice', + docsSparseSection: 'documented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'Invoice', + 'invoice', + { + CustomerRef: { value: refs.customerId }, + TxnDate: today(), + DueDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + CustomerMemo: { value: 'probe memo' }, + Line: [ + salesItemLine(55.55, refs.itemId, 'probe line one'), + salesItemLine(66.66, refs.itemId, 'probe line two'), + ], + }, + true + ), + }, + { + entity: 'CreditMemo', + resource: 'creditmemo', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'CreditMemo', + 'creditmemo', + { + CustomerRef: { value: refs.customerId }, + TxnDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + CustomerMemo: { value: 'probe memo' }, + Line: [ + salesItemLine(12.34, refs.itemId, 'probe line one'), + salesItemLine(23.45, refs.itemId, 'probe line two'), + ], + }, + true + ), + }, + { + entity: 'Payment', + resource: 'payment', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'Payment', + 'payment', + { + CustomerRef: { value: refs.customerId }, + TotalAmt: 77.77, + TxnDate: today(), + PaymentRefNum: generateShortId(8), + PrivateNote: probeTag(), + DepositToAccountRef: { value: refs.bankAccountId }, + }, + true + ), + }, + { + entity: 'Bill', + resource: 'bill', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'Bill', + 'bill', + { + VendorRef: { value: refs.vendorId }, + APAccountRef: { value: refs.apAccountId }, + TxnDate: today(), + DueDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + Line: [ + accountExpenseLine(31.31, refs.expenseAccountId, 'probe line one'), + accountExpenseLine(41.41, refs.expenseAccountId, 'probe line two'), + ], + }, + true + ), + }, + { + entity: 'BillPayment', + resource: 'billpayment', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => { + const bill = await createRecord( + session, + 'Bill', + 'bill', + { + VendorRef: { value: refs.vendorId }, + APAccountRef: { value: refs.apAccountId }, + TxnDate: today(), + DueDate: today(), + DocNumber: generateShortId(8), + PrivateNote: `${probeTag()}-billpayment-prereq`, + Line: [accountExpenseLine(50, refs.expenseAccountId, 'billpayment prerequisite')], + }, + true + ) + const billId = requireString(bill, 'Id', 'BillPayment prerequisite Bill') + + return createRecord( + session, + 'BillPayment', + 'billpayment', + { + VendorRef: { value: refs.vendorId }, + PayType: 'Check', + CheckPayment: { BankAccountRef: { value: refs.bankAccountId } }, + TotalAmt: 50, + TxnDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + Line: [{ Amount: 50, LinkedTxn: [{ TxnId: billId, TxnType: 'Bill' }] }], + }, + true + ) + }, + }, + { + entity: 'VendorCredit', + resource: 'vendorcredit', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'VendorCredit', + 'vendorcredit', + { + VendorRef: { value: refs.vendorId }, + APAccountRef: { value: refs.apAccountId }, + TxnDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + Line: [ + accountExpenseLine(13.13, refs.expenseAccountId, 'probe line one'), + accountExpenseLine(14.14, refs.expenseAccountId, 'probe line two'), + ], + }, + true + ), + }, + { + entity: 'PurchaseOrder', + resource: 'purchaseorder', + docsSparseSection: 'undocumented', + probeField: 'PrivateNote', + deletable: true, + build: async (session, refs) => + createRecord( + session, + 'PurchaseOrder', + 'purchaseorder', + { + VendorRef: { value: refs.vendorId }, + APAccountRef: { value: refs.apAccountId }, + TxnDate: today(), + DocNumber: generateShortId(8), + PrivateNote: probeTag(), + Memo: 'probe memo', + Line: [ + { + Amount: 15.15, + DetailType: 'ItemBasedExpenseLineDetail', + Description: 'probe line one', + ItemBasedExpenseLineDetail: { + ItemRef: { value: refs.itemId }, + Qty: 1, + UnitPrice: 15.15, + }, + }, + { + Amount: 16.16, + DetailType: 'ItemBasedExpenseLineDetail', + Description: 'probe line two', + ItemBasedExpenseLineDetail: { + ItemRef: { value: refs.itemId }, + Qty: 1, + UnitPrice: 16.16, + }, + }, + ], + }, + true + ), + }, + { + entity: 'Vendor', + resource: 'vendor', + docsSparseSection: 'undocumented', + probeField: 'PrintOnCheckName', + deletable: false, + build: async (session) => { + const suffix = generateShortId(8) + return createRecord( + session, + 'Vendor', + 'vendor', + { + DisplayName: `Sim Sparse Probe Vendor ${suffix}`, + CompanyName: `Sim Sparse Probe Co ${suffix}`, + PrintOnCheckName: `Sim Sparse Probe Check ${suffix}`, + GivenName: 'Sparse', + FamilyName: 'Probe', + PrimaryEmailAddr: { Address: `sparse-probe-${suffix}@example.com` }, + PrimaryPhone: { FreeFormNumber: '555-0100' }, + BillAddr: { + Line1: '1 Probe Street', + City: 'Mountain View', + CountrySubDivisionCode: 'CA', + PostalCode: '94043', + }, + }, + false + ) + }, + }, + { + entity: 'Employee', + resource: 'employee', + docsSparseSection: 'undocumented', + probeField: 'PrintOnCheckName', + deletable: false, + build: async (session) => { + const suffix = generateShortId(8) + return createRecord( + session, + 'Employee', + 'employee', + { + GivenName: 'Sparse', + FamilyName: `Probe${suffix}`, + DisplayName: `Sparse Probe ${suffix}`, + PrintOnCheckName: `Sparse Probe Check ${suffix}`, + PrimaryPhone: { FreeFormNumber: '555-0101' }, + PrimaryAddr: { + Line1: '2 Probe Street', + City: 'Mountain View', + CountrySubDivisionCode: 'CA', + PostalCode: '94043', + }, + }, + false + ) + }, + }, + { + entity: 'Item', + resource: 'item', + docsSparseSection: 'undocumented', + probeField: 'Description', + deletable: false, + build: async (session, refs) => { + const suffix = generateShortId(8) + return createRecord( + session, + 'Item', + 'item', + { + Name: `Sim Sparse Probe Item ${suffix}`, + Type: 'Service', + Description: `probe description ${suffix}`, + UnitPrice: 19.99, + Taxable: false, + IncomeAccountRef: { value: refs.incomeAccountId }, + }, + false + ) + }, + }, +] + +interface Comparison { + droppedFields: string[] + changedFields: string[] + lineCountBefore: number | null + lineCountAfter: number | null +} + +/** + * A sparse update must change exactly the probe field. Dropped fields (present before, + * gone or null after) and a shrunken `Line` array are the data-loss signature. Fields + * that merely changed value are reported but not treated as proof, because QuickBooks + * recomputes some derived amounts on every save. + */ +function compareRecords(before: QboRecord, after: QboRecord, probeField: string): Comparison { + const droppedFields: string[] = [] + const changedFields: string[] = [] + + for (const [key, beforeValue] of Object.entries(before)) { + if (VOLATILE_FIELDS.has(key) || key === probeField) continue + const afterValue = after[key] + if (afterValue === undefined || afterValue === null) { + droppedFields.push(key) + continue + } + if (JSON.stringify(beforeValue) !== JSON.stringify(afterValue)) changedFields.push(key) + } + + return { + droppedFields, + changedFields, + lineCountBefore: lineCount(before), + lineCountAfter: lineCount(after), + } +} + +function classify( + spec: EntitySpec, + sparseResponse: QboResponse, + before: QboRecord, + after: QboRecord | null +): EntityOutcome { + const base = { entity: spec.entity, docsSparseSection: spec.docsSparseSection } + + if (!sparseResponse.ok) { + const isRejection = sparseResponse.status >= 400 && sparseResponse.status < 600 + if (isRejection) { + return { + ...base, + classification: 'SPARSE_REJECTED', + detail: `HTTP ${sparseResponse.status}: ${sparseResponse.rawBody}`, + } + } + return { + ...base, + classification: 'INCONCLUSIVE', + detail: `Unexpected HTTP ${sparseResponse.status}: ${sparseResponse.rawBody}`, + } + } + + if (!after) { + return { + ...base, + classification: 'INCONCLUSIVE', + detail: `Sparse POST returned HTTP 200 but the record could not be re-read. Raw response: ${sparseResponse.rawBody}`, + } + } + + const comparison = compareRecords(before, after, spec.probeField) + const linesLost = + comparison.lineCountBefore !== null && + comparison.lineCountAfter !== null && + comparison.lineCountAfter < comparison.lineCountBefore + + if (comparison.droppedFields.length > 0 || linesLost) { + return { + ...base, + classification: 'SPARSE_IGNORED_DATA_LOSS', + detail: [ + comparison.droppedFields.length > 0 + ? `nulled/dropped fields: ${comparison.droppedFields.join(', ')}` + : null, + linesLost + ? `Line array shrank ${comparison.lineCountBefore} -> ${comparison.lineCountAfter}` + : null, + ] + .filter(Boolean) + .join('; '), + } + } + + const probeApplied = after[spec.probeField] === PROBE_VALUE + if (!probeApplied) { + return { + ...base, + classification: 'INCONCLUSIVE', + detail: `HTTP 200 and no data loss, but ${spec.probeField} is ${JSON.stringify(after[spec.probeField])} rather than "${PROBE_VALUE}". Raw response: ${sparseResponse.rawBody}`, + } + } + + if (comparison.changedFields.length > 0) { + return { + ...base, + classification: 'INCONCLUSIVE', + detail: `Probe field applied and nothing dropped, but these fields changed value: ${comparison.changedFields.join(', ')}. Raw response: ${sparseResponse.rawBody}`, + } + } + + return { + ...base, + classification: 'SPARSE_HONORED', + detail: `${spec.probeField} updated; ${comparison.lineCountAfter ?? 0} Line entries and all other writable fields intact`, + } +} + +async function probeEntity( + session: ProbeSession, + spec: EntitySpec, + refs: CompanyRefs +): Promise { + console.log(`\n--- ${spec.entity} (${spec.docsSparseSection}) ---`) + + const created = await spec.build(session, refs) + const id = requireString(created, 'Id', `created ${spec.entity}`) + + const before = await readRecord(session, spec.entity, spec.resource, id) + const syncToken = requireString(before, 'SyncToken', `${spec.entity} ${id}`) + console.log( + `created ${spec.entity} Id=${id} SyncToken=${syncToken} lines=${lineCount(before) ?? 'n/a'}` + ) + console.log(`payload before probe: ${JSON.stringify(before)}`) + + const sparseResponse = await qboRequest(session, spec.resource, { + method: 'POST', + body: { Id: id, SyncToken: syncToken, sparse: true, [spec.probeField]: PROBE_VALUE }, + }) + console.log(`sparse POST -> HTTP ${sparseResponse.status}`) + + let after: QboRecord | null = null + if (sparseResponse.ok) { + after = await readRecord(session, spec.entity, spec.resource, id) + console.log(`payload after probe: ${JSON.stringify(after)}`) + } + + const outcome = classify(spec, sparseResponse, before, after) + console.log(`=> ${outcome.classification}: ${outcome.detail}`) + return outcome +} + +async function cleanup(session: ProbeSession): Promise { + console.log('\n--- cleanup ---') + const undeleted: CreatedRecord[] = [] + + for (const record of [...session.created].reverse()) { + if (!record.deletable) { + undeleted.push(record) + continue + } + try { + const current = await readRecord(session, record.entity, record.resource, record.id) + const syncToken = requireString(current, 'SyncToken', `${record.entity} ${record.id}`) + const response = await qboRequest(session, record.resource, { + method: 'POST', + query: { operation: 'delete' }, + body: { Id: record.id, SyncToken: syncToken }, + }) + if (response.ok) { + console.log(`deleted ${record.entity} ${record.id}`) + } else { + console.error( + `FAILED to delete ${record.entity} ${record.id} (HTTP ${response.status}): ${response.rawBody}` + ) + undeleted.push(record) + } + } catch (error) { + console.error(`FAILED to delete ${record.entity} ${record.id}: ${getErrorMessage(error)}`) + undeleted.push(record) + } + } + + if (undeleted.length > 0) { + console.error( + '\nMANUAL CLEANUP REQUIRED — the following sandbox records were left behind (QuickBooks does not delete name-list entities; deactivate them by hand):' + ) + for (const record of undeleted) { + console.error(` - ${record.entity} Id=${record.id}`) + } + } +} + +function printSummary(outcomes: readonly EntityOutcome[]): void { + console.log('\n=== SUMMARY ===') + const entityWidth = Math.max(...outcomes.map((outcome) => outcome.entity.length), 'Entity'.length) + const header = `${'Entity'.padEnd(entityWidth)} ${'Docs'.padEnd(12)} Classification` + console.log(header) + console.log('-'.repeat(header.length)) + for (const outcome of outcomes) { + console.log( + `${outcome.entity.padEnd(entityWidth)} ${outcome.docsSparseSection.padEnd(12)} ${outcome.classification}` + ) + } +} + +async function main(): Promise { + const { realmId } = requireEnvVars() + assertSandboxOnly() + + console.log(`QuickBooks sparse probe — sandbox realm ${realmId} @ ${getQuickBooksApiBaseUrl()}`) + + const session: ProbeSession = { + accessToken: await resolveAccessToken(), + realmId, + created: [], + } + + const outcomes: EntityOutcome[] = [] + let runError: unknown = null + + try { + const refs = await resolveCompanyRefs(session) + console.log(`resolved company refs: ${JSON.stringify(refs)}`) + + for (const spec of ENTITY_SPECS) { + try { + outcomes.push(await probeEntity(session, spec, refs)) + } catch (error) { + const detail = getErrorMessage(error) + console.error(`${spec.entity} probe failed: ${detail}`) + outcomes.push({ + entity: spec.entity, + docsSparseSection: spec.docsSparseSection, + classification: 'INCONCLUSIVE', + detail, + }) + } + } + } catch (error) { + runError = error + console.error(`Probe run aborted: ${getErrorMessage(error)}`) + } finally { + await cleanup(session) + } + + if (outcomes.length > 0) printSummary(outcomes) + + console.log('\n=== DETAIL ===') + for (const outcome of outcomes) { + console.log(`${outcome.entity}: ${outcome.classification} — ${outcome.detail}`) + } + + const dataLoss = outcomes.filter( + (outcome) => outcome.classification === 'SPARSE_IGNORED_DATA_LOSS' + ) + if (dataLoss.length > 0) { + console.error( + `\nSHIP-BLOCKER: ${dataLoss.length} entit${dataLoss.length === 1 ? 'y' : 'ies'} silently lost data under sparse: ${dataLoss.map((outcome) => outcome.entity).join(', ')}` + ) + process.exit(1) + } + if (runError) process.exit(1) +} + +main().catch((error: unknown) => { + console.error(getErrorMessage(error)) + process.exit(1) +}) diff --git a/apps/sim/serializer/field-analysis.test.ts b/apps/sim/serializer/field-analysis.test.ts index 6123810cde6..36e2979aa25 100644 --- a/apps/sim/serializer/field-analysis.test.ts +++ b/apps/sim/serializer/field-analysis.test.ts @@ -214,4 +214,38 @@ describe('extractBlockParams', () => { expect(params.credential).toBeUndefined() expect(params.manualCredential).toBeUndefined() }) + + it('preserves a singleton canonical credential when additional fields are open', () => { + svcConfig.value = config([ + { + id: 'credential', + title: 'QuickBooks Account', + type: 'oauth-input', + canonicalParamId: 'oauthCredential', + required: true, + }, + { + id: 'privateNote', + title: 'Private Note', + type: 'long-input', + mode: 'advanced', + }, + ]) + + const state = block({ + type: 'svc', + advancedMode: true, + subBlocks: { + credential: { value: 'credential-id' }, + privateNote: { value: 'Updated through Sim' }, + }, + }) + const params = extractBlockParams(state) + const issues = collectBlockFieldIssues(state, svcConfig.value, params) + + expect(params.oauthCredential).toBe('credential-id') + expect(params.credential).toBeUndefined() + expect(params.privateNote).toBe('Updated through Sim') + expect(issues.missingRequiredFields).toEqual([]) + }) }) diff --git a/apps/sim/serializer/index.ts b/apps/sim/serializer/index.ts index ef27aa74c40..868029d4f64 100644 --- a/apps/sim/serializer/index.ts +++ b/apps/sim/serializer/index.ts @@ -583,8 +583,17 @@ export function extractBlockParams(block: BlockState): Record { Object.values(canonicalIndex.groupsById).forEach((group) => { const { basicValue, advancedValue } = getCanonicalValues(group, params) const hasExplicitOverride = canonicalModeOverrides?.[group.canonicalId] != null + /** + * The `legacyAdvancedMode` shortcut to `'advanced'` is only sound for a real + * canonical PAIR — a group holding both a basic and an advanced sub-block. + * A singleton group (basic-only, no advanced sibling) has no advanced value, + * so forcing `'advanced'` selects `undefined` and drops the parameter from the + * serialized block entirely; for an `oauth-input` that silently loses the + * credential. `isCanonicalPair` gates the shortcut so singleton groups always + * resolve through `resolveCanonicalMode`. + */ const pairMode = - hasExplicitOverride || !legacyAdvancedMode + !isCanonicalPair(group) || hasExplicitOverride || !legacyAdvancedMode ? resolveCanonicalMode(group, allValues, canonicalModeOverrides) : 'advanced' const chosen = pairMode === 'advanced' ? advancedValue : basicValue diff --git a/apps/sim/tools/error-extractors.ts b/apps/sim/tools/error-extractors.ts index 1f1590a9053..7558487f09c 100644 --- a/apps/sim/tools/error-extractors.ts +++ b/apps/sim/tools/error-extractors.ts @@ -20,11 +20,13 @@ */ import { parseGraphErrorFromData } from '@/tools/microsoft_excel/utils' +import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' export interface ErrorInfo { status?: number statusText?: string data?: any + headers?: { get(name: string): string | null } } export type ErrorExtractor = (errorInfo?: ErrorInfo) => string | null | undefined @@ -36,6 +38,18 @@ interface ErrorExtractorConfig { description: string /** Example APIs that use this pattern */ examples?: string[] + /** + * Whether this extractor may run in the provider-agnostic fallback chain that + * {@link extractErrorMessage} walks when a tool declares no `errorExtractor`. + * + * Defaults to `true`. Set it to `false` for any extractor that returns a + * non-empty string unconditionally — the fallback loop stops at the first + * non-empty result, so such an extractor hijacks the chain and relabels every + * other provider's errors. `quickbooks-fault` is exactly that shape: it always + * produces at least `"QuickBooks request failed."`. Do not delete this flag + * without first making the extractor return `null` for non-matching payloads. + */ + useInFallback?: boolean /** The extraction function */ extract: ErrorExtractor } @@ -254,6 +268,44 @@ const ERROR_EXTRACTORS: ErrorExtractorConfig[] = [ return typeof attr === 'string' && attr ? `${detail} (${attr})` : detail }, }, + { + id: 'quickbooks-fault', + description: 'QuickBooks Online Fault.Error[] responses with authentication and rate guidance', + examples: ['QuickBooks Online Accounting API'], + useInFallback: false, + extract: (errorInfo) => { + const status = errorInfo?.status + const fault = sanitizeQuickBooksFaultData(errorInfo?.data) + const faultMessage = fault ? formatQuickBooksFaultDetail(fault) : '' + + const guidance = + status === 401 + ? 'Reconnect the QuickBooks credential.' + : status === 403 + ? 'Confirm the QuickBooks accounting scope and access to this company.' + : status === 429 + ? 'QuickBooks rate limit reached; retry after the indicated delay.' + : '' + const trackingId = + errorInfo?.headers?.get('intuit_tid') ?? + errorInfo?.headers?.get('x-request-id') ?? + errorInfo?.headers?.get('request-id') + const retryAfter = status === 429 ? errorInfo?.headers?.get('retry-after') : null + + const context = [ + trackingId ? `Intuit tracking ID: ${trackingId}` : '', + retryAfter ? `Retry-After: ${retryAfter}` : '', + ] + .filter(Boolean) + .join('; ') + const statusMessage = + typeof status === 'number' + ? `QuickBooks request failed with HTTP ${status}.` + : 'QuickBooks request failed.' + const message = [statusMessage, guidance, faultMessage].filter(Boolean).join(' ') + return context ? `${message} (${context})` : message + }, + }, { id: 'plain-text-data', description: 'Plain text error response', @@ -303,6 +355,7 @@ export function extractErrorMessage(errorInfo?: ErrorInfo, extractorId?: string) // Backwards compatibility for (const extractor of ERROR_EXTRACTORS) { + if (extractor.useInFallback === false) continue try { const message = extractor.extract(errorInfo) if (message?.trim()) { @@ -332,6 +385,7 @@ export const ErrorExtractorId = { OAUTH_ERROR_DESCRIPTION: 'oauth-error-description', NESTED_ERROR_OBJECT: 'nested-error-object', POSTHOG_ERRORS: 'posthog-errors', + QUICKBOOKS_FAULT: 'quickbooks-fault', PLAIN_TEXT_DATA: 'plain-text-data', HTTP_STATUS_TEXT: 'http-status-text', } as const diff --git a/apps/sim/tools/generated/tool-ids.ts b/apps/sim/tools/generated/tool-ids.ts index 6c6425c38ca..e05137c15d7 100644 --- a/apps/sim/tools/generated/tool-ids.ts +++ b/apps/sim/tools/generated/tool-ids.ts @@ -3,7 +3,7 @@ /** Every registered tool id, including versioned variants. */ const toolIds: string[] = JSON.parse( - '["a2a_cancel_task","a2a_get_agent_card","a2a_get_task","a2a_send_message","agentmail_create_draft","agentmail_create_inbox","agentmail_delete_draft","agentmail_delete_inbox","agentmail_delete_thread","agentmail_forward_message","agentmail_get_draft","agentmail_get_inbox","agentmail_get_message","agentmail_get_thread","agentmail_list_drafts","agentmail_list_inboxes","agentmail_list_messages","agentmail_list_threads","agentmail_reply_message","agentmail_send_draft","agentmail_send_message","agentmail_update_draft","agentmail_update_inbox","agentmail_update_message","agentmail_update_thread","agentphone_create_call","agentphone_create_contact","agentphone_create_number","agentphone_delete_contact","agentphone_get_call","agentphone_get_call_transcript","agentphone_get_contact","agentphone_get_conversation","agentphone_get_conversation_messages","agentphone_get_number_messages","agentphone_get_usage","agentphone_get_usage_daily","agentphone_get_usage_monthly","agentphone_list_calls","agentphone_list_contacts","agentphone_list_conversations","agentphone_list_numbers","agentphone_react_to_message","agentphone_release_number","agentphone_send_message","agentphone_update_contact","agentphone_update_conversation","agiloft_attach_file","agiloft_attachment_info","agiloft_create_record","agiloft_delete_record","agiloft_get_choice_line_id","agiloft_lock_record","agiloft_read_record","agiloft_remove_attachment","agiloft_retrieve_attachment","agiloft_saved_search","agiloft_search_records","agiloft_select_records","agiloft_update_record","ahrefs_anchors","ahrefs_backlinks","ahrefs_backlinks_stats","ahrefs_batch_analysis","ahrefs_broken_backlinks","ahrefs_domain_rating","ahrefs_domain_rating_history","ahrefs_keyword_overview","ahrefs_keywords_history","ahrefs_metrics","ahrefs_metrics_history","ahrefs_organic_competitors","ahrefs_organic_keywords","ahrefs_paid_pages","ahrefs_rank_tracker_competitors_overview","ahrefs_rank_tracker_competitors_stats","ahrefs_rank_tracker_overview","ahrefs_rank_tracker_serp_overview","ahrefs_refdomains_history","ahrefs_referring_domains","ahrefs_related_terms","ahrefs_site_audit_page_explorer","ahrefs_top_pages","airtable_create_records","airtable_delete_records","airtable_get_base_schema","airtable_get_record","airtable_list_bases","airtable_list_records","airtable_list_tables","airtable_update_multiple_records","airtable_update_record","airtable_upsert_records","airweave_search","algolia_add_record","algolia_batch_operations","algolia_browse_records","algolia_clear_records","algolia_copy_move_index","algolia_delete_by_filter","algolia_delete_index","algolia_delete_record","algolia_get_record","algolia_get_records","algolia_get_settings","algolia_get_task_status","algolia_list_indices","algolia_partial_update_record","algolia_search","algolia_update_settings","amplitude_event_segmentation","amplitude_funnels","amplitude_get_active_users","amplitude_get_revenue","amplitude_group_identify","amplitude_identify_user","amplitude_list_events","amplitude_realtime_active_users","amplitude_retention","amplitude_send_event","amplitude_user_activity","amplitude_user_profile","amplitude_user_search","apify_get_dataset_items","apify_get_run","apify_run_actor_async","apify_run_actor_sync","apify_run_task","apollo_account_bulk_create","apollo_account_bulk_update","apollo_account_create","apollo_account_search","apollo_account_update","apollo_contact_bulk_create","apollo_contact_bulk_update","apollo_contact_create","apollo_contact_search","apollo_contact_update","apollo_email_accounts","apollo_opportunity_create","apollo_opportunity_get","apollo_opportunity_search","apollo_opportunity_update","apollo_organization_bulk_enrich","apollo_organization_enrich","apollo_organization_search","apollo_people_bulk_enrich","apollo_people_enrich","apollo_people_search","apollo_sequence_add_contacts","apollo_sequence_search","apollo_task_create","apollo_task_search","appconfig_create_application","appconfig_create_configuration_profile","appconfig_create_environment","appconfig_create_hosted_configuration_version","appconfig_delete_application","appconfig_delete_configuration_profile","appconfig_delete_environment","appconfig_delete_hosted_configuration_version","appconfig_get_application","appconfig_get_configuration","appconfig_get_configuration_profile","appconfig_get_deployment","appconfig_get_environment","appconfig_get_hosted_configuration_version","appconfig_list_applications","appconfig_list_configuration_profiles","appconfig_list_deployment_strategies","appconfig_list_deployments","appconfig_list_environments","appconfig_list_hosted_configuration_versions","appconfig_start_deployment","appconfig_stop_deployment","appconfig_update_application","appconfig_update_configuration_profile","appconfig_update_environment","arxiv_get_author_papers","arxiv_get_paper","arxiv_search","asana_add_comment","asana_add_followers","asana_create_project","asana_create_section","asana_create_subtask","asana_create_task","asana_delete_task","asana_get_project","asana_get_projects","asana_get_task","asana_list_sections","asana_list_workspaces","asana_search_tasks","asana_update_task","ashby_add_candidate_tag","ashby_change_application_stage","ashby_create_application","ashby_create_candidate","ashby_create_note","ashby_get_application","ashby_get_candidate","ashby_get_job","ashby_get_job_posting","ashby_get_offer","ashby_list_applications","ashby_list_archive_reasons","ashby_list_candidate_tags","ashby_list_candidates","ashby_list_custom_fields","ashby_list_departments","ashby_list_interviews","ashby_list_job_postings","ashby_list_jobs","ashby_list_locations","ashby_list_notes","ashby_list_offers","ashby_list_openings","ashby_list_sources","ashby_list_users","ashby_remove_candidate_tag","ashby_search_candidates","ashby_update_candidate","athena_batch_get_query_execution","athena_create_named_query","athena_delete_named_query","athena_get_named_query","athena_get_query_execution","athena_get_query_results","athena_list_databases","athena_list_named_queries","athena_list_query_executions","athena_list_table_metadata","athena_start_query","athena_stop_query","attio_assert_record","attio_create_attribute","attio_create_comment","attio_create_list","attio_create_list_entry","attio_create_note","attio_create_object","attio_create_record","attio_create_task","attio_create_webhook","attio_delete_comment","attio_delete_list_entry","attio_delete_note","attio_delete_record","attio_delete_task","attio_delete_webhook","attio_get_attribute","attio_get_comment","attio_get_list","attio_get_list_entry","attio_get_member","attio_get_note","attio_get_object","attio_get_record","attio_get_task","attio_get_thread","attio_get_webhook","attio_list_attributes","attio_list_lists","attio_list_members","attio_list_notes","attio_list_objects","attio_list_records","attio_list_tasks","attio_list_threads","attio_list_webhooks","attio_query_list_entries","attio_search_records","attio_update_attribute","attio_update_list","attio_update_list_entry","attio_update_object","attio_update_record","attio_update_task","attio_update_webhook","azure_devops_add_comment","azure_devops_create_work_item","azure_devops_get_build_log","azure_devops_get_build_timeline","azure_devops_get_comments","azure_devops_get_pipeline","azure_devops_get_pipeline_run","azure_devops_get_work_item","azure_devops_get_work_items_batch","azure_devops_get_work_items_between_builds","azure_devops_list_build_logs","azure_devops_list_builds","azure_devops_list_pipeline_runs","azure_devops_list_pipelines","azure_devops_query_work_items","azure_devops_update_work_item","box_copy_file","box_create_folder","box_delete_file","box_delete_folder","box_download_file","box_get_file_info","box_list_folder_items","box_search","box_sign_cancel_request","box_sign_create_request","box_sign_get_request","box_sign_list_requests","box_sign_resend_request","box_update_file","box_upload_file","brandfetch_get_brand","brandfetch_search","brex_archive_budget","brex_create_budget","brex_create_spend_limit","brex_create_transfer","brex_create_vendor","brex_get_budget","brex_get_cash_account","brex_get_company","brex_get_current_user","brex_get_expense","brex_get_spend_limit","brex_get_transfer","brex_get_user","brex_get_vendor","brex_list_budgets","brex_list_card_accounts","brex_list_card_statements","brex_list_card_transactions","brex_list_cards","brex_list_cash_accounts","brex_list_cash_statements","brex_list_cash_transactions","brex_list_departments","brex_list_expenses","brex_list_locations","brex_list_spend_limits","brex_list_titles","brex_list_transfers","brex_list_users","brex_list_vendors","brex_match_receipt","brex_update_expense","brex_update_vendor","brex_upload_receipt","brightdata_cancel_snapshot","brightdata_discover","brightdata_download_snapshot","brightdata_scrape_dataset","brightdata_scrape_url","brightdata_serp_search","brightdata_snapshot_status","brightdata_sync_scrape","browser_use_run_task","buffer_create_idea","buffer_create_post","buffer_delete_post","buffer_edit_post","buffer_get_account","buffer_get_channels","buffer_get_idea_groups","buffer_get_ideas","buffer_get_post","buffer_get_posts","calcom_cancel_booking","calcom_confirm_booking","calcom_create_booking","calcom_create_event_type","calcom_create_schedule","calcom_decline_booking","calcom_delete_event_type","calcom_delete_schedule","calcom_get_booking","calcom_get_default_schedule","calcom_get_event_type","calcom_get_schedule","calcom_get_slots","calcom_list_bookings","calcom_list_event_types","calcom_list_schedules","calcom_reschedule_booking","calcom_update_event_type","calcom_update_schedule","calendly_cancel_event","calendly_create_webhook","calendly_delete_webhook","calendly_get_current_user","calendly_get_event_type","calendly_get_scheduled_event","calendly_list_event_invitees","calendly_list_event_types","calendly_list_scheduled_events","calendly_list_webhooks","clay_populate","clerk_add_organization_member","clerk_ban_user","clerk_create_actor_token","clerk_create_allowlist_identifier","clerk_create_blocklist_identifier","clerk_create_organization","clerk_create_organization_invitation","clerk_create_user","clerk_delete_allowlist_identifier","clerk_delete_blocklist_identifier","clerk_delete_organization","clerk_delete_user","clerk_get_jwt_template","clerk_get_organization","clerk_get_session","clerk_get_user","clerk_get_user_oauth_token","clerk_list_allowlist_identifiers","clerk_list_blocklist_identifiers","clerk_list_jwt_templates","clerk_list_organization_invitations","clerk_list_organization_memberships","clerk_list_organizations","clerk_list_sessions","clerk_list_users","clerk_lock_user","clerk_remove_organization_member","clerk_revoke_actor_token","clerk_revoke_session","clerk_unban_user","clerk_unlock_user","clerk_update_organization","clerk_update_organization_membership","clerk_update_user","clickhouse_count_rows","clickhouse_create_database","clickhouse_create_table","clickhouse_delete","clickhouse_describe_table","clickhouse_drop_database","clickhouse_drop_partition","clickhouse_drop_table","clickhouse_execute","clickhouse_insert","clickhouse_insert_rows","clickhouse_introspect","clickhouse_kill_query","clickhouse_list_clusters","clickhouse_list_databases","clickhouse_list_mutations","clickhouse_list_partitions","clickhouse_list_running_queries","clickhouse_list_tables","clickhouse_optimize_table","clickhouse_query","clickhouse_rename_table","clickhouse_show_create_table","clickhouse_table_stats","clickhouse_truncate_table","clickhouse_update","clickup_add_tag_to_task","clickup_create_checklist","clickup_create_checklist_item","clickup_create_comment","clickup_create_folder","clickup_create_list","clickup_create_task","clickup_create_time_entry","clickup_delete_checklist","clickup_delete_checklist_item","clickup_delete_comment","clickup_delete_task","clickup_delete_time_entry","clickup_get_comments","clickup_get_custom_fields","clickup_get_folders","clickup_get_list_members","clickup_get_lists","clickup_get_running_timer","clickup_get_space_tags","clickup_get_spaces","clickup_get_task","clickup_get_task_members","clickup_get_tasks","clickup_get_time_entries","clickup_get_workspaces","clickup_remove_custom_field_value","clickup_remove_tag_from_task","clickup_search_tasks","clickup_set_custom_field_value","clickup_start_timer","clickup_stop_timer","clickup_update_checklist","clickup_update_checklist_item","clickup_update_comment","clickup_update_task","clickup_update_time_entry","clickup_upload_attachment","cloudflare_create_dns_record","cloudflare_create_zone","cloudflare_delete_dns_record","cloudflare_delete_zone","cloudflare_dns_analytics","cloudflare_get_zone","cloudflare_get_zone_settings","cloudflare_list_certificates","cloudflare_list_dns_records","cloudflare_list_zones","cloudflare_purge_cache","cloudflare_update_dns_record","cloudflare_update_zone_setting","cloudformation_cancel_update_stack","cloudformation_create_change_set","cloudformation_create_stack","cloudformation_delete_stack","cloudformation_describe_change_set","cloudformation_describe_stack_drift_detection_status","cloudformation_describe_stack_events","cloudformation_describe_stacks","cloudformation_detect_stack_drift","cloudformation_execute_change_set","cloudformation_get_template","cloudformation_get_template_summary","cloudformation_list_stack_resources","cloudformation_update_stack","cloudformation_validate_template","cloudwatch_describe_alarm_history","cloudwatch_describe_alarms","cloudwatch_describe_log_groups","cloudwatch_describe_log_streams","cloudwatch_filter_log_events","cloudwatch_get_log_events","cloudwatch_get_metric_statistics","cloudwatch_list_metrics","cloudwatch_mute_alarm","cloudwatch_put_log_group_retention","cloudwatch_put_metric_data","cloudwatch_query_logs","cloudwatch_unmute_alarm","codepipeline_disable_stage_transition","codepipeline_enable_stage_transition","codepipeline_get_pipeline","codepipeline_get_pipeline_execution","codepipeline_get_pipeline_state","codepipeline_list_action_executions","codepipeline_list_pipeline_executions","codepipeline_list_pipelines","codepipeline_put_approval_result","codepipeline_retry_stage_execution","codepipeline_start_execution","codepipeline_stop_execution","confluence_add_label","confluence_create_blogpost","confluence_create_comment","confluence_create_page","confluence_create_page_property","confluence_create_space","confluence_create_space_property","confluence_delete_attachment","confluence_delete_blogpost","confluence_delete_comment","confluence_delete_label","confluence_delete_page","confluence_delete_page_property","confluence_delete_space","confluence_delete_space_property","confluence_get_blogpost","confluence_get_page_ancestors","confluence_get_page_children","confluence_get_page_descendants","confluence_get_page_version","confluence_get_pages_by_label","confluence_get_space","confluence_get_task","confluence_get_user","confluence_list_attachments","confluence_list_blogposts","confluence_list_blogposts_in_space","confluence_list_comments","confluence_list_labels","confluence_list_page_properties","confluence_list_page_versions","confluence_list_pages_in_space","confluence_list_space_labels","confluence_list_space_permissions","confluence_list_space_properties","confluence_list_spaces","confluence_list_tasks","confluence_retrieve","confluence_search","confluence_search_in_space","confluence_update","confluence_update_blogpost","confluence_update_comment","confluence_update_space","confluence_update_task","confluence_upload_attachment","context_dev_classify_naics","context_dev_classify_sic","context_dev_crawl","context_dev_extract","context_dev_extract_product","context_dev_extract_products","context_dev_get_brand","context_dev_get_brand_by_email","context_dev_get_brand_by_name","context_dev_get_brand_by_ticker","context_dev_identify_transaction","context_dev_map","context_dev_scrape_fonts","context_dev_scrape_html","context_dev_scrape_images","context_dev_scrape_markdown","context_dev_scrape_styleguide","context_dev_screenshot","context_dev_search","convex_action","convex_document_deltas","convex_list_documents","convex_list_tables","convex_mutation","convex_query","convex_run_function","crowdstrike_get_sensor_aggregates","crowdstrike_get_sensor_details","crowdstrike_query_sensors","cursor_add_followup","cursor_add_followup_v2","cursor_delete_agent","cursor_delete_agent_v2","cursor_download_artifact","cursor_download_artifact_v2","cursor_get_agent","cursor_get_agent_v2","cursor_get_api_key_info","cursor_get_api_key_info_v2","cursor_get_conversation","cursor_get_conversation_v2","cursor_launch_agent","cursor_launch_agent_v2","cursor_list_agents","cursor_list_agents_v2","cursor_list_artifacts","cursor_list_artifacts_v2","cursor_list_models","cursor_list_models_v2","cursor_list_repositories","cursor_list_repositories_v2","cursor_stop_agent","cursor_stop_agent_v2","dagster_delete_run","dagster_get_asset","dagster_get_run","dagster_get_run_logs","dagster_launch_run","dagster_list_assets","dagster_list_jobs","dagster_list_runs","dagster_list_schedules","dagster_list_sensors","dagster_materialize_assets","dagster_reexecute_run","dagster_report_asset_materialization","dagster_start_schedule","dagster_start_sensor","dagster_stop_schedule","dagster_stop_sensor","dagster_terminate_run","dagster_wipe_asset","databricks_cancel_run","databricks_execute_sql","databricks_get_cluster","databricks_get_job","databricks_get_run","databricks_get_run_output","databricks_get_statement","databricks_list_clusters","databricks_list_jobs","databricks_list_runs","databricks_list_warehouses","databricks_run_job","datadog_cancel_downtime","datadog_create_downtime","datadog_create_event","datadog_create_monitor","datadog_get_monitor","datadog_list_downtimes","datadog_list_monitors","datadog_mute_monitor","datadog_query_logs","datadog_query_timeseries","datadog_send_logs","datadog_submit_metrics","datagma_enrich_company","datagma_enrich_person","datagma_find_email","datagma_find_phone","datagma_get_credits","daytona_create_sandbox","daytona_delete_sandbox","daytona_download_file","daytona_execute_command","daytona_get_sandbox","daytona_git_clone","daytona_list_files","daytona_list_sandboxes","daytona_run_code","daytona_start_sandbox","daytona_stop_sandbox","daytona_upload_file","deployed_block_executor","deployments_deploy","deployments_get_version","deployments_list_versions","deployments_promote","deployments_undeploy","devin_append_session_tags","devin_archive_session","devin_create_session","devin_get_session","devin_get_session_tags","devin_list_session_attachments","devin_list_session_messages","devin_list_sessions","devin_replace_session_tags","devin_send_message","devin_terminate_session","discord_add_reaction","discord_archive_thread","discord_assign_role","discord_ban_member","discord_bulk_delete_messages","discord_create_channel","discord_create_invite","discord_create_role","discord_create_thread","discord_create_webhook","discord_delete_channel","discord_delete_invite","discord_delete_message","discord_delete_role","discord_delete_webhook","discord_edit_message","discord_execute_webhook","discord_get_channel","discord_get_invite","discord_get_member","discord_get_messages","discord_get_pinned_messages","discord_get_server","discord_get_user","discord_get_webhook","discord_join_thread","discord_kick_member","discord_leave_thread","discord_list_channels","discord_list_roles","discord_pin_message","discord_remove_reaction","discord_remove_role","discord_send_message","discord_unban_member","discord_unpin_message","discord_update_channel","discord_update_member","discord_update_role","docusign_create_from_template","docusign_download_document","docusign_get_envelope","docusign_list_envelopes","docusign_list_recipients","docusign_list_templates","docusign_send_envelope","docusign_void_envelope","downdetector_get_company","downdetector_get_company_attribution","downdetector_get_company_baseline","downdetector_get_company_events","downdetector_get_company_incidents","downdetector_get_company_indicators","downdetector_get_company_last_15","downdetector_get_company_status","downdetector_get_provider","downdetector_get_reports","downdetector_get_site_companies","downdetector_list_categories","downdetector_list_incidents","downdetector_list_sites","downdetector_search_companies","dropbox_copy","dropbox_create_folder","dropbox_create_shared_link","dropbox_delete","dropbox_download","dropbox_get_metadata","dropbox_list_folder","dropbox_list_revisions","dropbox_list_shared_links","dropbox_move","dropbox_restore","dropbox_search","dropbox_upload","dropcontact_enrich_contact","dspy_chain_of_thought","dspy_predict","dspy_react","dub_bulk_create_links","dub_bulk_delete_links","dub_bulk_update_links","dub_create_link","dub_create_tag","dub_delete_link","dub_get_analytics","dub_get_events","dub_get_link","dub_get_links_count","dub_get_qr_code","dub_list_domains","dub_list_folders","dub_list_links","dub_list_tags","dub_update_link","dub_upsert_link","duckduckgo_search","dynamodb_delete","dynamodb_get","dynamodb_introspect","dynamodb_put","dynamodb_query","dynamodb_scan","dynamodb_update","elasticsearch_bulk","elasticsearch_cluster_health","elasticsearch_cluster_stats","elasticsearch_count","elasticsearch_create_index","elasticsearch_delete_document","elasticsearch_delete_index","elasticsearch_get_document","elasticsearch_get_index","elasticsearch_index_document","elasticsearch_list_indices","elasticsearch_search","elasticsearch_update_document","elevenlabs_audio_isolation","elevenlabs_edit_voice_settings","elevenlabs_get_user","elevenlabs_get_voice","elevenlabs_get_voice_settings","elevenlabs_list_models","elevenlabs_list_voices","elevenlabs_sound_effects","elevenlabs_speech_to_speech","elevenlabs_tts","emailbison_attach_leads_to_campaign","emailbison_attach_tags_to_leads","emailbison_create_campaign","emailbison_create_lead","emailbison_create_tag","emailbison_get_lead","emailbison_list_campaigns","emailbison_list_leads","emailbison_list_replies","emailbison_list_tags","emailbison_update_campaign","emailbison_update_campaign_status","emailbison_update_lead","enrich_check_credits","enrich_company_funding","enrich_company_lookup","enrich_company_revenue","enrich_disposable_email_check","enrich_email_to_ip","enrich_email_to_person_lite","enrich_email_to_phone","enrich_email_to_profile","enrich_find_email","enrich_get_post_details","enrich_ip_to_company","enrich_linkedin_profile","enrich_linkedin_to_personal_email","enrich_linkedin_to_work_email","enrich_phone_finder","enrich_reverse_hash_lookup","enrich_sales_pointer_people","enrich_search_company","enrich_search_company_activities","enrich_search_company_employees","enrich_search_jobs","enrich_search_logo","enrich_search_people","enrich_search_people_activities","enrich_search_post_comments","enrich_search_post_comments_by_url","enrich_search_post_reactions","enrich_search_post_reactions_by_url","enrich_search_posts","enrich_search_similar_companies","enrich_verify_email","enrichment_run","enrow_find_email","enrow_verify_email","evernote_copy_note","evernote_create_note","evernote_create_notebook","evernote_create_tag","evernote_delete_note","evernote_get_note","evernote_get_notebook","evernote_list_notebooks","evernote_list_tags","evernote_search_notes","evernote_update_note","exa_agent","exa_answer","exa_find_similar_links","exa_get_contents","exa_search","extend_parser","extend_parser_v2","fathom_get_summary","fathom_get_transcript","fathom_list_meeting_types","fathom_list_meetings","fathom_list_team_members","fathom_list_teams","file_append","file_compress","file_decompress","file_fetch","file_get","file_get_content","file_manage_sharing","file_parser","file_parser_v2","file_parser_v3","file_read","file_write","findymail_find_email_from_linkedin","findymail_find_email_from_name","findymail_find_emails_by_domain","findymail_find_employees","findymail_find_phone","findymail_get_company","findymail_get_credits","findymail_lookup_technologies","findymail_reverse_email_lookup","findymail_search_technologies","findymail_verify_email","firecrawl_agent","firecrawl_batch_scrape","firecrawl_batch_scrape_status","firecrawl_cancel_crawl","firecrawl_crawl","firecrawl_crawl_status","firecrawl_credit_usage","firecrawl_extract","firecrawl_extract_status","firecrawl_map","firecrawl_parse","firecrawl_scrape","firecrawl_search","fireflies_add_to_live_meeting","fireflies_create_bite","fireflies_delete_transcript","fireflies_get_transcript","fireflies_get_user","fireflies_list_bites","fireflies_list_contacts","fireflies_list_transcripts","fireflies_list_users","fireflies_upload_audio","flint_create_task","flint_generate_pages","flint_get_task","function_execute","gamma_check_status","gamma_generate","gamma_generate_from_template","gamma_list_folders","gamma_list_themes","github_add_assignees","github_add_assignees_v2","github_add_labels","github_add_labels_v2","github_cancel_workflow_run","github_cancel_workflow_run_v2","github_check_star","github_check_star_v2","github_close_issue","github_close_issue_v2","github_close_pr","github_close_pr_v2","github_comment","github_comment_v2","github_compare_commits","github_compare_commits_v2","github_create_branch","github_create_branch_v2","github_create_comment_reaction","github_create_comment_reaction_v2","github_create_file","github_create_file_v2","github_create_gist","github_create_gist_v2","github_create_issue","github_create_issue_reaction","github_create_issue_reaction_v2","github_create_issue_v2","github_create_milestone","github_create_milestone_v2","github_create_pr","github_create_pr_review","github_create_pr_review_v2","github_create_pr_v2","github_create_project","github_create_project_v2","github_create_release","github_create_release_v2","github_delete_branch","github_delete_branch_v2","github_delete_comment","github_delete_comment_reaction","github_delete_comment_reaction_v2","github_delete_comment_v2","github_delete_file","github_delete_file_v2","github_delete_gist","github_delete_gist_v2","github_delete_issue_reaction","github_delete_issue_reaction_v2","github_delete_milestone","github_delete_milestone_v2","github_delete_project","github_delete_project_v2","github_delete_release","github_delete_release_v2","github_fork_gist","github_fork_gist_v2","github_fork_repo","github_fork_repo_v2","github_get_branch","github_get_branch_protection","github_get_branch_protection_v2","github_get_branch_v2","github_get_commit","github_get_commit_v2","github_get_file_content","github_get_file_content_v2","github_get_gist","github_get_gist_v2","github_get_issue","github_get_issue_v2","github_get_latest_release","github_get_latest_release_v2","github_get_milestone","github_get_milestone_v2","github_get_pr_files","github_get_pr_files_v2","github_get_project","github_get_project_v2","github_get_readme","github_get_readme_v2","github_get_release","github_get_release_v2","github_get_tree","github_get_tree_v2","github_get_workflow","github_get_workflow_run","github_get_workflow_run_v2","github_get_workflow_v2","github_issue_comment","github_issue_comment_v2","github_job_logs","github_latest_commit","github_latest_commit_v2","github_list_branches","github_list_branches_v2","github_list_commits","github_list_commits_v2","github_list_forks","github_list_forks_v2","github_list_gists","github_list_gists_v2","github_list_issue_comments","github_list_issue_comments_v2","github_list_issues","github_list_issues_v2","github_list_milestones","github_list_milestones_v2","github_list_pr_comments","github_list_pr_comments_v2","github_list_projects","github_list_projects_v2","github_list_prs","github_list_prs_v2","github_list_releases","github_list_releases_v2","github_list_review_threads","github_list_stargazers","github_list_stargazers_v2","github_list_tags","github_list_tags_v2","github_list_workflow_runs","github_list_workflow_runs_v2","github_list_workflows","github_list_workflows_v2","github_merge_pr","github_merge_pr_v2","github_pr","github_pr_v2","github_remove_label","github_remove_label_v2","github_reply_review_thread","github_repo_info","github_repo_info_v2","github_request_reviewers","github_request_reviewers_v2","github_rerun_workflow","github_rerun_workflow_v2","github_resolve_review_thread","github_search_code","github_search_code_v2","github_search_commits","github_search_commits_v2","github_search_issues","github_search_issues_v2","github_search_repos","github_search_repos_v2","github_search_users","github_search_users_v2","github_star_gist","github_star_gist_v2","github_star_repo","github_star_repo_v2","github_status_check_rollup","github_trigger_workflow","github_trigger_workflow_v2","github_unstar_gist","github_unstar_gist_v2","github_unstar_repo","github_unstar_repo_v2","github_update_branch_protection","github_update_branch_protection_v2","github_update_comment","github_update_comment_v2","github_update_file","github_update_file_v2","github_update_gist","github_update_gist_v2","github_update_issue","github_update_issue_v2","github_update_milestone","github_update_milestone_v2","github_update_pr","github_update_pr_v2","github_update_project","github_update_project_v2","github_update_release","github_update_release_v2","gitlab_activate_user","gitlab_add_member","gitlab_add_saml_group_link","gitlab_approve_access_request","gitlab_approve_merge_request","gitlab_approve_user","gitlab_ban_user","gitlab_block_user","gitlab_cancel_pipeline","gitlab_compare_branches","gitlab_create_branch","gitlab_create_file","gitlab_create_issue","gitlab_create_issue_note","gitlab_create_merge_request","gitlab_create_merge_request_note","gitlab_create_pipeline","gitlab_create_release","gitlab_create_user","gitlab_deactivate_user","gitlab_delete_branch","gitlab_delete_issue","gitlab_delete_saml_group_link","gitlab_delete_user","gitlab_delete_user_identity","gitlab_deny_access_request","gitlab_get_file","gitlab_get_group","gitlab_get_issue","gitlab_get_job_log","gitlab_get_merge_request","gitlab_get_merge_request_changes","gitlab_get_pipeline","gitlab_get_project","gitlab_invite_member","gitlab_list_access_requests","gitlab_list_branches","gitlab_list_commits","gitlab_list_groups","gitlab_list_invitations","gitlab_list_issues","gitlab_list_members","gitlab_list_merge_requests","gitlab_list_pipeline_jobs","gitlab_list_pipelines","gitlab_list_projects","gitlab_list_releases","gitlab_list_repository_tree","gitlab_list_saml_group_links","gitlab_list_user_memberships","gitlab_merge_merge_request","gitlab_play_job","gitlab_reject_user","gitlab_remove_member","gitlab_retry_pipeline","gitlab_revoke_invitation","gitlab_search_users","gitlab_unban_user","gitlab_unblock_user","gitlab_update_file","gitlab_update_invitation","gitlab_update_issue","gitlab_update_member","gitlab_update_merge_request","gitlab_update_user","gmail_add_label","gmail_add_label_v2","gmail_archive","gmail_archive_v2","gmail_create_label_v2","gmail_delete","gmail_delete_draft_v2","gmail_delete_label_v2","gmail_delete_v2","gmail_draft","gmail_draft_v2","gmail_edit_draft_v2","gmail_get_draft_v2","gmail_get_thread_v2","gmail_list_drafts_v2","gmail_list_labels_v2","gmail_list_threads_v2","gmail_mark_read","gmail_mark_read_v2","gmail_mark_unread","gmail_mark_unread_v2","gmail_move","gmail_move_v2","gmail_read","gmail_read_v2","gmail_remove_label","gmail_remove_label_v2","gmail_search","gmail_search_v2","gmail_send","gmail_send_v2","gmail_trash_thread_v2","gmail_unarchive","gmail_unarchive_v2","gmail_untrash_thread_v2","gmail_update_label_v2","gong_aggregate_activity","gong_aggregate_by_period","gong_answered_scorecards","gong_ask_anything","gong_assign_flow_prospects","gong_create_call","gong_day_by_day_activity","gong_get_brief","gong_get_call","gong_get_call_transcript","gong_get_coaching","gong_get_extensive_calls","gong_get_folder_content","gong_get_logs","gong_get_prospect_flows","gong_get_user","gong_interaction_stats","gong_list_calls","gong_list_flows","gong_list_library_folders","gong_list_scorecards","gong_list_trackers","gong_list_users","gong_list_workspaces","gong_lookup_email","gong_lookup_phone","gong_purge_email_address","gong_purge_phone_number","gong_unassign_flow_prospects","google_ads_ad_performance","google_ads_campaign_performance","google_ads_list_ad_groups","google_ads_list_campaigns","google_ads_list_customers","google_ads_search","google_appsheet_add_rows","google_appsheet_delete_rows","google_appsheet_edit_rows","google_appsheet_find_rows","google_bigquery_create_dataset","google_bigquery_create_table","google_bigquery_delete_dataset","google_bigquery_delete_table","google_bigquery_get_query_results","google_bigquery_get_table","google_bigquery_insert_rows","google_bigquery_list_datasets","google_bigquery_list_table_data","google_bigquery_list_tables","google_bigquery_query","google_books_volume_details","google_books_volume_search","google_calendar_create","google_calendar_create_calendar","google_calendar_create_calendar_v2","google_calendar_create_v2","google_calendar_delete","google_calendar_delete_calendar","google_calendar_delete_calendar_v2","google_calendar_delete_v2","google_calendar_freebusy","google_calendar_freebusy_v2","google_calendar_get","google_calendar_get_v2","google_calendar_instances","google_calendar_instances_v2","google_calendar_invite","google_calendar_invite_v2","google_calendar_list","google_calendar_list_acl","google_calendar_list_acl_v2","google_calendar_list_calendars","google_calendar_list_calendars_v2","google_calendar_list_v2","google_calendar_move","google_calendar_move_v2","google_calendar_quick_add","google_calendar_quick_add_v2","google_calendar_share_calendar","google_calendar_share_calendar_v2","google_calendar_unshare_calendar","google_calendar_unshare_calendar_v2","google_calendar_update","google_calendar_update_acl","google_calendar_update_acl_v2","google_calendar_update_calendar","google_calendar_update_calendar_v2","google_calendar_update_v2","google_contacts_create","google_contacts_delete","google_contacts_get","google_contacts_list","google_contacts_search","google_contacts_update","google_docs_create","google_docs_create_named_range","google_docs_create_paragraph_bullets","google_docs_delete_content_range","google_docs_delete_named_range","google_docs_delete_paragraph_bullets","google_docs_insert_image","google_docs_insert_page_break","google_docs_insert_table","google_docs_insert_text","google_docs_read","google_docs_replace_text","google_docs_update_paragraph_style","google_docs_update_text_style","google_docs_write","google_drive_copy","google_drive_create_comment","google_drive_create_folder","google_drive_delete","google_drive_delete_comment","google_drive_download","google_drive_export","google_drive_get_about","google_drive_get_content","google_drive_get_file","google_drive_get_revision","google_drive_list","google_drive_list_comments","google_drive_list_permissions","google_drive_list_revisions","google_drive_move","google_drive_search","google_drive_share","google_drive_trash","google_drive_unshare","google_drive_untrash","google_drive_update","google_drive_upload","google_forms_batch_update","google_forms_create_form","google_forms_create_watch","google_forms_delete_watch","google_forms_get_form","google_forms_get_responses","google_forms_list_watches","google_forms_renew_watch","google_forms_set_publish_settings","google_groups_add_alias","google_groups_add_member","google_groups_create_group","google_groups_delete_group","google_groups_get_group","google_groups_get_member","google_groups_get_settings","google_groups_has_member","google_groups_list_aliases","google_groups_list_groups","google_groups_list_members","google_groups_remove_alias","google_groups_remove_member","google_groups_update_group","google_groups_update_member","google_groups_update_settings","google_maps_air_quality","google_maps_directions","google_maps_distance_matrix","google_maps_elevation","google_maps_geocode","google_maps_geolocate","google_maps_place_details","google_maps_places_nearby","google_maps_places_search","google_maps_pollen","google_maps_reverse_geocode","google_maps_snap_to_roads","google_maps_solar","google_maps_speed_limits","google_maps_timezone","google_maps_validate_address","google_meet_create_space","google_meet_end_conference","google_meet_get_conference_record","google_meet_get_space","google_meet_list_conference_records","google_meet_list_participants","google_pagespeed_analyze","google_search","google_sheets_append","google_sheets_append_v2","google_sheets_batch_clear_v2","google_sheets_batch_get_v2","google_sheets_batch_update_v2","google_sheets_clear_v2","google_sheets_copy_sheet_v2","google_sheets_create_spreadsheet_v2","google_sheets_delete_rows_v2","google_sheets_delete_sheet_v2","google_sheets_delete_spreadsheet_v2","google_sheets_get_spreadsheet_v2","google_sheets_read","google_sheets_read_v2","google_sheets_update","google_sheets_update_v2","google_sheets_write","google_sheets_write_v2","google_slides_add_image","google_slides_add_slide","google_slides_batch_update","google_slides_copy_presentation","google_slides_create","google_slides_create_line","google_slides_create_paragraph_bullets","google_slides_create_shape","google_slides_create_sheets_chart","google_slides_create_table","google_slides_create_video","google_slides_delete_object","google_slides_delete_paragraph_bullets","google_slides_delete_table_column","google_slides_delete_table_row","google_slides_delete_text","google_slides_duplicate_object","google_slides_export_presentation","google_slides_get_page","google_slides_get_thumbnail","google_slides_group_objects","google_slides_insert_table_columns","google_slides_insert_table_rows","google_slides_insert_text","google_slides_merge_table_cells","google_slides_read","google_slides_refresh_sheets_chart","google_slides_replace_all_shapes_with_image","google_slides_replace_all_shapes_with_sheets_chart","google_slides_replace_all_text","google_slides_replace_image","google_slides_reroute_line","google_slides_ungroup_objects","google_slides_unmerge_table_cells","google_slides_update_image_properties","google_slides_update_line_category","google_slides_update_line_properties","google_slides_update_page_element_alt_text","google_slides_update_page_element_transform","google_slides_update_page_elements_z_order","google_slides_update_page_properties","google_slides_update_paragraph_style","google_slides_update_shape_properties","google_slides_update_slide_properties","google_slides_update_slides_position","google_slides_update_table_border_properties","google_slides_update_table_cell_properties","google_slides_update_table_column_properties","google_slides_update_table_row_properties","google_slides_update_text_style","google_slides_update_video_properties","google_slides_write","google_tasks_create","google_tasks_delete","google_tasks_get","google_tasks_list","google_tasks_list_task_lists","google_tasks_update","google_translate_detect","google_translate_text","google_vault_add_held_accounts","google_vault_add_matters_permissions","google_vault_close_matters","google_vault_create_matters","google_vault_create_matters_export","google_vault_create_matters_holds","google_vault_create_saved_query","google_vault_delete_matters","google_vault_delete_matters_export","google_vault_delete_matters_holds","google_vault_delete_saved_query","google_vault_download_export_file","google_vault_list_matters","google_vault_list_matters_export","google_vault_list_matters_holds","google_vault_list_saved_queries","google_vault_remove_held_accounts","google_vault_remove_matters_permissions","google_vault_reopen_matters","google_vault_undelete_matters","google_vault_update_matters","google_vault_update_matters_holds","grafana_check_data_source_health","grafana_create_alert_rule","grafana_create_annotation","grafana_create_contact_point","grafana_create_dashboard","grafana_create_folder","grafana_delete_alert_rule","grafana_delete_annotation","grafana_delete_dashboard","grafana_delete_folder","grafana_get_alert_rule","grafana_get_dashboard","grafana_get_data_source","grafana_get_folder","grafana_get_health","grafana_list_alert_rules","grafana_list_annotations","grafana_list_contact_points","grafana_list_dashboards","grafana_list_data_sources","grafana_list_folders","grafana_update_alert_rule","grafana_update_annotation","grafana_update_dashboard","grafana_update_folder","grain_create_hook","grain_create_hook_v2","grain_delete_hook","grain_delete_hook_v2","grain_get_recording","grain_get_transcript","grain_list_hooks","grain_list_hooks_v2","grain_list_meeting_types","grain_list_recordings","grain_list_teams","grain_list_views","granola_get_note","granola_list_folders","granola_list_notes","greenhouse_get_application","greenhouse_get_candidate","greenhouse_get_job","greenhouse_get_user","greenhouse_list_applications","greenhouse_list_candidates","greenhouse_list_departments","greenhouse_list_job_stages","greenhouse_list_jobs","greenhouse_list_offices","greenhouse_list_users","greptile_index_repo","greptile_query","greptile_search","greptile_status","guardrails_validate","hex_cancel_run","hex_create_collection","hex_create_group","hex_deactivate_user","hex_delete_group","hex_get_collection","hex_get_data_connection","hex_get_group","hex_get_project","hex_get_project_runs","hex_get_queried_tables","hex_get_run_status","hex_list_collections","hex_list_data_connections","hex_list_groups","hex_list_projects","hex_list_users","hex_run_project","hex_update_collection","hex_update_group","hex_update_project","http_request","hubspot_add_list_memberships","hubspot_create_appointment","hubspot_create_association","hubspot_create_company","hubspot_create_contact","hubspot_create_deal","hubspot_create_email","hubspot_create_line_item","hubspot_create_list","hubspot_create_note","hubspot_create_ticket","hubspot_delete_association","hubspot_delete_company","hubspot_delete_contact","hubspot_delete_deal","hubspot_delete_line_item","hubspot_delete_ticket","hubspot_get_appointment","hubspot_get_association_labels","hubspot_get_cart","hubspot_get_company","hubspot_get_contact","hubspot_get_deal","hubspot_get_email","hubspot_get_line_item","hubspot_get_list","hubspot_get_list_memberships","hubspot_get_marketing_event","hubspot_get_note","hubspot_get_properties","hubspot_get_quote","hubspot_get_ticket","hubspot_get_users","hubspot_list_appointments","hubspot_list_associations","hubspot_list_carts","hubspot_list_companies","hubspot_list_contacts","hubspot_list_deals","hubspot_list_emails","hubspot_list_line_items","hubspot_list_lists","hubspot_list_marketing_events","hubspot_list_notes","hubspot_list_owners","hubspot_list_quotes","hubspot_list_tickets","hubspot_remove_list_memberships","hubspot_search_companies","hubspot_search_contacts","hubspot_search_deals","hubspot_search_emails","hubspot_search_line_items","hubspot_search_notes","hubspot_search_quotes","hubspot_search_tickets","hubspot_update_appointment","hubspot_update_company","hubspot_update_contact","hubspot_update_deal","hubspot_update_line_item","hubspot_update_ticket","huggingface_chat","hunter_companies_find","hunter_discover","hunter_domain_search","hunter_email_count","hunter_email_finder","hunter_email_verifier","iam_add_user_to_group","iam_attach_role_policy","iam_attach_user_policy","iam_create_access_key","iam_create_role","iam_create_user","iam_delete_access_key","iam_delete_role","iam_delete_user","iam_detach_role_policy","iam_detach_user_policy","iam_get_role","iam_get_user","iam_list_attached_role_policies","iam_list_attached_user_policies","iam_list_groups","iam_list_policies","iam_list_roles","iam_list_users","iam_remove_user_from_group","iam_simulate_principal_policy","icypeas_find_email","icypeas_verify_email","identity_center_check_assignment_deletion_status","identity_center_check_assignment_status","identity_center_create_account_assignment","identity_center_delete_account_assignment","identity_center_describe_account","identity_center_get_group","identity_center_get_user","identity_center_list_account_assignments","identity_center_list_accounts","identity_center_list_groups","identity_center_list_instances","identity_center_list_permission_sets","image_generate","incidentio_actions_list","incidentio_actions_show","incidentio_custom_fields_create","incidentio_custom_fields_delete","incidentio_custom_fields_list","incidentio_custom_fields_show","incidentio_custom_fields_update","incidentio_escalation_paths_create","incidentio_escalation_paths_delete","incidentio_escalation_paths_list","incidentio_escalation_paths_show","incidentio_escalation_paths_update","incidentio_escalations_create","incidentio_escalations_list","incidentio_escalations_show","incidentio_follow_ups_list","incidentio_follow_ups_show","incidentio_incident_roles_create","incidentio_incident_roles_delete","incidentio_incident_roles_list","incidentio_incident_roles_show","incidentio_incident_roles_update","incidentio_incident_statuses_list","incidentio_incident_timestamps_list","incidentio_incident_timestamps_show","incidentio_incident_types_list","incidentio_incident_updates_list","incidentio_incidents_create","incidentio_incidents_list","incidentio_incidents_show","incidentio_incidents_update","incidentio_schedule_entries_list","incidentio_schedule_overrides_create","incidentio_schedules_create","incidentio_schedules_delete","incidentio_schedules_list","incidentio_schedules_show","incidentio_schedules_update","incidentio_severities_list","incidentio_users_list","incidentio_users_show","incidentio_workflows_create","incidentio_workflows_delete","incidentio_workflows_list","incidentio_workflows_show","incidentio_workflows_update","infisical_create_secret","infisical_delete_secret","infisical_get_secret","infisical_list_secrets","infisical_update_secret","instagram_delete_comment","instagram_download_media","instagram_get_account_insights","instagram_get_container_status","instagram_get_conversation_messages","instagram_get_media","instagram_get_media_insights","instagram_get_message","instagram_get_profile","instagram_get_publishing_limit","instagram_hide_comment","instagram_list_comments","instagram_list_conversations","instagram_list_media","instagram_list_stories","instagram_private_reply","instagram_publish_carousel","instagram_publish_image","instagram_publish_reel","instagram_publish_story","instagram_publish_video","instagram_reply_to_comment","instagram_send_text_message","instagram_set_comments_enabled","instantly_activate_campaign","instantly_create_campaign","instantly_create_lead","instantly_create_lead_list","instantly_delete_campaign","instantly_delete_leads","instantly_get_lead","instantly_list_campaigns","instantly_list_emails","instantly_list_lead_lists","instantly_list_leads","instantly_patch_campaign","instantly_patch_lead","instantly_pause_campaign","instantly_reply_to_email","instantly_update_lead_interest_status","intercom_assign_conversation_v2","intercom_attach_contact_to_company_v2","intercom_close_conversation_v2","intercom_create_company","intercom_create_company_v2","intercom_create_contact","intercom_create_contact_v2","intercom_create_event_v2","intercom_create_message","intercom_create_message_v2","intercom_create_note_v2","intercom_create_tag_v2","intercom_create_ticket","intercom_create_ticket_v2","intercom_delete_contact","intercom_delete_contact_v2","intercom_detach_contact_from_company_v2","intercom_get_company","intercom_get_company_v2","intercom_get_contact","intercom_get_contact_v2","intercom_get_conversation","intercom_get_conversation_v2","intercom_get_ticket","intercom_get_ticket_v2","intercom_list_admins_v2","intercom_list_companies","intercom_list_companies_v2","intercom_list_contacts","intercom_list_contacts_v2","intercom_list_conversations","intercom_list_conversations_v2","intercom_list_tags_v2","intercom_open_conversation_v2","intercom_reply_conversation","intercom_reply_conversation_v2","intercom_search_contacts","intercom_search_contacts_v2","intercom_search_conversations","intercom_search_conversations_v2","intercom_snooze_conversation_v2","intercom_tag_contact_v2","intercom_tag_conversation_v2","intercom_untag_contact_v2","intercom_update_contact","intercom_update_contact_v2","intercom_update_ticket_v2","jina_read_url","jina_search","jira_add_attachment","jira_add_comment","jira_add_watcher","jira_add_worklog","jira_assign_issue","jira_bulk_read","jira_create_issue_link","jira_delete_attachment","jira_delete_comment","jira_delete_issue","jira_delete_issue_link","jira_delete_worklog","jira_get_attachments","jira_get_comments","jira_get_fields","jira_get_project","jira_get_transitions","jira_get_users","jira_get_worklogs","jira_list_issue_types","jira_list_projects","jira_remove_watcher","jira_retrieve","jira_search_issues","jira_search_users","jira_transition_issue","jira_update","jira_update_comment","jira_update_worklog","jira_write","jsm_add_comment","jsm_add_customer","jsm_add_organization","jsm_add_participants","jsm_answer_approval","jsm_attach_form","jsm_copy_forms","jsm_create_object","jsm_create_organization","jsm_create_request","jsm_delete_form","jsm_delete_object","jsm_externalise_form","jsm_get_approvals","jsm_get_comments","jsm_get_customers","jsm_get_form","jsm_get_form_answers","jsm_get_form_structure","jsm_get_form_templates","jsm_get_issue_forms","jsm_get_object","jsm_get_object_schema","jsm_get_object_type_attributes","jsm_get_organizations","jsm_get_participants","jsm_get_queues","jsm_get_request","jsm_get_request_type_fields","jsm_get_request_types","jsm_get_requests","jsm_get_service_desks","jsm_get_sla","jsm_get_transitions","jsm_internalise_form","jsm_list_object_schemas","jsm_list_object_types","jsm_reopen_form","jsm_save_form_answers","jsm_search_objects_aql","jsm_submit_form","jsm_transition_request","jsm_update_object","jupyter_copy_content","jupyter_create_file","jupyter_create_session","jupyter_delete_content","jupyter_delete_session","jupyter_get_content","jupyter_interrupt_kernel","jupyter_list_contents","jupyter_list_kernels","jupyter_list_kernelspecs","jupyter_list_sessions","jupyter_rename_content","jupyter_restart_kernel","jupyter_start_kernel","jupyter_stop_kernel","jupyter_upload_file","kalshi_amend_order","kalshi_amend_order_v2","kalshi_cancel_order","kalshi_cancel_order_v2","kalshi_create_order","kalshi_create_order_v2","kalshi_get_balance","kalshi_get_balance_v2","kalshi_get_candlesticks","kalshi_get_candlesticks_v2","kalshi_get_event","kalshi_get_event_candlesticks","kalshi_get_event_candlesticks_v2","kalshi_get_event_v2","kalshi_get_events","kalshi_get_events_v2","kalshi_get_exchange_announcements","kalshi_get_exchange_announcements_v2","kalshi_get_exchange_schedule","kalshi_get_exchange_schedule_v2","kalshi_get_exchange_status","kalshi_get_exchange_status_v2","kalshi_get_fills","kalshi_get_fills_v2","kalshi_get_market","kalshi_get_market_v2","kalshi_get_markets","kalshi_get_markets_v2","kalshi_get_order","kalshi_get_order_v2","kalshi_get_orderbook","kalshi_get_orderbook_v2","kalshi_get_orders","kalshi_get_orders_v2","kalshi_get_positions","kalshi_get_positions_v2","kalshi_get_series_by_ticker","kalshi_get_series_by_ticker_v2","kalshi_get_series_list","kalshi_get_series_list_v2","kalshi_get_settlements","kalshi_get_settlements_v2","kalshi_get_trades","kalshi_get_trades_v2","ketch_get_consent","ketch_get_subscriptions","ketch_invoke_right","ketch_set_consent","ketch_set_subscriptions","knowledge_create_document","knowledge_delete_chunk","knowledge_delete_document","knowledge_get_connector","knowledge_get_document","knowledge_list_chunks","knowledge_list_connectors","knowledge_list_documents","knowledge_list_tags","knowledge_search","knowledge_trigger_sync","knowledge_update_chunk","knowledge_upload_chunk","knowledge_upsert_document","langsmith_create_feedback","langsmith_create_run","langsmith_create_runs_batch","langsmith_get_run","langsmith_update_run","latex_compile","latex_get_package","latex_list_fonts","latex_search_packages","launchdarkly_create_flag","launchdarkly_delete_flag","launchdarkly_get_audit_log","launchdarkly_get_flag","launchdarkly_get_flag_status","launchdarkly_list_environments","launchdarkly_list_flags","launchdarkly_list_members","launchdarkly_list_projects","launchdarkly_list_segments","launchdarkly_toggle_flag","launchdarkly_update_flag","leadmagic_company_search","leadmagic_email_to_profile","leadmagic_find_email","leadmagic_find_mobile","leadmagic_get_credits","leadmagic_profile_search","leadmagic_profile_to_email","leadmagic_role_finder","leadmagic_validate_email","lemlist_get_activities","lemlist_get_lead","lemlist_send_email","linear_add_label_to_issue","linear_add_label_to_project","linear_archive_issue","linear_archive_label","linear_archive_project","linear_create_attachment","linear_create_comment","linear_create_customer","linear_create_customer_request","linear_create_customer_status","linear_create_customer_tier","linear_create_cycle","linear_create_favorite","linear_create_issue","linear_create_issue_relation","linear_create_label","linear_create_project","linear_create_project_label","linear_create_project_milestone","linear_create_project_status","linear_create_project_update","linear_create_workflow_state","linear_delete_attachment","linear_delete_comment","linear_delete_customer","linear_delete_customer_status","linear_delete_customer_tier","linear_delete_issue","linear_delete_issue_relation","linear_delete_project","linear_delete_project_label","linear_delete_project_milestone","linear_delete_project_status","linear_get_active_cycle","linear_get_customer","linear_get_cycle","linear_get_issue","linear_get_project","linear_get_viewer","linear_list_attachments","linear_list_comments","linear_list_customer_requests","linear_list_customer_statuses","linear_list_customer_tiers","linear_list_customers","linear_list_cycles","linear_list_favorites","linear_list_issue_relations","linear_list_labels","linear_list_notifications","linear_list_project_labels","linear_list_project_milestones","linear_list_project_statuses","linear_list_project_updates","linear_list_projects","linear_list_teams","linear_list_users","linear_list_workflow_states","linear_merge_customers","linear_read_issues","linear_remove_label_from_issue","linear_remove_label_from_project","linear_search_issues","linear_unarchive_issue","linear_update_attachment","linear_update_comment","linear_update_customer","linear_update_customer_request","linear_update_customer_status","linear_update_customer_tier","linear_update_issue","linear_update_label","linear_update_notification","linear_update_project","linear_update_project_label","linear_update_project_milestone","linear_update_project_status","linear_update_workflow_state","linkedin_get_profile","linkedin_share_post","linkup_search","linq_add_participant","linq_check_imessage","linq_check_rcs","linq_create_attachment","linq_create_chat","linq_create_contact_card","linq_create_webhook_subscription","linq_delete_attachment","linq_delete_message","linq_delete_webhook_subscription","linq_edit_message","linq_get_attachment","linq_get_chat","linq_get_contact_card","linq_get_message","linq_get_webhook_subscription","linq_leave_chat","linq_list_chats","linq_list_messages","linq_list_phone_numbers","linq_list_thread","linq_list_webhook_events","linq_list_webhook_subscriptions","linq_mark_chat_read","linq_react_to_message","linq_remove_participant","linq_send_message","linq_send_voice_memo","linq_share_contact_card","linq_start_typing","linq_stop_typing","linq_update_chat","linq_update_contact_card","linq_update_webhook_subscription","llm_chat","logfire_get_token_info","logfire_get_trace","logfire_query","logfire_search_records","logs_get","logs_get_execution","logs_get_run_details","logs_query","logs_query_runs","loops_check_contact_suppression","loops_create_contact","loops_create_contact_property","loops_delete_contact","loops_find_contact","loops_get_transactional_email","loops_list_contact_properties","loops_list_mailing_lists","loops_list_transactional_emails","loops_remove_contact_suppression","loops_send_event","loops_send_transactional_email","loops_update_contact","luma_add_guests","luma_cancel_event","luma_create_event","luma_get_event","luma_get_guest","luma_get_guests","luma_list_events","luma_lookup_event","luma_send_invites","luma_update_event","luma_update_guest_status","mailchimp_add_member","mailchimp_add_member_tags","mailchimp_add_or_update_member","mailchimp_add_segment_member","mailchimp_add_subscriber_to_automation","mailchimp_archive_member","mailchimp_create_audience","mailchimp_create_batch_operation","mailchimp_create_campaign","mailchimp_create_interest","mailchimp_create_interest_category","mailchimp_create_landing_page","mailchimp_create_merge_field","mailchimp_create_segment","mailchimp_create_template","mailchimp_delete_audience","mailchimp_delete_batch_operation","mailchimp_delete_campaign","mailchimp_delete_interest","mailchimp_delete_interest_category","mailchimp_delete_landing_page","mailchimp_delete_member","mailchimp_delete_merge_field","mailchimp_delete_segment","mailchimp_delete_template","mailchimp_get_audience","mailchimp_get_audiences","mailchimp_get_automation","mailchimp_get_automations","mailchimp_get_batch_operation","mailchimp_get_batch_operations","mailchimp_get_campaign","mailchimp_get_campaign_content","mailchimp_get_campaign_report","mailchimp_get_campaign_reports","mailchimp_get_campaigns","mailchimp_get_interest","mailchimp_get_interest_categories","mailchimp_get_interest_category","mailchimp_get_interests","mailchimp_get_landing_page","mailchimp_get_landing_pages","mailchimp_get_member","mailchimp_get_member_tags","mailchimp_get_members","mailchimp_get_merge_field","mailchimp_get_merge_fields","mailchimp_get_segment","mailchimp_get_segment_members","mailchimp_get_segments","mailchimp_get_template","mailchimp_get_templates","mailchimp_pause_automation","mailchimp_publish_landing_page","mailchimp_remove_member_tags","mailchimp_remove_segment_member","mailchimp_replicate_campaign","mailchimp_schedule_campaign","mailchimp_send_campaign","mailchimp_set_campaign_content","mailchimp_start_automation","mailchimp_unarchive_member","mailchimp_unpublish_landing_page","mailchimp_unschedule_campaign","mailchimp_update_audience","mailchimp_update_campaign","mailchimp_update_interest","mailchimp_update_interest_category","mailchimp_update_landing_page","mailchimp_update_member","mailchimp_update_merge_field","mailchimp_update_segment","mailchimp_update_template","mailgun_add_list_member","mailgun_create_mailing_list","mailgun_get_domain","mailgun_get_mailing_list","mailgun_get_message","mailgun_list_domains","mailgun_list_messages","mailgun_send_message","managed_agent_archive_session","managed_agent_create_session","managed_agent_delete_session","managed_agent_get_session","managed_agent_interrupt_session","managed_agent_list_events","managed_agent_respond_custom_tool","managed_agent_respond_tool_confirmation","managed_agent_run_session","managed_agent_send_message","managed_agent_update_session","mem0_add_memories","mem0_get_memories","mem0_search_memories","memory_add","memory_delete","memory_get","memory_get_all","microsoft_ad_add_group_member","microsoft_ad_create_group","microsoft_ad_create_user","microsoft_ad_delete_group","microsoft_ad_delete_user","microsoft_ad_get_group","microsoft_ad_get_user","microsoft_ad_list_group_members","microsoft_ad_list_groups","microsoft_ad_list_users","microsoft_ad_remove_group_member","microsoft_ad_update_group","microsoft_ad_update_user","microsoft_dataverse_associate","microsoft_dataverse_create_multiple","microsoft_dataverse_create_record","microsoft_dataverse_delete_record","microsoft_dataverse_disassociate","microsoft_dataverse_download_file","microsoft_dataverse_execute_action","microsoft_dataverse_execute_function","microsoft_dataverse_fetchxml_query","microsoft_dataverse_get_entity_metadata","microsoft_dataverse_get_record","microsoft_dataverse_list_records","microsoft_dataverse_search","microsoft_dataverse_update_multiple","microsoft_dataverse_update_record","microsoft_dataverse_upload_file","microsoft_dataverse_upsert_record","microsoft_dataverse_whoami","microsoft_excel_clear_range","microsoft_excel_create_table","microsoft_excel_delete_worksheet","microsoft_excel_format_range","microsoft_excel_read","microsoft_excel_read_v2","microsoft_excel_sort_range","microsoft_excel_table_add","microsoft_excel_worksheet_add","microsoft_excel_write","microsoft_excel_write_v2","microsoft_planner_create_bucket","microsoft_planner_create_plan","microsoft_planner_create_task","microsoft_planner_delete_bucket","microsoft_planner_delete_plan","microsoft_planner_delete_task","microsoft_planner_get_plan_details","microsoft_planner_get_task_details","microsoft_planner_list_buckets","microsoft_planner_list_plans","microsoft_planner_read_bucket","microsoft_planner_read_plan","microsoft_planner_read_task","microsoft_planner_update_bucket","microsoft_planner_update_plan","microsoft_planner_update_plan_details","microsoft_planner_update_task","microsoft_planner_update_task_details","microsoft_teams_delete_channel_message","microsoft_teams_delete_chat_message","microsoft_teams_get_message","microsoft_teams_list_channel_members","microsoft_teams_list_channels","microsoft_teams_list_chat_members","microsoft_teams_list_chats","microsoft_teams_list_team_members","microsoft_teams_list_teams","microsoft_teams_read_channel","microsoft_teams_read_chat","microsoft_teams_reply_to_message","microsoft_teams_set_reaction","microsoft_teams_unset_reaction","microsoft_teams_update_channel_message","microsoft_teams_update_chat_message","microsoft_teams_write_channel","microsoft_teams_write_chat","millionverifier_get_credits","millionverifier_verify_email","mistral_parser","mistral_parser_v2","mistral_parser_v3","monday_archive_item","monday_change_column_value","monday_create_board","monday_create_column","monday_create_group","monday_create_item","monday_create_subitem","monday_create_update","monday_delete_item","monday_duplicate_item","monday_get_board","monday_get_groups","monday_get_item","monday_get_items","monday_list_boards","monday_move_item_to_group","monday_search_items","monday_update_item","mongodb_delete","mongodb_execute","mongodb_insert","mongodb_introspect","mongodb_query","mongodb_update","mysql_delete","mysql_execute","mysql_insert","mysql_introspect","mysql_query","mysql_update","neo4j_create","neo4j_delete","neo4j_execute","neo4j_introspect","neo4j_merge","neo4j_query","neo4j_update","neverbounce_get_credits","neverbounce_verify_email","new_relic_create_deployment_event","new_relic_get_entity","new_relic_nrql_query","new_relic_search_entities","notion_add_database_row","notion_add_database_row_v2","notion_append_blocks","notion_append_blocks_v2","notion_create_comment","notion_create_comment_v2","notion_create_database","notion_create_database_v2","notion_create_page","notion_create_page_v2","notion_delete_block","notion_delete_block_v2","notion_list_comments","notion_list_comments_v2","notion_list_users","notion_list_users_v2","notion_query_database","notion_query_database_v2","notion_read","notion_read_database","notion_read_database_v2","notion_read_v2","notion_retrieve_block","notion_retrieve_block_children","notion_retrieve_block_children_v2","notion_retrieve_block_v2","notion_retrieve_user","notion_retrieve_user_v2","notion_search","notion_search_v2","notion_update_block","notion_update_block_v2","notion_update_page","notion_update_page_v2","notion_write","notion_write_v2","obsidian_append_active","obsidian_append_note","obsidian_append_periodic_note","obsidian_create_note","obsidian_delete_note","obsidian_execute_command","obsidian_get_active","obsidian_get_note","obsidian_get_periodic_note","obsidian_list_commands","obsidian_list_files","obsidian_open_file","obsidian_patch_active","obsidian_patch_note","obsidian_search","okta_activate_user","okta_add_user_to_group","okta_create_group","okta_create_user","okta_deactivate_user","okta_delete_group","okta_delete_user","okta_get_group","okta_get_user","okta_list_group_members","okta_list_groups","okta_list_users","okta_remove_user_from_group","okta_reset_password","okta_suspend_user","okta_unsuspend_user","okta_update_group","okta_update_user","onedrive_copy","onedrive_create_folder","onedrive_create_share_link","onedrive_delete","onedrive_download","onedrive_get_drive_info","onedrive_get_item","onedrive_list","onedrive_move","onedrive_search","onedrive_upload","onepassword_create_item","onepassword_delete_item","onepassword_get_item","onepassword_get_item_file","onepassword_get_vault","onepassword_list_items","onepassword_list_vaults","onepassword_replace_item","onepassword_resolve_secret","onepassword_update_item","openai_embeddings","openai_image","outlook_calendar_create_event","outlook_calendar_delete_event","outlook_calendar_get_event","outlook_calendar_list_events","outlook_calendar_respond","outlook_calendar_update_event","outlook_copy","outlook_create_folder","outlook_delete","outlook_draft","outlook_forward","outlook_get_attachment","outlook_list_attachments","outlook_list_folders","outlook_mark_read","outlook_mark_unread","outlook_move","outlook_read","outlook_reply","outlook_reply_all","outlook_search","outlook_send","outlook_update_message","pagerduty_add_note","pagerduty_create_incident","pagerduty_get_incident","pagerduty_get_service","pagerduty_list_escalation_policies","pagerduty_list_incident_alerts","pagerduty_list_incidents","pagerduty_list_oncalls","pagerduty_list_schedules","pagerduty_list_services","pagerduty_list_users","pagerduty_merge_incidents","pagerduty_send_event","pagerduty_snooze_incident","pagerduty_update_incident","parallel_deep_research","parallel_extract","parallel_search","pdl_autocomplete","pdl_bulk_company_enrich","pdl_bulk_person_enrich","pdl_clean_company","pdl_clean_location","pdl_clean_school","pdl_company_enrich","pdl_company_search","pdl_person_enrich","pdl_person_identify","pdl_person_search","perplexity_chat","perplexity_search","persona_approve_inquiry","persona_create_account","persona_create_inquiry","persona_create_report","persona_decline_inquiry","persona_expire_inquiry","persona_generate_inquiry_link","persona_get_account","persona_get_case","persona_get_document","persona_get_inquiry","persona_get_report","persona_get_verification","persona_import_accounts","persona_list_accounts","persona_list_cases","persona_list_inquiries","persona_list_inquiry_templates","persona_list_reports","persona_mark_inquiry_for_review","persona_print_inquiry_pdf","persona_redact_account","persona_redact_inquiry","persona_resume_inquiry","persona_update_account","persona_update_inquiry","pinecone_delete_vectors","pinecone_describe_index","pinecone_describe_index_stats","pinecone_fetch","pinecone_generate_embeddings","pinecone_list_indexes","pinecone_list_vector_ids","pinecone_search_text","pinecone_search_vector","pinecone_update_vector","pinecone_upsert_text","pipedrive_create_activity","pipedrive_create_deal","pipedrive_create_lead","pipedrive_create_project","pipedrive_delete_lead","pipedrive_get_activities","pipedrive_get_all_deals","pipedrive_get_deal","pipedrive_get_files","pipedrive_get_leads","pipedrive_get_mail_messages","pipedrive_get_mail_thread","pipedrive_get_pipeline_deals","pipedrive_get_pipelines","pipedrive_get_projects","pipedrive_update_activity","pipedrive_update_deal","pipedrive_update_lead","polymarket_get_activity","polymarket_get_event","polymarket_get_events","polymarket_get_holders","polymarket_get_last_trade_price","polymarket_get_leaderboard","polymarket_get_market","polymarket_get_markets","polymarket_get_midpoint","polymarket_get_orderbook","polymarket_get_positions","polymarket_get_price","polymarket_get_price_history","polymarket_get_series","polymarket_get_series_by_id","polymarket_get_spread","polymarket_get_tags","polymarket_get_tick_size","polymarket_get_trades","polymarket_search","postgresql_delete","postgresql_execute","postgresql_insert","postgresql_introspect","postgresql_query","postgresql_update","posthog_batch_events","posthog_capture_event","posthog_create_annotation","posthog_create_cohort","posthog_create_dashboard","posthog_create_experiment","posthog_create_feature_flag","posthog_create_insight","posthog_create_survey","posthog_delete_feature_flag","posthog_delete_person","posthog_delete_survey","posthog_evaluate_flags","posthog_get_cohort","posthog_get_dashboard","posthog_get_event_definition","posthog_get_experiment","posthog_get_feature_flag","posthog_get_insight","posthog_get_organization","posthog_get_person","posthog_get_project","posthog_get_property_definition","posthog_get_session_recording","posthog_get_survey","posthog_list_actions","posthog_list_annotations","posthog_list_cohorts","posthog_list_dashboards","posthog_list_event_definitions","posthog_list_experiments","posthog_list_feature_flags","posthog_list_insights","posthog_list_organizations","posthog_list_persons","posthog_list_projects","posthog_list_property_definitions","posthog_list_recording_playlists","posthog_list_session_recordings","posthog_list_surveys","posthog_query","posthog_update_cohort","posthog_update_event_definition","posthog_update_experiment","posthog_update_feature_flag","posthog_update_insight","posthog_update_property_definition","posthog_update_survey","profound_bot_logs","profound_bots_report","profound_category_assets","profound_category_personas","profound_category_prompts","profound_category_tags","profound_category_topics","profound_citation_prompts","profound_citations_report","profound_list_assets","profound_list_categories","profound_list_domains","profound_list_models","profound_list_optimizations","profound_list_personas","profound_list_regions","profound_optimization_analysis","profound_prompt_answers","profound_prompt_volume","profound_query_fanouts","profound_raw_logs","profound_referrals_report","profound_sentiment_report","profound_visibility_report","prospeo_account_information","prospeo_bulk_enrich_company","prospeo_bulk_enrich_person","prospeo_enrich_company","prospeo_enrich_person","prospeo_search_company","prospeo_search_person","prospeo_search_suggestions","pulse_parser","pulse_parser_v2","qdrant_fetch_points","qdrant_search_vector","qdrant_upsert_points","quartr_get_audio","quartr_get_company","quartr_get_event","quartr_get_event_summary","quartr_get_report","quartr_get_slide_deck","quartr_get_transcript","quartr_list_audio","quartr_list_companies","quartr_list_document_types","quartr_list_documents","quartr_list_event_types","quartr_list_events","quartr_list_live_events","quartr_list_reports","quartr_list_slide_decks","quartr_list_transcripts","quiver_image_to_svg","quiver_list_models","quiver_text_to_svg","railway_create_environment","railway_create_project","railway_create_service","railway_delete_environment","railway_delete_project","railway_delete_service","railway_delete_variable","railway_deploy_service","railway_get_deployment","railway_get_deployment_logs","railway_get_project","railway_list_deployments","railway_list_project_members","railway_list_projects","railway_list_variables","railway_restart_deployment","railway_rollback_deployment","railway_transfer_project","railway_update_project","railway_upsert_variable","rb2b_credit_check","rb2b_email_to_activity","rb2b_hem_to_best_linkedin","rb2b_hem_to_business_profile","rb2b_hem_to_linkedin","rb2b_hem_to_maid","rb2b_ip_to_company","rb2b_ip_to_hem","rb2b_ip_to_maid","rb2b_linkedin_slug_search","rb2b_linkedin_to_best_personal_email","rb2b_linkedin_to_business_profile","rb2b_linkedin_to_hashed_emails","rb2b_linkedin_to_mobile_phone","rb2b_linkedin_to_personal_email","rds_delete","rds_execute","rds_insert","rds_introspect","rds_query","rds_update","reddit_delete","reddit_edit","reddit_get_comments","reddit_get_controversial","reddit_get_info","reddit_get_me","reddit_get_messages","reddit_get_posts","reddit_get_saved","reddit_get_subreddit_info","reddit_get_subreddit_rules","reddit_get_user","reddit_get_user_comments","reddit_get_user_posts","reddit_hide","reddit_hot_posts","reddit_list_my_subreddits","reddit_lock","reddit_mark_all_read","reddit_mark_read","reddit_marknsfw","reddit_mod_approve","reddit_mod_distinguish","reddit_mod_remove","reddit_mod_sticky","reddit_reply","reddit_report","reddit_save","reddit_search","reddit_search_subreddits","reddit_send_message","reddit_submit_post","reddit_subscribe","reddit_unhide","reddit_unlock","reddit_unmarknsfw","reddit_unsave","reddit_vote","redis_command","redis_delete","redis_exists","redis_expire","redis_get","redis_hdel","redis_hget","redis_hgetall","redis_hset","redis_incr","redis_incrby","redis_keys","redis_llen","redis_lpop","redis_lpush","redis_lrange","redis_persist","redis_rpop","redis_rpush","redis_set","redis_setnx","redis_ttl","reducto_parser","reducto_parser_v2","resend_cancel_email","resend_create_audience","resend_create_broadcast","resend_create_contact","resend_delete_audience","resend_delete_contact","resend_get_audience","resend_get_broadcast","resend_get_contact","resend_get_email","resend_list_audiences","resend_list_contacts","resend_list_domains","resend_send","resend_send_broadcast","resend_update_contact","revenuecat_create_purchase","revenuecat_defer_google_subscription","revenuecat_delete_customer","revenuecat_get_customer","revenuecat_grant_entitlement","revenuecat_list_offerings","revenuecat_refund_google_subscription","revenuecat_revoke_entitlement","revenuecat_revoke_google_subscription","revenuecat_update_subscriber_attributes","rippling_bulk_create_custom_object_records","rippling_bulk_delete_custom_object_records","rippling_bulk_update_custom_object_records","rippling_create_business_partner","rippling_create_business_partner_group","rippling_create_custom_app","rippling_create_custom_object","rippling_create_custom_object_field","rippling_create_custom_object_record","rippling_create_custom_page","rippling_create_custom_setting","rippling_create_department","rippling_create_draft_hires","rippling_create_object_category","rippling_create_title","rippling_create_work_location","rippling_delete_business_partner","rippling_delete_business_partner_group","rippling_delete_custom_app","rippling_delete_custom_object","rippling_delete_custom_object_field","rippling_delete_custom_object_record","rippling_delete_custom_page","rippling_delete_custom_setting","rippling_delete_object_category","rippling_delete_title","rippling_delete_work_location","rippling_get_business_partner","rippling_get_business_partner_group","rippling_get_current_user","rippling_get_custom_app","rippling_get_custom_object","rippling_get_custom_object_field","rippling_get_custom_object_record","rippling_get_custom_object_record_by_external_id","rippling_get_custom_page","rippling_get_custom_setting","rippling_get_department","rippling_get_employment_type","rippling_get_job_function","rippling_get_object_category","rippling_get_report_run","rippling_get_supergroup","rippling_get_team","rippling_get_title","rippling_get_user","rippling_get_work_location","rippling_get_worker","rippling_list_business_partner_groups","rippling_list_business_partners","rippling_list_companies","rippling_list_custom_apps","rippling_list_custom_fields","rippling_list_custom_object_fields","rippling_list_custom_object_records","rippling_list_custom_objects","rippling_list_custom_pages","rippling_list_custom_settings","rippling_list_departments","rippling_list_employment_types","rippling_list_entitlements","rippling_list_job_functions","rippling_list_object_categories","rippling_list_supergroup_exclusion_members","rippling_list_supergroup_inclusion_members","rippling_list_supergroup_members","rippling_list_supergroups","rippling_list_teams","rippling_list_titles","rippling_list_users","rippling_list_work_locations","rippling_list_workers","rippling_query_custom_object_records","rippling_trigger_report_run","rippling_update_custom_app","rippling_update_custom_object","rippling_update_custom_object_field","rippling_update_custom_object_record","rippling_update_custom_page","rippling_update_custom_setting","rippling_update_department","rippling_update_object_category","rippling_update_supergroup_exclusion_members","rippling_update_supergroup_inclusion_members","rippling_update_title","rippling_update_work_location","rocketlane_add_field_option","rocketlane_add_project_members","rocketlane_add_task_assignees","rocketlane_add_task_dependencies","rocketlane_add_task_followers","rocketlane_archive_project","rocketlane_assign_placeholders","rocketlane_create_field","rocketlane_create_phase","rocketlane_create_project","rocketlane_create_space","rocketlane_create_space_document","rocketlane_create_task","rocketlane_create_time_entry","rocketlane_create_time_off","rocketlane_delete_field","rocketlane_delete_phase","rocketlane_delete_project","rocketlane_delete_space","rocketlane_delete_space_document","rocketlane_delete_task","rocketlane_delete_time_entry","rocketlane_delete_time_off","rocketlane_get_field","rocketlane_get_invoice","rocketlane_get_invoice_line_items","rocketlane_get_invoice_payments","rocketlane_get_phase","rocketlane_get_project","rocketlane_get_space","rocketlane_get_space_document","rocketlane_get_task","rocketlane_get_time_entry","rocketlane_get_time_off","rocketlane_get_user","rocketlane_import_template","rocketlane_list_fields","rocketlane_list_invoices","rocketlane_list_phases","rocketlane_list_placeholders","rocketlane_list_projects","rocketlane_list_resource_allocations","rocketlane_list_space_documents","rocketlane_list_spaces","rocketlane_list_tasks","rocketlane_list_time_entries","rocketlane_list_time_entry_categories","rocketlane_list_time_offs","rocketlane_list_users","rocketlane_move_task_to_phase","rocketlane_remove_project_members","rocketlane_remove_task_assignees","rocketlane_remove_task_dependencies","rocketlane_remove_task_followers","rocketlane_search_time_entries","rocketlane_unassign_placeholders","rocketlane_update_field","rocketlane_update_field_option","rocketlane_update_phase","rocketlane_update_project","rocketlane_update_space","rocketlane_update_space_document","rocketlane_update_task","rocketlane_update_time_entry","rootly_acknowledge_alert","rootly_add_incident_event","rootly_add_subscribers","rootly_assign_incident_role","rootly_create_action_item","rootly_create_alert","rootly_create_incident","rootly_create_status_page_event","rootly_delete_action_item","rootly_delete_incident","rootly_escalate_alert","rootly_get_alert","rootly_get_incident","rootly_list_action_items","rootly_list_alerts","rootly_list_causes","rootly_list_environments","rootly_list_escalation_policies","rootly_list_functionalities","rootly_list_incident_events","rootly_list_incident_roles","rootly_list_incident_types","rootly_list_incidents","rootly_list_on_calls","rootly_list_playbooks","rootly_list_retrospectives","rootly_list_schedules","rootly_list_services","rootly_list_severities","rootly_list_teams","rootly_list_users","rootly_mitigate_incident","rootly_remove_subscribers","rootly_resolve_alert","rootly_resolve_incident","rootly_run_workflow","rootly_snooze_alert","rootly_unassign_incident_role","rootly_update_action_item","rootly_update_alert","rootly_update_incident","s3_copy_object","s3_create_bucket","s3_delete_bucket","s3_delete_object","s3_delete_objects","s3_get_object","s3_head_object","s3_list_buckets","s3_list_objects","s3_presigned_url","s3_put_object","salesforce_create_account","salesforce_create_case","salesforce_create_contact","salesforce_create_custom_field","salesforce_create_custom_object","salesforce_create_lead","salesforce_create_opportunity","salesforce_create_task","salesforce_delete_account","salesforce_delete_case","salesforce_delete_contact","salesforce_delete_custom_field","salesforce_delete_lead","salesforce_delete_opportunity","salesforce_delete_task","salesforce_describe_object","salesforce_get_accounts","salesforce_get_cases","salesforce_get_contacts","salesforce_get_dashboard","salesforce_get_leads","salesforce_get_opportunities","salesforce_get_report","salesforce_get_tasks","salesforce_list_dashboards","salesforce_list_objects","salesforce_list_report_types","salesforce_list_reports","salesforce_query","salesforce_query_more","salesforce_refresh_dashboard","salesforce_run_report","salesforce_tooling_query","salesforce_update_account","salesforce_update_case","salesforce_update_contact","salesforce_update_custom_field","salesforce_update_lead","salesforce_update_opportunity","salesforce_update_task","sap_concur_approve_expense_report","sap_concur_associate_attendees","sap_concur_create_cash_advance","sap_concur_create_expected_expense","sap_concur_create_expense_report","sap_concur_create_list_item","sap_concur_create_purchase_request","sap_concur_create_quick_expense","sap_concur_create_quick_expense_with_image","sap_concur_create_report_comment","sap_concur_create_travel_request","sap_concur_create_user","sap_concur_delete_expected_expense","sap_concur_delete_expense","sap_concur_delete_expense_report","sap_concur_delete_list_item","sap_concur_delete_travel_request","sap_concur_delete_user","sap_concur_get_allocation","sap_concur_get_budget","sap_concur_get_cash_advance","sap_concur_get_expected_expense","sap_concur_get_expense","sap_concur_get_expense_report","sap_concur_get_itemizations","sap_concur_get_itinerary","sap_concur_get_list","sap_concur_get_list_item","sap_concur_get_purchase_request","sap_concur_get_receipt","sap_concur_get_receipt_status","sap_concur_get_request_cash_advance","sap_concur_get_travel_profile","sap_concur_get_travel_request","sap_concur_get_user","sap_concur_issue_cash_advance","sap_concur_list_allocations","sap_concur_list_attendee_associations","sap_concur_list_budget_categories","sap_concur_list_budgets","sap_concur_list_exceptions","sap_concur_list_expected_expenses","sap_concur_list_expense_reports","sap_concur_list_expenses","sap_concur_list_itineraries","sap_concur_list_list_items","sap_concur_list_lists","sap_concur_list_receipts","sap_concur_list_report_comments","sap_concur_list_reports_to_approve","sap_concur_list_travel_profiles_summary","sap_concur_list_travel_request_comments","sap_concur_list_travel_requests","sap_concur_list_users","sap_concur_move_travel_request","sap_concur_recall_expense_report","sap_concur_remove_all_attendees","sap_concur_search_locations","sap_concur_search_users","sap_concur_send_back_expense_report","sap_concur_submit_expense_report","sap_concur_update_allocation","sap_concur_update_expected_expense","sap_concur_update_expense","sap_concur_update_expense_report","sap_concur_update_list_item","sap_concur_update_travel_request","sap_concur_update_user","sap_concur_upload_exchange_rates","sap_concur_upload_receipt_image","sap_s4hana_create_business_partner","sap_s4hana_create_purchase_order","sap_s4hana_create_purchase_requisition","sap_s4hana_create_sales_order","sap_s4hana_delete_sales_order","sap_s4hana_get_billing_document","sap_s4hana_get_business_partner","sap_s4hana_get_customer","sap_s4hana_get_inbound_delivery","sap_s4hana_get_material_document","sap_s4hana_get_outbound_delivery","sap_s4hana_get_product","sap_s4hana_get_purchase_order","sap_s4hana_get_purchase_requisition","sap_s4hana_get_sales_order","sap_s4hana_get_supplier","sap_s4hana_get_supplier_invoice","sap_s4hana_list_billing_documents","sap_s4hana_list_business_partners","sap_s4hana_list_customers","sap_s4hana_list_inbound_deliveries","sap_s4hana_list_material_documents","sap_s4hana_list_material_stock","sap_s4hana_list_outbound_deliveries","sap_s4hana_list_products","sap_s4hana_list_purchase_orders","sap_s4hana_list_purchase_requisitions","sap_s4hana_list_sales_orders","sap_s4hana_list_supplier_invoices","sap_s4hana_list_suppliers","sap_s4hana_odata_query","sap_s4hana_update_business_partner","sap_s4hana_update_customer","sap_s4hana_update_product","sap_s4hana_update_purchase_order","sap_s4hana_update_purchase_requisition","sap_s4hana_update_sales_order","sap_s4hana_update_supplier","search_tool","secrets_manager_create_secret","secrets_manager_delete_secret","secrets_manager_describe_secret","secrets_manager_get_secret","secrets_manager_list_secrets","secrets_manager_restore_secret","secrets_manager_rotate_secret","secrets_manager_tag_resource","secrets_manager_untag_resource","secrets_manager_update_secret","sendblue_evaluate_service","sendblue_get_message","sendblue_send_group_message","sendblue_send_message","sendblue_send_typing_indicator","sendgrid_add_contact","sendgrid_add_contacts_to_list","sendgrid_create_list","sendgrid_create_template","sendgrid_create_template_version","sendgrid_delete_contacts","sendgrid_delete_list","sendgrid_delete_template","sendgrid_get_contact","sendgrid_get_list","sendgrid_get_template","sendgrid_list_all_lists","sendgrid_list_templates","sendgrid_remove_contacts_from_list","sendgrid_search_contacts","sendgrid_send_mail","sentry_events_get","sentry_events_list","sentry_issues_get","sentry_issues_list","sentry_issues_update","sentry_projects_create","sentry_projects_get","sentry_projects_list","sentry_projects_update","sentry_releases_create","sentry_releases_deploy","sentry_releases_list","sentry_teams_list","serper_search","servicenow_aggregate","servicenow_create_record","servicenow_delete_record","servicenow_download_attachment","servicenow_list_attachments","servicenow_read_record","servicenow_update_record","servicenow_upload_attachment","ses_create_configuration_set","ses_create_email_identity","ses_create_template","ses_delete_email_identity","ses_delete_suppressed_destination","ses_delete_template","ses_get_account","ses_get_email_identity","ses_get_suppressed_destination","ses_get_template","ses_list_identities","ses_list_suppressed_destinations","ses_list_templates","ses_put_suppressed_destination","ses_send_bulk_email","ses_send_custom_verification_email","ses_send_email","ses_send_templated_email","ses_update_template","sftp_delete","sftp_download","sftp_list","sftp_mkdir","sftp_upload","sharepoint_add_list_items","sharepoint_create_list","sharepoint_create_page","sharepoint_delete_file","sharepoint_delete_list_item","sharepoint_delete_page","sharepoint_download_file","sharepoint_get_drive_item","sharepoint_get_list","sharepoint_get_list_item","sharepoint_list_sites","sharepoint_publish_page","sharepoint_read_page","sharepoint_update_list","sharepoint_update_page","sharepoint_upload_file","shopify_adjust_inventory","shopify_cancel_order","shopify_create_customer","shopify_create_fulfillment","shopify_create_product","shopify_delete_customer","shopify_delete_product","shopify_get_collection","shopify_get_customer","shopify_get_inventory_level","shopify_get_order","shopify_get_product","shopify_list_collections","shopify_list_customers","shopify_list_inventory_items","shopify_list_locations","shopify_list_orders","shopify_list_products","shopify_update_customer","shopify_update_order","shopify_update_product","similarweb_bounce_rate","similarweb_page_views","similarweb_pages_per_visit","similarweb_traffic_visits","similarweb_visit_duration","similarweb_website_overview","sixtyfour_enrich_company","sixtyfour_enrich_lead","sixtyfour_find_email","sixtyfour_find_phone","slack_add_reaction","slack_archive_conversation","slack_canvas","slack_create_channel_canvas","slack_create_conversation","slack_delete_canvas","slack_delete_message","slack_delete_scheduled_message","slack_download","slack_edit_canvas","slack_ephemeral_message","slack_get_canvas","slack_get_channel_history","slack_get_channel_info","slack_get_message","slack_get_permalink","slack_get_thread","slack_get_thread_replies","slack_get_user","slack_get_user_presence","slack_invite_to_conversation","slack_list_canvases","slack_list_channels","slack_list_members","slack_list_scheduled_messages","slack_list_users","slack_lookup_canvas_sections","slack_message","slack_message_reader","slack_open_view","slack_publish_view","slack_push_view","slack_remove_reaction","slack_rename_conversation","slack_schedule_message","slack_set_conversation_purpose","slack_set_conversation_topic","slack_set_status","slack_set_suggested_prompts","slack_set_title","slack_update_message","slack_update_view","sms_send","smtp_send_mail","sportmonks_core_get_cities","sportmonks_core_get_city","sportmonks_core_get_continent","sportmonks_core_get_continents","sportmonks_core_get_countries","sportmonks_core_get_country","sportmonks_core_get_entity_filters","sportmonks_core_get_my_usage","sportmonks_core_get_region","sportmonks_core_get_regions","sportmonks_core_get_timezones","sportmonks_core_get_type","sportmonks_core_get_type_by_entity","sportmonks_core_get_types","sportmonks_core_search_cities","sportmonks_core_search_countries","sportmonks_core_search_regions","sportmonks_football_expected_by_player","sportmonks_football_expected_by_team","sportmonks_football_get_all_commentaries","sportmonks_football_get_all_fixtures","sportmonks_football_get_all_players","sportmonks_football_get_all_rivals","sportmonks_football_get_all_teams","sportmonks_football_get_all_transfer_rumours","sportmonks_football_get_all_transfers","sportmonks_football_get_brackets_by_season","sportmonks_football_get_coach","sportmonks_football_get_coaches","sportmonks_football_get_coaches_by_country","sportmonks_football_get_commentaries_by_fixture","sportmonks_football_get_current_leagues_by_team","sportmonks_football_get_expected_lineups_by_player","sportmonks_football_get_expected_lineups_by_team","sportmonks_football_get_extended_team_squad","sportmonks_football_get_fixture","sportmonks_football_get_fixtures_by_date","sportmonks_football_get_fixtures_by_date_range","sportmonks_football_get_fixtures_by_date_range_for_team","sportmonks_football_get_fixtures_by_ids","sportmonks_football_get_grouped_standings_by_round","sportmonks_football_get_head_to_head","sportmonks_football_get_inplay_livescores","sportmonks_football_get_latest_coaches","sportmonks_football_get_latest_fixtures","sportmonks_football_get_latest_livescores","sportmonks_football_get_latest_players","sportmonks_football_get_latest_totw","sportmonks_football_get_latest_transfers","sportmonks_football_get_league","sportmonks_football_get_leagues","sportmonks_football_get_leagues_by_country","sportmonks_football_get_leagues_by_date","sportmonks_football_get_leagues_by_team","sportmonks_football_get_live_leagues","sportmonks_football_get_live_probabilities","sportmonks_football_get_live_probabilities_by_fixture","sportmonks_football_get_live_standings_by_league","sportmonks_football_get_livescores","sportmonks_football_get_match_facts","sportmonks_football_get_match_facts_by_date_range","sportmonks_football_get_match_facts_by_fixture","sportmonks_football_get_match_facts_by_league","sportmonks_football_get_past_fixtures_by_tv_station","sportmonks_football_get_player","sportmonks_football_get_players_by_country","sportmonks_football_get_postmatch_news","sportmonks_football_get_postmatch_news_by_season","sportmonks_football_get_predictability_by_league","sportmonks_football_get_prematch_news","sportmonks_football_get_prematch_news_by_season","sportmonks_football_get_prematch_news_upcoming","sportmonks_football_get_probabilities","sportmonks_football_get_probabilities_by_fixture","sportmonks_football_get_referee","sportmonks_football_get_referees","sportmonks_football_get_referees_by_country","sportmonks_football_get_referees_by_season","sportmonks_football_get_rivals_by_team","sportmonks_football_get_round","sportmonks_football_get_round_statistics","sportmonks_football_get_rounds","sportmonks_football_get_rounds_by_season","sportmonks_football_get_schedules_by_season","sportmonks_football_get_schedules_by_season_and_team","sportmonks_football_get_schedules_by_team","sportmonks_football_get_season","sportmonks_football_get_seasons","sportmonks_football_get_seasons_by_team","sportmonks_football_get_stage","sportmonks_football_get_stage_statistics","sportmonks_football_get_stages","sportmonks_football_get_stages_by_season","sportmonks_football_get_standing_corrections_by_season","sportmonks_football_get_standings","sportmonks_football_get_standings_by_round","sportmonks_football_get_standings_by_season","sportmonks_football_get_state","sportmonks_football_get_states","sportmonks_football_get_team","sportmonks_football_get_team_rankings","sportmonks_football_get_team_rankings_by_date","sportmonks_football_get_team_rankings_by_team","sportmonks_football_get_team_squad","sportmonks_football_get_team_squad_by_season","sportmonks_football_get_teams_by_country","sportmonks_football_get_teams_by_season","sportmonks_football_get_topscorers_by_season","sportmonks_football_get_topscorers_by_stage","sportmonks_football_get_totw","sportmonks_football_get_totw_by_round","sportmonks_football_get_transfer","sportmonks_football_get_transfer_rumour","sportmonks_football_get_transfer_rumours_between_dates","sportmonks_football_get_transfer_rumours_by_player","sportmonks_football_get_transfer_rumours_by_team","sportmonks_football_get_transfers_between_dates","sportmonks_football_get_transfers_by_player","sportmonks_football_get_transfers_by_team","sportmonks_football_get_tv_station","sportmonks_football_get_tv_stations","sportmonks_football_get_tv_stations_by_fixture","sportmonks_football_get_upcoming_fixtures_by_market","sportmonks_football_get_upcoming_fixtures_by_tv_station","sportmonks_football_get_value_bets","sportmonks_football_get_value_bets_by_fixture","sportmonks_football_get_venue","sportmonks_football_get_venues","sportmonks_football_get_venues_by_season","sportmonks_football_search_coaches","sportmonks_football_search_fixtures","sportmonks_football_search_leagues","sportmonks_football_search_players","sportmonks_football_search_referees","sportmonks_football_search_rounds","sportmonks_football_search_seasons","sportmonks_football_search_stages","sportmonks_football_search_teams","sportmonks_football_search_venues","sportmonks_motorsport_get_all_fixtures","sportmonks_motorsport_get_current_leagues_by_team","sportmonks_motorsport_get_driver","sportmonks_motorsport_get_driver_standings","sportmonks_motorsport_get_driver_standings_by_season","sportmonks_motorsport_get_drivers","sportmonks_motorsport_get_drivers_by_country","sportmonks_motorsport_get_drivers_by_season","sportmonks_motorsport_get_fixture","sportmonks_motorsport_get_fixtures_by_date","sportmonks_motorsport_get_fixtures_by_date_range","sportmonks_motorsport_get_fixtures_by_ids","sportmonks_motorsport_get_laps_by_fixture","sportmonks_motorsport_get_laps_by_fixture_and_driver","sportmonks_motorsport_get_laps_by_fixture_and_lap","sportmonks_motorsport_get_latest_laps_by_fixture","sportmonks_motorsport_get_latest_pitstops_by_fixture","sportmonks_motorsport_get_latest_stints_by_fixture","sportmonks_motorsport_get_latest_updated_drivers","sportmonks_motorsport_get_latest_updated_fixtures","sportmonks_motorsport_get_league","sportmonks_motorsport_get_leagues","sportmonks_motorsport_get_leagues_by_country","sportmonks_motorsport_get_leagues_by_date","sportmonks_motorsport_get_leagues_by_live","sportmonks_motorsport_get_leagues_by_team","sportmonks_motorsport_get_livescores","sportmonks_motorsport_get_pitstops_by_fixture","sportmonks_motorsport_get_pitstops_by_fixture_and_driver","sportmonks_motorsport_get_pitstops_by_fixture_and_lap","sportmonks_motorsport_get_race_results_by_season_and_driver","sportmonks_motorsport_get_race_results_by_season_and_team","sportmonks_motorsport_get_schedules_by_season","sportmonks_motorsport_get_season","sportmonks_motorsport_get_seasons","sportmonks_motorsport_get_stage","sportmonks_motorsport_get_stages","sportmonks_motorsport_get_stages_by_season","sportmonks_motorsport_get_state","sportmonks_motorsport_get_states","sportmonks_motorsport_get_stints_by_fixture","sportmonks_motorsport_get_stints_by_fixture_and_driver","sportmonks_motorsport_get_stints_by_fixture_and_stint","sportmonks_motorsport_get_team","sportmonks_motorsport_get_team_standings","sportmonks_motorsport_get_team_standings_by_season","sportmonks_motorsport_get_teams","sportmonks_motorsport_get_teams_by_country","sportmonks_motorsport_get_teams_by_season","sportmonks_motorsport_get_venue","sportmonks_motorsport_get_venues","sportmonks_motorsport_get_venues_by_season","sportmonks_motorsport_search_drivers","sportmonks_motorsport_search_leagues","sportmonks_motorsport_search_stages","sportmonks_motorsport_search_teams","sportmonks_motorsport_search_venues","sportmonks_odds_get_all_historical_odds","sportmonks_odds_get_all_inplay_odds","sportmonks_odds_get_all_pre_match_odds","sportmonks_odds_get_all_premium_odds","sportmonks_odds_get_bookmaker","sportmonks_odds_get_bookmaker_event_ids_by_fixture","sportmonks_odds_get_bookmakers","sportmonks_odds_get_bookmakers_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture_and_bookmaker","sportmonks_odds_get_inplay_odds_by_fixture_and_market","sportmonks_odds_get_last_updated_inplay_odds","sportmonks_odds_get_last_updated_pre_match_odds","sportmonks_odds_get_market","sportmonks_odds_get_markets","sportmonks_odds_get_pre_match_odds_by_fixture","sportmonks_odds_get_pre_match_odds_by_fixture_and_bookmaker","sportmonks_odds_get_pre_match_odds_by_fixture_and_market","sportmonks_odds_get_premium_odds_by_fixture","sportmonks_odds_get_premium_odds_by_fixture_and_bookmaker","sportmonks_odds_get_premium_odds_by_fixture_and_market","sportmonks_odds_get_updated_historical_odds_between","sportmonks_odds_get_updated_premium_odds_between","sportmonks_odds_search_bookmakers","sportmonks_odds_search_markets","spotify_add_playlist_cover","spotify_add_to_queue","spotify_add_tracks_to_playlist","spotify_check_following","spotify_check_playlist_followers","spotify_check_saved_albums","spotify_check_saved_audiobooks","spotify_check_saved_episodes","spotify_check_saved_shows","spotify_check_saved_tracks","spotify_create_playlist","spotify_follow_artists","spotify_follow_playlist","spotify_get_album","spotify_get_album_tracks","spotify_get_albums","spotify_get_artist","spotify_get_artist_albums","spotify_get_artist_top_tracks","spotify_get_artists","spotify_get_audiobook","spotify_get_audiobook_chapters","spotify_get_audiobooks","spotify_get_categories","spotify_get_current_user","spotify_get_currently_playing","spotify_get_devices","spotify_get_episode","spotify_get_episodes","spotify_get_followed_artists","spotify_get_markets","spotify_get_new_releases","spotify_get_playback_state","spotify_get_playlist","spotify_get_playlist_cover","spotify_get_playlist_tracks","spotify_get_queue","spotify_get_recently_played","spotify_get_saved_albums","spotify_get_saved_audiobooks","spotify_get_saved_episodes","spotify_get_saved_shows","spotify_get_saved_tracks","spotify_get_show","spotify_get_show_episodes","spotify_get_shows","spotify_get_top_artists","spotify_get_top_tracks","spotify_get_track","spotify_get_tracks","spotify_get_user_playlists","spotify_get_user_profile","spotify_pause","spotify_play","spotify_remove_saved_albums","spotify_remove_saved_audiobooks","spotify_remove_saved_episodes","spotify_remove_saved_shows","spotify_remove_saved_tracks","spotify_remove_tracks_from_playlist","spotify_reorder_playlist_items","spotify_replace_playlist_items","spotify_save_albums","spotify_save_audiobooks","spotify_save_episodes","spotify_save_shows","spotify_save_tracks","spotify_search","spotify_seek","spotify_set_repeat","spotify_set_shuffle","spotify_set_volume","spotify_skip_next","spotify_skip_previous","spotify_transfer_playback","spotify_unfollow_artists","spotify_unfollow_playlist","spotify_update_playlist","sqs_send","square_batch_retrieve_inventory_counts","square_cancel_invoice","square_cancel_payment","square_complete_payment","square_create_catalog_image","square_create_customer","square_create_invoice","square_create_order","square_create_payment","square_delete_catalog_object","square_delete_customer","square_delete_invoice","square_get_catalog_object","square_get_customer","square_get_invoice","square_get_location","square_get_order","square_get_payment","square_get_refund","square_list_catalog","square_list_customers","square_list_invoices","square_list_locations","square_list_payments","square_list_refunds","square_pay_order","square_publish_invoice","square_refund_payment","square_search_catalog_objects","square_search_customers","square_search_invoices","square_search_orders","square_update_customer","square_upsert_catalog_object","ssh_check_command_exists","ssh_check_file_exists","ssh_create_directory","ssh_delete_file","ssh_download_file","ssh_execute_command","ssh_execute_script","ssh_get_system_info","ssh_list_directory","ssh_move_rename","ssh_read_file_content","ssh_upload_file","ssh_write_file_content","stagehand_agent","stagehand_extract","stripe_cancel_payment_intent","stripe_cancel_subscription","stripe_capture_charge","stripe_capture_payment_intent","stripe_confirm_payment_intent","stripe_create_charge","stripe_create_customer","stripe_create_invoice","stripe_create_payment_intent","stripe_create_price","stripe_create_product","stripe_create_subscription","stripe_delete_customer","stripe_delete_invoice","stripe_delete_product","stripe_finalize_invoice","stripe_list_charges","stripe_list_customers","stripe_list_events","stripe_list_invoices","stripe_list_payment_intents","stripe_list_prices","stripe_list_products","stripe_list_subscriptions","stripe_pay_invoice","stripe_resume_subscription","stripe_retrieve_charge","stripe_retrieve_customer","stripe_retrieve_event","stripe_retrieve_invoice","stripe_retrieve_payment_intent","stripe_retrieve_price","stripe_retrieve_product","stripe_retrieve_subscription","stripe_search_charges","stripe_search_customers","stripe_search_invoices","stripe_search_payment_intents","stripe_search_prices","stripe_search_products","stripe_search_subscriptions","stripe_send_invoice","stripe_update_charge","stripe_update_customer","stripe_update_invoice","stripe_update_payment_intent","stripe_update_price","stripe_update_product","stripe_update_subscription","stripe_void_invoice","sts_assume_role","sts_assume_role_with_saml","sts_assume_role_with_web_identity","sts_get_access_key_info","sts_get_caller_identity","sts_get_session_token","stt_assemblyai","stt_assemblyai_v2","stt_deepgram","stt_deepgram_v2","stt_elevenlabs","stt_elevenlabs_v2","stt_gemini","stt_gemini_v2","stt_whisper","stt_whisper_v2","supabase_count","supabase_delete","supabase_get_row","supabase_insert","supabase_introspect","supabase_invoke_function","supabase_query","supabase_rpc","supabase_storage_copy","supabase_storage_create_bucket","supabase_storage_create_signed_upload_url","supabase_storage_create_signed_url","supabase_storage_delete","supabase_storage_delete_bucket","supabase_storage_download","supabase_storage_empty_bucket","supabase_storage_get_public_url","supabase_storage_list","supabase_storage_list_buckets","supabase_storage_move","supabase_storage_update_bucket","supabase_storage_upload","supabase_text_search","supabase_update","supabase_upsert","supabase_vector_search","table_batch_insert_rows","table_create","table_delete_row","table_delete_rows_by_filter","table_get_row","table_get_schema","table_insert_row","table_list","table_query_rows","table_query_rows_v2","table_update_row","table_update_rows_by_filter","table_upsert_row","tailscale_authorize_device","tailscale_create_auth_key","tailscale_delete_auth_key","tailscale_delete_device","tailscale_delete_user","tailscale_expire_device_key","tailscale_get_acl","tailscale_get_auth_key","tailscale_get_device","tailscale_get_device_routes","tailscale_get_dns_preferences","tailscale_get_dns_searchpaths","tailscale_list_auth_keys","tailscale_list_devices","tailscale_list_dns_nameservers","tailscale_list_users","tailscale_set_acl","tailscale_set_device_routes","tailscale_set_device_tags","tailscale_set_dns_nameservers","tailscale_set_dns_preferences","tailscale_set_dns_searchpaths","tailscale_suspend_user","tailscale_update_device_key","tavily_crawl","tavily_extract","tavily_map","tavily_search","telegram_copy_message","telegram_delete_message","telegram_edit_message_text","telegram_forward_message","telegram_get_chat","telegram_get_chat_member","telegram_message","telegram_pin_message","telegram_send_animation","telegram_send_audio","telegram_send_chat_action","telegram_send_contact","telegram_send_document","telegram_send_location","telegram_send_photo","telegram_send_poll","telegram_send_video","telegram_set_message_reaction","telegram_unpin_message","temporal_cancel_workflow","temporal_count_workflows","temporal_create_schedule","temporal_delete_schedule","temporal_describe_schedule","temporal_describe_task_queue","temporal_describe_workflow","temporal_get_workflow_history","temporal_list_schedules","temporal_list_workflows","temporal_pause_schedule","temporal_query_workflow","temporal_reset_workflow","temporal_signal_with_start","temporal_signal_workflow","temporal_start_workflow","temporal_terminate_workflow","temporal_trigger_schedule","temporal_unpause_schedule","temporal_update_workflow","textract_analyze_expense","textract_analyze_id","textract_parser","textract_parser_v2","thinking_tool","thrive_add_audience_managers","thrive_add_audience_members","thrive_add_user_tags","thrive_create_assignment","thrive_create_audience","thrive_create_completion","thrive_create_user","thrive_delete_assignment","thrive_delete_audience","thrive_delete_user","thrive_get_activity","thrive_get_assignment","thrive_get_audience","thrive_get_completion","thrive_get_content","thrive_get_cpd_category","thrive_get_cpd_entry","thrive_get_cpd_requirement","thrive_get_enrolment","thrive_get_skill_levels","thrive_get_tag","thrive_get_user_by_id","thrive_get_user_by_ref","thrive_list_assignments","thrive_list_audience_managers","thrive_list_audience_members","thrive_list_audiences","thrive_list_completions","thrive_list_enrolments","thrive_list_tags","thrive_query_activities","thrive_query_content","thrive_query_cpd_categories","thrive_query_cpd_entries","thrive_query_cpd_requirements","thrive_query_cpd_user_summaries","thrive_remove_audience_manager","thrive_remove_audience_member","thrive_remove_user_tags","thrive_replace_audience_managers","thrive_replace_audience_members","thrive_search_users","thrive_suspend_user","thrive_update_assignment","thrive_update_audience","thrive_update_user","thrive_update_user_skills","tiktok_get_post_status","tiktok_get_user","tiktok_list_videos","tiktok_query_videos","tiktok_upload_video_draft","tinybird_append_datasource","tinybird_delete_datasource_rows","tinybird_events","tinybird_get_job","tinybird_query","tinybird_query_pipe","tinybird_truncate_datasource","trello_add_checklist","trello_add_checklist_item","trello_add_comment","trello_add_label","trello_add_member","trello_create_board","trello_create_card","trello_create_list","trello_delete_card","trello_get_actions","trello_get_board","trello_get_card","trello_list_cards","trello_list_lists","trello_list_members","trello_remove_label","trello_remove_member","trello_search","trello_update_card","trello_update_checklist_item","trello_update_list","trigger_dev_activate_schedule","trigger_dev_add_run_tags","trigger_dev_batch_trigger_task","trigger_dev_cancel_run","trigger_dev_complete_waitpoint_token","trigger_dev_create_env_var","trigger_dev_create_schedule","trigger_dev_create_waitpoint_token","trigger_dev_deactivate_schedule","trigger_dev_delete_env_var","trigger_dev_delete_schedule","trigger_dev_execute_query","trigger_dev_get_batch","trigger_dev_get_batch_results","trigger_dev_get_deployment","trigger_dev_get_env_var","trigger_dev_get_latest_deployment","trigger_dev_get_query_schema","trigger_dev_get_queue","trigger_dev_get_run","trigger_dev_get_run_events","trigger_dev_get_run_result","trigger_dev_get_run_trace","trigger_dev_get_schedule","trigger_dev_get_waitpoint_token","trigger_dev_import_env_vars","trigger_dev_list_deployments","trigger_dev_list_env_vars","trigger_dev_list_queues","trigger_dev_list_runs","trigger_dev_list_schedules","trigger_dev_list_timezones","trigger_dev_list_waitpoint_tokens","trigger_dev_override_queue_concurrency","trigger_dev_pause_queue","trigger_dev_promote_deployment","trigger_dev_replay_run","trigger_dev_reschedule_run","trigger_dev_reset_queue_concurrency","trigger_dev_resume_queue","trigger_dev_trigger_task","trigger_dev_update_env_var","trigger_dev_update_run_metadata","trigger_dev_update_schedule","tts_azure","tts_cartesia","tts_deepgram","tts_elevenlabs","tts_google","tts_openai","tts_playht","twilio_send_sms","twilio_voice_get_recording","twilio_voice_list_calls","twilio_voice_make_call","typeform_create_form","typeform_delete_form","typeform_files","typeform_get_form","typeform_insights","typeform_list_forms","typeform_responses","typeform_update_form","upstash_redis_command","upstash_redis_delete","upstash_redis_exists","upstash_redis_expire","upstash_redis_get","upstash_redis_hget","upstash_redis_hgetall","upstash_redis_hset","upstash_redis_incr","upstash_redis_incrby","upstash_redis_keys","upstash_redis_lpush","upstash_redis_lrange","upstash_redis_set","upstash_redis_setnx","upstash_redis_ttl","uptimerobot_create_alert_contact","uptimerobot_create_maintenance_window","uptimerobot_create_monitor","uptimerobot_create_psp","uptimerobot_delete_alert_contact","uptimerobot_delete_maintenance_window","uptimerobot_delete_monitor","uptimerobot_delete_psp","uptimerobot_get_account","uptimerobot_get_alert_contact","uptimerobot_get_incident","uptimerobot_get_maintenance_window","uptimerobot_get_monitor","uptimerobot_get_psp","uptimerobot_list_alert_contacts","uptimerobot_list_incidents","uptimerobot_list_maintenance_windows","uptimerobot_list_monitors","uptimerobot_list_psps","uptimerobot_pause_monitor","uptimerobot_start_monitor","uptimerobot_update_maintenance_window","uptimerobot_update_monitor","uptimerobot_update_psp","vanta_download_document_file","vanta_get_control","vanta_get_document","vanta_get_framework","vanta_get_person","vanta_get_policy","vanta_get_risk_scenario","vanta_get_test","vanta_get_vendor","vanta_get_vulnerable_asset","vanta_list_control_documents","vanta_list_control_tests","vanta_list_controls","vanta_list_document_uploads","vanta_list_documents","vanta_list_framework_controls","vanta_list_frameworks","vanta_list_monitored_computers","vanta_list_people","vanta_list_policies","vanta_list_risk_scenarios","vanta_list_test_entities","vanta_list_tests","vanta_list_vendors","vanta_list_vulnerabilities","vanta_list_vulnerability_remediations","vanta_list_vulnerable_assets","vanta_submit_document","vanta_upload_document_file","vercel_add_domain","vercel_add_project_domain","vercel_cancel_deployment","vercel_create_alias","vercel_create_check","vercel_create_deployment","vercel_create_dns_record","vercel_create_edge_config","vercel_create_env_var","vercel_create_project","vercel_create_webhook","vercel_delete_alias","vercel_delete_deployment","vercel_delete_dns_record","vercel_delete_domain","vercel_delete_edge_config","vercel_delete_env_var","vercel_delete_project","vercel_delete_webhook","vercel_get_alias","vercel_get_check","vercel_get_deployment","vercel_get_deployment_events","vercel_get_domain","vercel_get_domain_config","vercel_get_edge_config","vercel_get_edge_config_items","vercel_get_env_vars","vercel_get_project","vercel_get_team","vercel_get_user","vercel_get_webhook","vercel_list_aliases","vercel_list_checks","vercel_list_deployment_files","vercel_list_deployments","vercel_list_dns_records","vercel_list_domains","vercel_list_edge_configs","vercel_list_project_domains","vercel_list_projects","vercel_list_team_members","vercel_list_teams","vercel_list_webhooks","vercel_pause_project","vercel_promote_deployment","vercel_remove_project_domain","vercel_rerequest_check","vercel_unpause_project","vercel_update_check","vercel_update_dns_record","vercel_update_edge_config_items","vercel_update_env_var","vercel_update_project","vercel_update_project_domain","vercel_verify_project_domain","video_falai","video_luma","video_minimax","video_runway","video_veo","vision_tool","vision_tool_v2","wealthbox_read_contact","wealthbox_read_note","wealthbox_read_task","wealthbox_write_contact","wealthbox_write_note","wealthbox_write_task","webflow_create_item","webflow_delete_item","webflow_get_item","webflow_list_items","webflow_update_item","webhook_request","whatsapp_get_media","whatsapp_mark_read","whatsapp_send_interactive","whatsapp_send_media","whatsapp_send_message","whatsapp_send_reaction","whatsapp_send_template","whatsapp_upload_media","wikipedia_content","wikipedia_random","wikipedia_search","wikipedia_summary","wiza_company_enrichment","wiza_get_credits","wiza_individual_reveal","wiza_prospect_search","wordpress_create_category","wordpress_create_comment","wordpress_create_page","wordpress_create_post","wordpress_create_tag","wordpress_delete_category","wordpress_delete_comment","wordpress_delete_media","wordpress_delete_page","wordpress_delete_post","wordpress_delete_tag","wordpress_get_category","wordpress_get_current_user","wordpress_get_media","wordpress_get_page","wordpress_get_post","wordpress_get_tag","wordpress_get_user","wordpress_list_categories","wordpress_list_comments","wordpress_list_media","wordpress_list_pages","wordpress_list_posts","wordpress_list_tags","wordpress_list_users","wordpress_search_content","wordpress_update_category","wordpress_update_comment","wordpress_update_page","wordpress_update_post","wordpress_update_tag","wordpress_upload_media","workday_assign_onboarding","workday_change_job","workday_create_prehire","workday_get_compensation","workday_get_organizations","workday_get_worker","workday_hire_employee","workday_list_workers","workday_terminate_worker","workday_update_worker","workflow_executor","x_create_bookmark","x_create_tweet","x_delete_bookmark","x_delete_tweet","x_get_blocking","x_get_bookmarks","x_get_followers","x_get_following","x_get_liked_tweets","x_get_liking_users","x_get_me","x_get_personalized_trends","x_get_quote_tweets","x_get_retweeted_by","x_get_trends_by_woeid","x_get_tweets_by_ids","x_get_usage","x_get_user_mentions","x_get_user_timeline","x_get_user_tweets","x_hide_reply","x_manage_block","x_manage_follow","x_manage_like","x_manage_mute","x_manage_retweet","x_read","x_search","x_search_tweets","x_search_users","x_user","x_write","youtube_channel_info","youtube_channel_playlists","youtube_channel_videos","youtube_comments","youtube_playlist_items","youtube_search","youtube_trending","youtube_video_categories","youtube_video_details","zendesk_autocomplete_organizations","zendesk_create_organization","zendesk_create_organizations_bulk","zendesk_create_ticket","zendesk_create_tickets_bulk","zendesk_create_user","zendesk_create_users_bulk","zendesk_delete_organization","zendesk_delete_ticket","zendesk_delete_user","zendesk_get_current_user","zendesk_get_organization","zendesk_get_organizations","zendesk_get_ticket","zendesk_get_tickets","zendesk_get_user","zendesk_get_users","zendesk_merge_tickets","zendesk_search","zendesk_search_count","zendesk_search_users","zendesk_update_organization","zendesk_update_ticket","zendesk_update_tickets_bulk","zendesk_update_user","zendesk_update_users_bulk","zep_add_messages","zep_add_user","zep_create_thread","zep_delete_thread","zep_get_context","zep_get_messages","zep_get_threads","zep_get_user","zep_get_user_threads","zerobounce_get_credits","zerobounce_verify_email","zoho_desk_add_comment","zoho_desk_get_attachment","zoho_desk_get_contact","zoho_desk_get_thread","zoho_desk_get_ticket","zoho_desk_list_comments","zoho_desk_list_organizations","zoho_desk_list_threads","zoho_desk_list_tickets","zoho_desk_update_ticket","zoom_create_meeting","zoom_delete_meeting","zoom_delete_recording","zoom_get_meeting","zoom_get_meeting_invitation","zoom_get_meeting_recordings","zoom_list_meetings","zoom_list_past_participants","zoom_list_recordings","zoom_update_meeting","zoominfo_enrich_companies","zoominfo_enrich_contacts","zoominfo_search_companies","zoominfo_search_contacts","zoominfo_search_intent","zoominfo_search_news"]' + '["a2a_cancel_task","a2a_get_agent_card","a2a_get_task","a2a_send_message","agentmail_create_draft","agentmail_create_inbox","agentmail_delete_draft","agentmail_delete_inbox","agentmail_delete_thread","agentmail_forward_message","agentmail_get_draft","agentmail_get_inbox","agentmail_get_message","agentmail_get_thread","agentmail_list_drafts","agentmail_list_inboxes","agentmail_list_messages","agentmail_list_threads","agentmail_reply_message","agentmail_send_draft","agentmail_send_message","agentmail_update_draft","agentmail_update_inbox","agentmail_update_message","agentmail_update_thread","agentphone_create_call","agentphone_create_contact","agentphone_create_number","agentphone_delete_contact","agentphone_get_call","agentphone_get_call_transcript","agentphone_get_contact","agentphone_get_conversation","agentphone_get_conversation_messages","agentphone_get_number_messages","agentphone_get_usage","agentphone_get_usage_daily","agentphone_get_usage_monthly","agentphone_list_calls","agentphone_list_contacts","agentphone_list_conversations","agentphone_list_numbers","agentphone_react_to_message","agentphone_release_number","agentphone_send_message","agentphone_update_contact","agentphone_update_conversation","agiloft_attach_file","agiloft_attachment_info","agiloft_create_record","agiloft_delete_record","agiloft_get_choice_line_id","agiloft_lock_record","agiloft_read_record","agiloft_remove_attachment","agiloft_retrieve_attachment","agiloft_saved_search","agiloft_search_records","agiloft_select_records","agiloft_update_record","ahrefs_anchors","ahrefs_backlinks","ahrefs_backlinks_stats","ahrefs_batch_analysis","ahrefs_broken_backlinks","ahrefs_domain_rating","ahrefs_domain_rating_history","ahrefs_keyword_overview","ahrefs_keywords_history","ahrefs_metrics","ahrefs_metrics_history","ahrefs_organic_competitors","ahrefs_organic_keywords","ahrefs_paid_pages","ahrefs_rank_tracker_competitors_overview","ahrefs_rank_tracker_competitors_stats","ahrefs_rank_tracker_overview","ahrefs_rank_tracker_serp_overview","ahrefs_refdomains_history","ahrefs_referring_domains","ahrefs_related_terms","ahrefs_site_audit_page_explorer","ahrefs_top_pages","airtable_create_records","airtable_delete_records","airtable_get_base_schema","airtable_get_record","airtable_list_bases","airtable_list_records","airtable_list_tables","airtable_update_multiple_records","airtable_update_record","airtable_upsert_records","airweave_search","algolia_add_record","algolia_batch_operations","algolia_browse_records","algolia_clear_records","algolia_copy_move_index","algolia_delete_by_filter","algolia_delete_index","algolia_delete_record","algolia_get_record","algolia_get_records","algolia_get_settings","algolia_get_task_status","algolia_list_indices","algolia_partial_update_record","algolia_search","algolia_update_settings","amplitude_event_segmentation","amplitude_funnels","amplitude_get_active_users","amplitude_get_revenue","amplitude_group_identify","amplitude_identify_user","amplitude_list_events","amplitude_realtime_active_users","amplitude_retention","amplitude_send_event","amplitude_user_activity","amplitude_user_profile","amplitude_user_search","apify_get_dataset_items","apify_get_run","apify_run_actor_async","apify_run_actor_sync","apify_run_task","apollo_account_bulk_create","apollo_account_bulk_update","apollo_account_create","apollo_account_search","apollo_account_update","apollo_contact_bulk_create","apollo_contact_bulk_update","apollo_contact_create","apollo_contact_search","apollo_contact_update","apollo_email_accounts","apollo_opportunity_create","apollo_opportunity_get","apollo_opportunity_search","apollo_opportunity_update","apollo_organization_bulk_enrich","apollo_organization_enrich","apollo_organization_search","apollo_people_bulk_enrich","apollo_people_enrich","apollo_people_search","apollo_sequence_add_contacts","apollo_sequence_search","apollo_task_create","apollo_task_search","appconfig_create_application","appconfig_create_configuration_profile","appconfig_create_environment","appconfig_create_hosted_configuration_version","appconfig_delete_application","appconfig_delete_configuration_profile","appconfig_delete_environment","appconfig_delete_hosted_configuration_version","appconfig_get_application","appconfig_get_configuration","appconfig_get_configuration_profile","appconfig_get_deployment","appconfig_get_environment","appconfig_get_hosted_configuration_version","appconfig_list_applications","appconfig_list_configuration_profiles","appconfig_list_deployment_strategies","appconfig_list_deployments","appconfig_list_environments","appconfig_list_hosted_configuration_versions","appconfig_start_deployment","appconfig_stop_deployment","appconfig_update_application","appconfig_update_configuration_profile","appconfig_update_environment","arxiv_get_author_papers","arxiv_get_paper","arxiv_search","asana_add_comment","asana_add_followers","asana_create_project","asana_create_section","asana_create_subtask","asana_create_task","asana_delete_task","asana_get_project","asana_get_projects","asana_get_task","asana_list_sections","asana_list_workspaces","asana_search_tasks","asana_update_task","ashby_add_candidate_tag","ashby_change_application_stage","ashby_create_application","ashby_create_candidate","ashby_create_note","ashby_get_application","ashby_get_candidate","ashby_get_job","ashby_get_job_posting","ashby_get_offer","ashby_list_applications","ashby_list_archive_reasons","ashby_list_candidate_tags","ashby_list_candidates","ashby_list_custom_fields","ashby_list_departments","ashby_list_interviews","ashby_list_job_postings","ashby_list_jobs","ashby_list_locations","ashby_list_notes","ashby_list_offers","ashby_list_openings","ashby_list_sources","ashby_list_users","ashby_remove_candidate_tag","ashby_search_candidates","ashby_update_candidate","athena_batch_get_query_execution","athena_create_named_query","athena_delete_named_query","athena_get_named_query","athena_get_query_execution","athena_get_query_results","athena_list_databases","athena_list_named_queries","athena_list_query_executions","athena_list_table_metadata","athena_start_query","athena_stop_query","attio_assert_record","attio_create_attribute","attio_create_comment","attio_create_list","attio_create_list_entry","attio_create_note","attio_create_object","attio_create_record","attio_create_task","attio_create_webhook","attio_delete_comment","attio_delete_list_entry","attio_delete_note","attio_delete_record","attio_delete_task","attio_delete_webhook","attio_get_attribute","attio_get_comment","attio_get_list","attio_get_list_entry","attio_get_member","attio_get_note","attio_get_object","attio_get_record","attio_get_task","attio_get_thread","attio_get_webhook","attio_list_attributes","attio_list_lists","attio_list_members","attio_list_notes","attio_list_objects","attio_list_records","attio_list_tasks","attio_list_threads","attio_list_webhooks","attio_query_list_entries","attio_search_records","attio_update_attribute","attio_update_list","attio_update_list_entry","attio_update_object","attio_update_record","attio_update_task","attio_update_webhook","azure_devops_add_comment","azure_devops_create_work_item","azure_devops_get_build_log","azure_devops_get_build_timeline","azure_devops_get_comments","azure_devops_get_pipeline","azure_devops_get_pipeline_run","azure_devops_get_work_item","azure_devops_get_work_items_batch","azure_devops_get_work_items_between_builds","azure_devops_list_build_logs","azure_devops_list_builds","azure_devops_list_pipeline_runs","azure_devops_list_pipelines","azure_devops_query_work_items","azure_devops_update_work_item","box_copy_file","box_create_folder","box_delete_file","box_delete_folder","box_download_file","box_get_file_info","box_list_folder_items","box_search","box_sign_cancel_request","box_sign_create_request","box_sign_get_request","box_sign_list_requests","box_sign_resend_request","box_update_file","box_upload_file","brandfetch_get_brand","brandfetch_search","brex_archive_budget","brex_create_budget","brex_create_spend_limit","brex_create_transfer","brex_create_vendor","brex_get_budget","brex_get_cash_account","brex_get_company","brex_get_current_user","brex_get_expense","brex_get_spend_limit","brex_get_transfer","brex_get_user","brex_get_vendor","brex_list_budgets","brex_list_card_accounts","brex_list_card_statements","brex_list_card_transactions","brex_list_cards","brex_list_cash_accounts","brex_list_cash_statements","brex_list_cash_transactions","brex_list_departments","brex_list_expenses","brex_list_locations","brex_list_spend_limits","brex_list_titles","brex_list_transfers","brex_list_users","brex_list_vendors","brex_match_receipt","brex_update_expense","brex_update_vendor","brex_upload_receipt","brightdata_cancel_snapshot","brightdata_discover","brightdata_download_snapshot","brightdata_scrape_dataset","brightdata_scrape_url","brightdata_serp_search","brightdata_snapshot_status","brightdata_sync_scrape","browser_use_run_task","buffer_create_idea","buffer_create_post","buffer_delete_post","buffer_edit_post","buffer_get_account","buffer_get_channels","buffer_get_idea_groups","buffer_get_ideas","buffer_get_post","buffer_get_posts","calcom_cancel_booking","calcom_confirm_booking","calcom_create_booking","calcom_create_event_type","calcom_create_schedule","calcom_decline_booking","calcom_delete_event_type","calcom_delete_schedule","calcom_get_booking","calcom_get_default_schedule","calcom_get_event_type","calcom_get_schedule","calcom_get_slots","calcom_list_bookings","calcom_list_event_types","calcom_list_schedules","calcom_reschedule_booking","calcom_update_event_type","calcom_update_schedule","calendly_cancel_event","calendly_create_webhook","calendly_delete_webhook","calendly_get_current_user","calendly_get_event_type","calendly_get_scheduled_event","calendly_list_event_invitees","calendly_list_event_types","calendly_list_scheduled_events","calendly_list_webhooks","clay_populate","clerk_add_organization_member","clerk_ban_user","clerk_create_actor_token","clerk_create_allowlist_identifier","clerk_create_blocklist_identifier","clerk_create_organization","clerk_create_organization_invitation","clerk_create_user","clerk_delete_allowlist_identifier","clerk_delete_blocklist_identifier","clerk_delete_organization","clerk_delete_user","clerk_get_jwt_template","clerk_get_organization","clerk_get_session","clerk_get_user","clerk_get_user_oauth_token","clerk_list_allowlist_identifiers","clerk_list_blocklist_identifiers","clerk_list_jwt_templates","clerk_list_organization_invitations","clerk_list_organization_memberships","clerk_list_organizations","clerk_list_sessions","clerk_list_users","clerk_lock_user","clerk_remove_organization_member","clerk_revoke_actor_token","clerk_revoke_session","clerk_unban_user","clerk_unlock_user","clerk_update_organization","clerk_update_organization_membership","clerk_update_user","clickhouse_count_rows","clickhouse_create_database","clickhouse_create_table","clickhouse_delete","clickhouse_describe_table","clickhouse_drop_database","clickhouse_drop_partition","clickhouse_drop_table","clickhouse_execute","clickhouse_insert","clickhouse_insert_rows","clickhouse_introspect","clickhouse_kill_query","clickhouse_list_clusters","clickhouse_list_databases","clickhouse_list_mutations","clickhouse_list_partitions","clickhouse_list_running_queries","clickhouse_list_tables","clickhouse_optimize_table","clickhouse_query","clickhouse_rename_table","clickhouse_show_create_table","clickhouse_table_stats","clickhouse_truncate_table","clickhouse_update","clickup_add_tag_to_task","clickup_create_checklist","clickup_create_checklist_item","clickup_create_comment","clickup_create_folder","clickup_create_list","clickup_create_task","clickup_create_time_entry","clickup_delete_checklist","clickup_delete_checklist_item","clickup_delete_comment","clickup_delete_task","clickup_delete_time_entry","clickup_get_comments","clickup_get_custom_fields","clickup_get_folders","clickup_get_list_members","clickup_get_lists","clickup_get_running_timer","clickup_get_space_tags","clickup_get_spaces","clickup_get_task","clickup_get_task_members","clickup_get_tasks","clickup_get_time_entries","clickup_get_workspaces","clickup_remove_custom_field_value","clickup_remove_tag_from_task","clickup_search_tasks","clickup_set_custom_field_value","clickup_start_timer","clickup_stop_timer","clickup_update_checklist","clickup_update_checklist_item","clickup_update_comment","clickup_update_task","clickup_update_time_entry","clickup_upload_attachment","cloudflare_create_dns_record","cloudflare_create_zone","cloudflare_delete_dns_record","cloudflare_delete_zone","cloudflare_dns_analytics","cloudflare_get_zone","cloudflare_get_zone_settings","cloudflare_list_certificates","cloudflare_list_dns_records","cloudflare_list_zones","cloudflare_purge_cache","cloudflare_update_dns_record","cloudflare_update_zone_setting","cloudformation_cancel_update_stack","cloudformation_create_change_set","cloudformation_create_stack","cloudformation_delete_stack","cloudformation_describe_change_set","cloudformation_describe_stack_drift_detection_status","cloudformation_describe_stack_events","cloudformation_describe_stacks","cloudformation_detect_stack_drift","cloudformation_execute_change_set","cloudformation_get_template","cloudformation_get_template_summary","cloudformation_list_stack_resources","cloudformation_update_stack","cloudformation_validate_template","cloudwatch_describe_alarm_history","cloudwatch_describe_alarms","cloudwatch_describe_log_groups","cloudwatch_describe_log_streams","cloudwatch_filter_log_events","cloudwatch_get_log_events","cloudwatch_get_metric_statistics","cloudwatch_list_metrics","cloudwatch_mute_alarm","cloudwatch_put_log_group_retention","cloudwatch_put_metric_data","cloudwatch_query_logs","cloudwatch_unmute_alarm","codepipeline_disable_stage_transition","codepipeline_enable_stage_transition","codepipeline_get_pipeline","codepipeline_get_pipeline_execution","codepipeline_get_pipeline_state","codepipeline_list_action_executions","codepipeline_list_pipeline_executions","codepipeline_list_pipelines","codepipeline_put_approval_result","codepipeline_retry_stage_execution","codepipeline_start_execution","codepipeline_stop_execution","confluence_add_label","confluence_create_blogpost","confluence_create_comment","confluence_create_page","confluence_create_page_property","confluence_create_space","confluence_create_space_property","confluence_delete_attachment","confluence_delete_blogpost","confluence_delete_comment","confluence_delete_label","confluence_delete_page","confluence_delete_page_property","confluence_delete_space","confluence_delete_space_property","confluence_get_blogpost","confluence_get_page_ancestors","confluence_get_page_children","confluence_get_page_descendants","confluence_get_page_version","confluence_get_pages_by_label","confluence_get_space","confluence_get_task","confluence_get_user","confluence_list_attachments","confluence_list_blogposts","confluence_list_blogposts_in_space","confluence_list_comments","confluence_list_labels","confluence_list_page_properties","confluence_list_page_versions","confluence_list_pages_in_space","confluence_list_space_labels","confluence_list_space_permissions","confluence_list_space_properties","confluence_list_spaces","confluence_list_tasks","confluence_retrieve","confluence_search","confluence_search_in_space","confluence_update","confluence_update_blogpost","confluence_update_comment","confluence_update_space","confluence_update_task","confluence_upload_attachment","context_dev_classify_naics","context_dev_classify_sic","context_dev_crawl","context_dev_extract","context_dev_extract_product","context_dev_extract_products","context_dev_get_brand","context_dev_get_brand_by_email","context_dev_get_brand_by_name","context_dev_get_brand_by_ticker","context_dev_identify_transaction","context_dev_map","context_dev_scrape_fonts","context_dev_scrape_html","context_dev_scrape_images","context_dev_scrape_markdown","context_dev_scrape_styleguide","context_dev_screenshot","context_dev_search","convex_action","convex_document_deltas","convex_list_documents","convex_list_tables","convex_mutation","convex_query","convex_run_function","crowdstrike_get_sensor_aggregates","crowdstrike_get_sensor_details","crowdstrike_query_sensors","cursor_add_followup","cursor_add_followup_v2","cursor_delete_agent","cursor_delete_agent_v2","cursor_download_artifact","cursor_download_artifact_v2","cursor_get_agent","cursor_get_agent_v2","cursor_get_api_key_info","cursor_get_api_key_info_v2","cursor_get_conversation","cursor_get_conversation_v2","cursor_launch_agent","cursor_launch_agent_v2","cursor_list_agents","cursor_list_agents_v2","cursor_list_artifacts","cursor_list_artifacts_v2","cursor_list_models","cursor_list_models_v2","cursor_list_repositories","cursor_list_repositories_v2","cursor_stop_agent","cursor_stop_agent_v2","dagster_delete_run","dagster_get_asset","dagster_get_run","dagster_get_run_logs","dagster_launch_run","dagster_list_assets","dagster_list_jobs","dagster_list_runs","dagster_list_schedules","dagster_list_sensors","dagster_materialize_assets","dagster_reexecute_run","dagster_report_asset_materialization","dagster_start_schedule","dagster_start_sensor","dagster_stop_schedule","dagster_stop_sensor","dagster_terminate_run","dagster_wipe_asset","databricks_cancel_run","databricks_execute_sql","databricks_get_cluster","databricks_get_job","databricks_get_run","databricks_get_run_output","databricks_get_statement","databricks_list_clusters","databricks_list_jobs","databricks_list_runs","databricks_list_warehouses","databricks_run_job","datadog_cancel_downtime","datadog_create_downtime","datadog_create_event","datadog_create_monitor","datadog_get_monitor","datadog_list_downtimes","datadog_list_monitors","datadog_mute_monitor","datadog_query_logs","datadog_query_timeseries","datadog_send_logs","datadog_submit_metrics","datagma_enrich_company","datagma_enrich_person","datagma_find_email","datagma_find_phone","datagma_get_credits","daytona_create_sandbox","daytona_delete_sandbox","daytona_download_file","daytona_execute_command","daytona_get_sandbox","daytona_git_clone","daytona_list_files","daytona_list_sandboxes","daytona_run_code","daytona_start_sandbox","daytona_stop_sandbox","daytona_upload_file","deployed_block_executor","deployments_deploy","deployments_get_version","deployments_list_versions","deployments_promote","deployments_undeploy","devin_append_session_tags","devin_archive_session","devin_create_session","devin_get_session","devin_get_session_tags","devin_list_session_attachments","devin_list_session_messages","devin_list_sessions","devin_replace_session_tags","devin_send_message","devin_terminate_session","discord_add_reaction","discord_archive_thread","discord_assign_role","discord_ban_member","discord_bulk_delete_messages","discord_create_channel","discord_create_invite","discord_create_role","discord_create_thread","discord_create_webhook","discord_delete_channel","discord_delete_invite","discord_delete_message","discord_delete_role","discord_delete_webhook","discord_edit_message","discord_execute_webhook","discord_get_channel","discord_get_invite","discord_get_member","discord_get_messages","discord_get_pinned_messages","discord_get_server","discord_get_user","discord_get_webhook","discord_join_thread","discord_kick_member","discord_leave_thread","discord_list_channels","discord_list_roles","discord_pin_message","discord_remove_reaction","discord_remove_role","discord_send_message","discord_unban_member","discord_unpin_message","discord_update_channel","discord_update_member","discord_update_role","docusign_create_from_template","docusign_download_document","docusign_get_envelope","docusign_list_envelopes","docusign_list_recipients","docusign_list_templates","docusign_send_envelope","docusign_void_envelope","downdetector_get_company","downdetector_get_company_attribution","downdetector_get_company_baseline","downdetector_get_company_events","downdetector_get_company_incidents","downdetector_get_company_indicators","downdetector_get_company_last_15","downdetector_get_company_status","downdetector_get_provider","downdetector_get_reports","downdetector_get_site_companies","downdetector_list_categories","downdetector_list_incidents","downdetector_list_sites","downdetector_search_companies","dropbox_copy","dropbox_create_folder","dropbox_create_shared_link","dropbox_delete","dropbox_download","dropbox_get_metadata","dropbox_list_folder","dropbox_list_revisions","dropbox_list_shared_links","dropbox_move","dropbox_restore","dropbox_search","dropbox_upload","dropcontact_enrich_contact","dspy_chain_of_thought","dspy_predict","dspy_react","dub_bulk_create_links","dub_bulk_delete_links","dub_bulk_update_links","dub_create_link","dub_create_tag","dub_delete_link","dub_get_analytics","dub_get_events","dub_get_link","dub_get_links_count","dub_get_qr_code","dub_list_domains","dub_list_folders","dub_list_links","dub_list_tags","dub_update_link","dub_upsert_link","duckduckgo_search","dynamodb_delete","dynamodb_get","dynamodb_introspect","dynamodb_put","dynamodb_query","dynamodb_scan","dynamodb_update","elasticsearch_bulk","elasticsearch_cluster_health","elasticsearch_cluster_stats","elasticsearch_count","elasticsearch_create_index","elasticsearch_delete_document","elasticsearch_delete_index","elasticsearch_get_document","elasticsearch_get_index","elasticsearch_index_document","elasticsearch_list_indices","elasticsearch_search","elasticsearch_update_document","elevenlabs_audio_isolation","elevenlabs_edit_voice_settings","elevenlabs_get_user","elevenlabs_get_voice","elevenlabs_get_voice_settings","elevenlabs_list_models","elevenlabs_list_voices","elevenlabs_sound_effects","elevenlabs_speech_to_speech","elevenlabs_tts","emailbison_attach_leads_to_campaign","emailbison_attach_tags_to_leads","emailbison_create_campaign","emailbison_create_lead","emailbison_create_tag","emailbison_get_lead","emailbison_list_campaigns","emailbison_list_leads","emailbison_list_replies","emailbison_list_tags","emailbison_update_campaign","emailbison_update_campaign_status","emailbison_update_lead","enrich_check_credits","enrich_company_funding","enrich_company_lookup","enrich_company_revenue","enrich_disposable_email_check","enrich_email_to_ip","enrich_email_to_person_lite","enrich_email_to_phone","enrich_email_to_profile","enrich_find_email","enrich_get_post_details","enrich_ip_to_company","enrich_linkedin_profile","enrich_linkedin_to_personal_email","enrich_linkedin_to_work_email","enrich_phone_finder","enrich_reverse_hash_lookup","enrich_sales_pointer_people","enrich_search_company","enrich_search_company_activities","enrich_search_company_employees","enrich_search_jobs","enrich_search_logo","enrich_search_people","enrich_search_people_activities","enrich_search_post_comments","enrich_search_post_comments_by_url","enrich_search_post_reactions","enrich_search_post_reactions_by_url","enrich_search_posts","enrich_search_similar_companies","enrich_verify_email","enrichment_run","enrow_find_email","enrow_verify_email","evernote_copy_note","evernote_create_note","evernote_create_notebook","evernote_create_tag","evernote_delete_note","evernote_get_note","evernote_get_notebook","evernote_list_notebooks","evernote_list_tags","evernote_search_notes","evernote_update_note","exa_agent","exa_answer","exa_find_similar_links","exa_get_contents","exa_search","extend_parser","extend_parser_v2","fathom_get_summary","fathom_get_transcript","fathom_list_meeting_types","fathom_list_meetings","fathom_list_team_members","fathom_list_teams","file_append","file_compress","file_decompress","file_fetch","file_get","file_get_content","file_manage_sharing","file_parser","file_parser_v2","file_parser_v3","file_read","file_write","findymail_find_email_from_linkedin","findymail_find_email_from_name","findymail_find_emails_by_domain","findymail_find_employees","findymail_find_phone","findymail_get_company","findymail_get_credits","findymail_lookup_technologies","findymail_reverse_email_lookup","findymail_search_technologies","findymail_verify_email","firecrawl_agent","firecrawl_batch_scrape","firecrawl_batch_scrape_status","firecrawl_cancel_crawl","firecrawl_crawl","firecrawl_crawl_status","firecrawl_credit_usage","firecrawl_extract","firecrawl_extract_status","firecrawl_map","firecrawl_parse","firecrawl_scrape","firecrawl_search","fireflies_add_to_live_meeting","fireflies_create_bite","fireflies_delete_transcript","fireflies_get_transcript","fireflies_get_user","fireflies_list_bites","fireflies_list_contacts","fireflies_list_transcripts","fireflies_list_users","fireflies_upload_audio","flint_create_task","flint_generate_pages","flint_get_task","function_execute","gamma_check_status","gamma_generate","gamma_generate_from_template","gamma_list_folders","gamma_list_themes","github_add_assignees","github_add_assignees_v2","github_add_labels","github_add_labels_v2","github_cancel_workflow_run","github_cancel_workflow_run_v2","github_check_star","github_check_star_v2","github_close_issue","github_close_issue_v2","github_close_pr","github_close_pr_v2","github_comment","github_comment_v2","github_compare_commits","github_compare_commits_v2","github_create_branch","github_create_branch_v2","github_create_comment_reaction","github_create_comment_reaction_v2","github_create_file","github_create_file_v2","github_create_gist","github_create_gist_v2","github_create_issue","github_create_issue_reaction","github_create_issue_reaction_v2","github_create_issue_v2","github_create_milestone","github_create_milestone_v2","github_create_pr","github_create_pr_review","github_create_pr_review_v2","github_create_pr_v2","github_create_project","github_create_project_v2","github_create_release","github_create_release_v2","github_delete_branch","github_delete_branch_v2","github_delete_comment","github_delete_comment_reaction","github_delete_comment_reaction_v2","github_delete_comment_v2","github_delete_file","github_delete_file_v2","github_delete_gist","github_delete_gist_v2","github_delete_issue_reaction","github_delete_issue_reaction_v2","github_delete_milestone","github_delete_milestone_v2","github_delete_project","github_delete_project_v2","github_delete_release","github_delete_release_v2","github_fork_gist","github_fork_gist_v2","github_fork_repo","github_fork_repo_v2","github_get_branch","github_get_branch_protection","github_get_branch_protection_v2","github_get_branch_v2","github_get_commit","github_get_commit_v2","github_get_file_content","github_get_file_content_v2","github_get_gist","github_get_gist_v2","github_get_issue","github_get_issue_v2","github_get_latest_release","github_get_latest_release_v2","github_get_milestone","github_get_milestone_v2","github_get_pr_files","github_get_pr_files_v2","github_get_project","github_get_project_v2","github_get_readme","github_get_readme_v2","github_get_release","github_get_release_v2","github_get_tree","github_get_tree_v2","github_get_workflow","github_get_workflow_run","github_get_workflow_run_v2","github_get_workflow_v2","github_issue_comment","github_issue_comment_v2","github_job_logs","github_latest_commit","github_latest_commit_v2","github_list_branches","github_list_branches_v2","github_list_commits","github_list_commits_v2","github_list_forks","github_list_forks_v2","github_list_gists","github_list_gists_v2","github_list_issue_comments","github_list_issue_comments_v2","github_list_issues","github_list_issues_v2","github_list_milestones","github_list_milestones_v2","github_list_pr_comments","github_list_pr_comments_v2","github_list_projects","github_list_projects_v2","github_list_prs","github_list_prs_v2","github_list_releases","github_list_releases_v2","github_list_review_threads","github_list_stargazers","github_list_stargazers_v2","github_list_tags","github_list_tags_v2","github_list_workflow_runs","github_list_workflow_runs_v2","github_list_workflows","github_list_workflows_v2","github_merge_pr","github_merge_pr_v2","github_pr","github_pr_v2","github_remove_label","github_remove_label_v2","github_reply_review_thread","github_repo_info","github_repo_info_v2","github_request_reviewers","github_request_reviewers_v2","github_rerun_workflow","github_rerun_workflow_v2","github_resolve_review_thread","github_search_code","github_search_code_v2","github_search_commits","github_search_commits_v2","github_search_issues","github_search_issues_v2","github_search_repos","github_search_repos_v2","github_search_users","github_search_users_v2","github_star_gist","github_star_gist_v2","github_star_repo","github_star_repo_v2","github_status_check_rollup","github_trigger_workflow","github_trigger_workflow_v2","github_unstar_gist","github_unstar_gist_v2","github_unstar_repo","github_unstar_repo_v2","github_update_branch_protection","github_update_branch_protection_v2","github_update_comment","github_update_comment_v2","github_update_file","github_update_file_v2","github_update_gist","github_update_gist_v2","github_update_issue","github_update_issue_v2","github_update_milestone","github_update_milestone_v2","github_update_pr","github_update_pr_v2","github_update_project","github_update_project_v2","github_update_release","github_update_release_v2","gitlab_activate_user","gitlab_add_member","gitlab_add_saml_group_link","gitlab_approve_access_request","gitlab_approve_merge_request","gitlab_approve_user","gitlab_ban_user","gitlab_block_user","gitlab_cancel_pipeline","gitlab_compare_branches","gitlab_create_branch","gitlab_create_file","gitlab_create_issue","gitlab_create_issue_note","gitlab_create_merge_request","gitlab_create_merge_request_note","gitlab_create_pipeline","gitlab_create_release","gitlab_create_user","gitlab_deactivate_user","gitlab_delete_branch","gitlab_delete_issue","gitlab_delete_saml_group_link","gitlab_delete_user","gitlab_delete_user_identity","gitlab_deny_access_request","gitlab_get_file","gitlab_get_group","gitlab_get_issue","gitlab_get_job_log","gitlab_get_merge_request","gitlab_get_merge_request_changes","gitlab_get_pipeline","gitlab_get_project","gitlab_invite_member","gitlab_list_access_requests","gitlab_list_branches","gitlab_list_commits","gitlab_list_groups","gitlab_list_invitations","gitlab_list_issues","gitlab_list_members","gitlab_list_merge_requests","gitlab_list_pipeline_jobs","gitlab_list_pipelines","gitlab_list_projects","gitlab_list_releases","gitlab_list_repository_tree","gitlab_list_saml_group_links","gitlab_list_user_memberships","gitlab_merge_merge_request","gitlab_play_job","gitlab_reject_user","gitlab_remove_member","gitlab_retry_pipeline","gitlab_revoke_invitation","gitlab_search_users","gitlab_unban_user","gitlab_unblock_user","gitlab_update_file","gitlab_update_invitation","gitlab_update_issue","gitlab_update_member","gitlab_update_merge_request","gitlab_update_user","gmail_add_label","gmail_add_label_v2","gmail_archive","gmail_archive_v2","gmail_create_label_v2","gmail_delete","gmail_delete_draft_v2","gmail_delete_label_v2","gmail_delete_v2","gmail_draft","gmail_draft_v2","gmail_edit_draft_v2","gmail_get_draft_v2","gmail_get_thread_v2","gmail_list_drafts_v2","gmail_list_labels_v2","gmail_list_threads_v2","gmail_mark_read","gmail_mark_read_v2","gmail_mark_unread","gmail_mark_unread_v2","gmail_move","gmail_move_v2","gmail_read","gmail_read_v2","gmail_remove_label","gmail_remove_label_v2","gmail_search","gmail_search_v2","gmail_send","gmail_send_v2","gmail_trash_thread_v2","gmail_unarchive","gmail_unarchive_v2","gmail_untrash_thread_v2","gmail_update_label_v2","gong_aggregate_activity","gong_aggregate_by_period","gong_answered_scorecards","gong_ask_anything","gong_assign_flow_prospects","gong_create_call","gong_day_by_day_activity","gong_get_brief","gong_get_call","gong_get_call_transcript","gong_get_coaching","gong_get_extensive_calls","gong_get_folder_content","gong_get_logs","gong_get_prospect_flows","gong_get_user","gong_interaction_stats","gong_list_calls","gong_list_flows","gong_list_library_folders","gong_list_scorecards","gong_list_trackers","gong_list_users","gong_list_workspaces","gong_lookup_email","gong_lookup_phone","gong_purge_email_address","gong_purge_phone_number","gong_unassign_flow_prospects","google_ads_ad_performance","google_ads_campaign_performance","google_ads_list_ad_groups","google_ads_list_campaigns","google_ads_list_customers","google_ads_search","google_appsheet_add_rows","google_appsheet_delete_rows","google_appsheet_edit_rows","google_appsheet_find_rows","google_bigquery_create_dataset","google_bigquery_create_table","google_bigquery_delete_dataset","google_bigquery_delete_table","google_bigquery_get_query_results","google_bigquery_get_table","google_bigquery_insert_rows","google_bigquery_list_datasets","google_bigquery_list_table_data","google_bigquery_list_tables","google_bigquery_query","google_books_volume_details","google_books_volume_search","google_calendar_create","google_calendar_create_calendar","google_calendar_create_calendar_v2","google_calendar_create_v2","google_calendar_delete","google_calendar_delete_calendar","google_calendar_delete_calendar_v2","google_calendar_delete_v2","google_calendar_freebusy","google_calendar_freebusy_v2","google_calendar_get","google_calendar_get_v2","google_calendar_instances","google_calendar_instances_v2","google_calendar_invite","google_calendar_invite_v2","google_calendar_list","google_calendar_list_acl","google_calendar_list_acl_v2","google_calendar_list_calendars","google_calendar_list_calendars_v2","google_calendar_list_v2","google_calendar_move","google_calendar_move_v2","google_calendar_quick_add","google_calendar_quick_add_v2","google_calendar_share_calendar","google_calendar_share_calendar_v2","google_calendar_unshare_calendar","google_calendar_unshare_calendar_v2","google_calendar_update","google_calendar_update_acl","google_calendar_update_acl_v2","google_calendar_update_calendar","google_calendar_update_calendar_v2","google_calendar_update_v2","google_contacts_create","google_contacts_delete","google_contacts_get","google_contacts_list","google_contacts_search","google_contacts_update","google_docs_create","google_docs_create_named_range","google_docs_create_paragraph_bullets","google_docs_delete_content_range","google_docs_delete_named_range","google_docs_delete_paragraph_bullets","google_docs_insert_image","google_docs_insert_page_break","google_docs_insert_table","google_docs_insert_text","google_docs_read","google_docs_replace_text","google_docs_update_paragraph_style","google_docs_update_text_style","google_docs_write","google_drive_copy","google_drive_create_comment","google_drive_create_folder","google_drive_delete","google_drive_delete_comment","google_drive_download","google_drive_export","google_drive_get_about","google_drive_get_content","google_drive_get_file","google_drive_get_revision","google_drive_list","google_drive_list_comments","google_drive_list_permissions","google_drive_list_revisions","google_drive_move","google_drive_search","google_drive_share","google_drive_trash","google_drive_unshare","google_drive_untrash","google_drive_update","google_drive_upload","google_forms_batch_update","google_forms_create_form","google_forms_create_watch","google_forms_delete_watch","google_forms_get_form","google_forms_get_responses","google_forms_list_watches","google_forms_renew_watch","google_forms_set_publish_settings","google_groups_add_alias","google_groups_add_member","google_groups_create_group","google_groups_delete_group","google_groups_get_group","google_groups_get_member","google_groups_get_settings","google_groups_has_member","google_groups_list_aliases","google_groups_list_groups","google_groups_list_members","google_groups_remove_alias","google_groups_remove_member","google_groups_update_group","google_groups_update_member","google_groups_update_settings","google_maps_air_quality","google_maps_directions","google_maps_distance_matrix","google_maps_elevation","google_maps_geocode","google_maps_geolocate","google_maps_place_details","google_maps_places_nearby","google_maps_places_search","google_maps_pollen","google_maps_reverse_geocode","google_maps_snap_to_roads","google_maps_solar","google_maps_speed_limits","google_maps_timezone","google_maps_validate_address","google_meet_create_space","google_meet_end_conference","google_meet_get_conference_record","google_meet_get_space","google_meet_list_conference_records","google_meet_list_participants","google_pagespeed_analyze","google_search","google_sheets_append","google_sheets_append_v2","google_sheets_batch_clear_v2","google_sheets_batch_get_v2","google_sheets_batch_update_v2","google_sheets_clear_v2","google_sheets_copy_sheet_v2","google_sheets_create_spreadsheet_v2","google_sheets_delete_rows_v2","google_sheets_delete_sheet_v2","google_sheets_delete_spreadsheet_v2","google_sheets_get_spreadsheet_v2","google_sheets_read","google_sheets_read_v2","google_sheets_update","google_sheets_update_v2","google_sheets_write","google_sheets_write_v2","google_slides_add_image","google_slides_add_slide","google_slides_batch_update","google_slides_copy_presentation","google_slides_create","google_slides_create_line","google_slides_create_paragraph_bullets","google_slides_create_shape","google_slides_create_sheets_chart","google_slides_create_table","google_slides_create_video","google_slides_delete_object","google_slides_delete_paragraph_bullets","google_slides_delete_table_column","google_slides_delete_table_row","google_slides_delete_text","google_slides_duplicate_object","google_slides_export_presentation","google_slides_get_page","google_slides_get_thumbnail","google_slides_group_objects","google_slides_insert_table_columns","google_slides_insert_table_rows","google_slides_insert_text","google_slides_merge_table_cells","google_slides_read","google_slides_refresh_sheets_chart","google_slides_replace_all_shapes_with_image","google_slides_replace_all_shapes_with_sheets_chart","google_slides_replace_all_text","google_slides_replace_image","google_slides_reroute_line","google_slides_ungroup_objects","google_slides_unmerge_table_cells","google_slides_update_image_properties","google_slides_update_line_category","google_slides_update_line_properties","google_slides_update_page_element_alt_text","google_slides_update_page_element_transform","google_slides_update_page_elements_z_order","google_slides_update_page_properties","google_slides_update_paragraph_style","google_slides_update_shape_properties","google_slides_update_slide_properties","google_slides_update_slides_position","google_slides_update_table_border_properties","google_slides_update_table_cell_properties","google_slides_update_table_column_properties","google_slides_update_table_row_properties","google_slides_update_text_style","google_slides_update_video_properties","google_slides_write","google_tasks_create","google_tasks_delete","google_tasks_get","google_tasks_list","google_tasks_list_task_lists","google_tasks_update","google_translate_detect","google_translate_text","google_vault_add_held_accounts","google_vault_add_matters_permissions","google_vault_close_matters","google_vault_create_matters","google_vault_create_matters_export","google_vault_create_matters_holds","google_vault_create_saved_query","google_vault_delete_matters","google_vault_delete_matters_export","google_vault_delete_matters_holds","google_vault_delete_saved_query","google_vault_download_export_file","google_vault_list_matters","google_vault_list_matters_export","google_vault_list_matters_holds","google_vault_list_saved_queries","google_vault_remove_held_accounts","google_vault_remove_matters_permissions","google_vault_reopen_matters","google_vault_undelete_matters","google_vault_update_matters","google_vault_update_matters_holds","grafana_check_data_source_health","grafana_create_alert_rule","grafana_create_annotation","grafana_create_contact_point","grafana_create_dashboard","grafana_create_folder","grafana_delete_alert_rule","grafana_delete_annotation","grafana_delete_dashboard","grafana_delete_folder","grafana_get_alert_rule","grafana_get_dashboard","grafana_get_data_source","grafana_get_folder","grafana_get_health","grafana_list_alert_rules","grafana_list_annotations","grafana_list_contact_points","grafana_list_dashboards","grafana_list_data_sources","grafana_list_folders","grafana_update_alert_rule","grafana_update_annotation","grafana_update_dashboard","grafana_update_folder","grain_create_hook","grain_create_hook_v2","grain_delete_hook","grain_delete_hook_v2","grain_get_recording","grain_get_transcript","grain_list_hooks","grain_list_hooks_v2","grain_list_meeting_types","grain_list_recordings","grain_list_teams","grain_list_views","granola_get_note","granola_list_folders","granola_list_notes","greenhouse_get_application","greenhouse_get_candidate","greenhouse_get_job","greenhouse_get_user","greenhouse_list_applications","greenhouse_list_candidates","greenhouse_list_departments","greenhouse_list_job_stages","greenhouse_list_jobs","greenhouse_list_offices","greenhouse_list_users","greptile_index_repo","greptile_query","greptile_search","greptile_status","guardrails_validate","hex_cancel_run","hex_create_collection","hex_create_group","hex_deactivate_user","hex_delete_group","hex_get_collection","hex_get_data_connection","hex_get_group","hex_get_project","hex_get_project_runs","hex_get_queried_tables","hex_get_run_status","hex_list_collections","hex_list_data_connections","hex_list_groups","hex_list_projects","hex_list_users","hex_run_project","hex_update_collection","hex_update_group","hex_update_project","http_request","hubspot_add_list_memberships","hubspot_create_appointment","hubspot_create_association","hubspot_create_company","hubspot_create_contact","hubspot_create_deal","hubspot_create_email","hubspot_create_line_item","hubspot_create_list","hubspot_create_note","hubspot_create_ticket","hubspot_delete_association","hubspot_delete_company","hubspot_delete_contact","hubspot_delete_deal","hubspot_delete_line_item","hubspot_delete_ticket","hubspot_get_appointment","hubspot_get_association_labels","hubspot_get_cart","hubspot_get_company","hubspot_get_contact","hubspot_get_deal","hubspot_get_email","hubspot_get_line_item","hubspot_get_list","hubspot_get_list_memberships","hubspot_get_marketing_event","hubspot_get_note","hubspot_get_properties","hubspot_get_quote","hubspot_get_ticket","hubspot_get_users","hubspot_list_appointments","hubspot_list_associations","hubspot_list_carts","hubspot_list_companies","hubspot_list_contacts","hubspot_list_deals","hubspot_list_emails","hubspot_list_line_items","hubspot_list_lists","hubspot_list_marketing_events","hubspot_list_notes","hubspot_list_owners","hubspot_list_quotes","hubspot_list_tickets","hubspot_remove_list_memberships","hubspot_search_companies","hubspot_search_contacts","hubspot_search_deals","hubspot_search_emails","hubspot_search_line_items","hubspot_search_notes","hubspot_search_quotes","hubspot_search_tickets","hubspot_update_appointment","hubspot_update_company","hubspot_update_contact","hubspot_update_deal","hubspot_update_line_item","hubspot_update_ticket","huggingface_chat","hunter_companies_find","hunter_discover","hunter_domain_search","hunter_email_count","hunter_email_finder","hunter_email_verifier","iam_add_user_to_group","iam_attach_role_policy","iam_attach_user_policy","iam_create_access_key","iam_create_role","iam_create_user","iam_delete_access_key","iam_delete_role","iam_delete_user","iam_detach_role_policy","iam_detach_user_policy","iam_get_role","iam_get_user","iam_list_attached_role_policies","iam_list_attached_user_policies","iam_list_groups","iam_list_policies","iam_list_roles","iam_list_users","iam_remove_user_from_group","iam_simulate_principal_policy","icypeas_find_email","icypeas_verify_email","identity_center_check_assignment_deletion_status","identity_center_check_assignment_status","identity_center_create_account_assignment","identity_center_delete_account_assignment","identity_center_describe_account","identity_center_get_group","identity_center_get_user","identity_center_list_account_assignments","identity_center_list_accounts","identity_center_list_groups","identity_center_list_instances","identity_center_list_permission_sets","image_generate","incidentio_actions_list","incidentio_actions_show","incidentio_custom_fields_create","incidentio_custom_fields_delete","incidentio_custom_fields_list","incidentio_custom_fields_show","incidentio_custom_fields_update","incidentio_escalation_paths_create","incidentio_escalation_paths_delete","incidentio_escalation_paths_list","incidentio_escalation_paths_show","incidentio_escalation_paths_update","incidentio_escalations_create","incidentio_escalations_list","incidentio_escalations_show","incidentio_follow_ups_list","incidentio_follow_ups_show","incidentio_incident_roles_create","incidentio_incident_roles_delete","incidentio_incident_roles_list","incidentio_incident_roles_show","incidentio_incident_roles_update","incidentio_incident_statuses_list","incidentio_incident_timestamps_list","incidentio_incident_timestamps_show","incidentio_incident_types_list","incidentio_incident_updates_list","incidentio_incidents_create","incidentio_incidents_list","incidentio_incidents_show","incidentio_incidents_update","incidentio_schedule_entries_list","incidentio_schedule_overrides_create","incidentio_schedules_create","incidentio_schedules_delete","incidentio_schedules_list","incidentio_schedules_show","incidentio_schedules_update","incidentio_severities_list","incidentio_users_list","incidentio_users_show","incidentio_workflows_create","incidentio_workflows_delete","incidentio_workflows_list","incidentio_workflows_show","incidentio_workflows_update","infisical_create_secret","infisical_delete_secret","infisical_get_secret","infisical_list_secrets","infisical_update_secret","instagram_delete_comment","instagram_download_media","instagram_get_account_insights","instagram_get_container_status","instagram_get_conversation_messages","instagram_get_media","instagram_get_media_insights","instagram_get_message","instagram_get_profile","instagram_get_publishing_limit","instagram_hide_comment","instagram_list_comments","instagram_list_conversations","instagram_list_media","instagram_list_stories","instagram_private_reply","instagram_publish_carousel","instagram_publish_image","instagram_publish_reel","instagram_publish_story","instagram_publish_video","instagram_reply_to_comment","instagram_send_text_message","instagram_set_comments_enabled","instantly_activate_campaign","instantly_create_campaign","instantly_create_lead","instantly_create_lead_list","instantly_delete_campaign","instantly_delete_leads","instantly_get_lead","instantly_list_campaigns","instantly_list_emails","instantly_list_lead_lists","instantly_list_leads","instantly_patch_campaign","instantly_patch_lead","instantly_pause_campaign","instantly_reply_to_email","instantly_update_lead_interest_status","intercom_assign_conversation_v2","intercom_attach_contact_to_company_v2","intercom_close_conversation_v2","intercom_create_company","intercom_create_company_v2","intercom_create_contact","intercom_create_contact_v2","intercom_create_event_v2","intercom_create_message","intercom_create_message_v2","intercom_create_note_v2","intercom_create_tag_v2","intercom_create_ticket","intercom_create_ticket_v2","intercom_delete_contact","intercom_delete_contact_v2","intercom_detach_contact_from_company_v2","intercom_get_company","intercom_get_company_v2","intercom_get_contact","intercom_get_contact_v2","intercom_get_conversation","intercom_get_conversation_v2","intercom_get_ticket","intercom_get_ticket_v2","intercom_list_admins_v2","intercom_list_companies","intercom_list_companies_v2","intercom_list_contacts","intercom_list_contacts_v2","intercom_list_conversations","intercom_list_conversations_v2","intercom_list_tags_v2","intercom_open_conversation_v2","intercom_reply_conversation","intercom_reply_conversation_v2","intercom_search_contacts","intercom_search_contacts_v2","intercom_search_conversations","intercom_search_conversations_v2","intercom_snooze_conversation_v2","intercom_tag_contact_v2","intercom_tag_conversation_v2","intercom_untag_contact_v2","intercom_update_contact","intercom_update_contact_v2","intercom_update_ticket_v2","jina_read_url","jina_search","jira_add_attachment","jira_add_comment","jira_add_watcher","jira_add_worklog","jira_assign_issue","jira_bulk_read","jira_create_issue_link","jira_delete_attachment","jira_delete_comment","jira_delete_issue","jira_delete_issue_link","jira_delete_worklog","jira_get_attachments","jira_get_comments","jira_get_fields","jira_get_project","jira_get_transitions","jira_get_users","jira_get_worklogs","jira_list_issue_types","jira_list_projects","jira_remove_watcher","jira_retrieve","jira_search_issues","jira_search_users","jira_transition_issue","jira_update","jira_update_comment","jira_update_worklog","jira_write","jsm_add_comment","jsm_add_customer","jsm_add_organization","jsm_add_participants","jsm_answer_approval","jsm_attach_form","jsm_copy_forms","jsm_create_object","jsm_create_organization","jsm_create_request","jsm_delete_form","jsm_delete_object","jsm_externalise_form","jsm_get_approvals","jsm_get_comments","jsm_get_customers","jsm_get_form","jsm_get_form_answers","jsm_get_form_structure","jsm_get_form_templates","jsm_get_issue_forms","jsm_get_object","jsm_get_object_schema","jsm_get_object_type_attributes","jsm_get_organizations","jsm_get_participants","jsm_get_queues","jsm_get_request","jsm_get_request_type_fields","jsm_get_request_types","jsm_get_requests","jsm_get_service_desks","jsm_get_sla","jsm_get_transitions","jsm_internalise_form","jsm_list_object_schemas","jsm_list_object_types","jsm_reopen_form","jsm_save_form_answers","jsm_search_objects_aql","jsm_submit_form","jsm_transition_request","jsm_update_object","jupyter_copy_content","jupyter_create_file","jupyter_create_session","jupyter_delete_content","jupyter_delete_session","jupyter_get_content","jupyter_interrupt_kernel","jupyter_list_contents","jupyter_list_kernels","jupyter_list_kernelspecs","jupyter_list_sessions","jupyter_rename_content","jupyter_restart_kernel","jupyter_start_kernel","jupyter_stop_kernel","jupyter_upload_file","kalshi_amend_order","kalshi_amend_order_v2","kalshi_cancel_order","kalshi_cancel_order_v2","kalshi_create_order","kalshi_create_order_v2","kalshi_get_balance","kalshi_get_balance_v2","kalshi_get_candlesticks","kalshi_get_candlesticks_v2","kalshi_get_event","kalshi_get_event_candlesticks","kalshi_get_event_candlesticks_v2","kalshi_get_event_v2","kalshi_get_events","kalshi_get_events_v2","kalshi_get_exchange_announcements","kalshi_get_exchange_announcements_v2","kalshi_get_exchange_schedule","kalshi_get_exchange_schedule_v2","kalshi_get_exchange_status","kalshi_get_exchange_status_v2","kalshi_get_fills","kalshi_get_fills_v2","kalshi_get_market","kalshi_get_market_v2","kalshi_get_markets","kalshi_get_markets_v2","kalshi_get_order","kalshi_get_order_v2","kalshi_get_orderbook","kalshi_get_orderbook_v2","kalshi_get_orders","kalshi_get_orders_v2","kalshi_get_positions","kalshi_get_positions_v2","kalshi_get_series_by_ticker","kalshi_get_series_by_ticker_v2","kalshi_get_series_list","kalshi_get_series_list_v2","kalshi_get_settlements","kalshi_get_settlements_v2","kalshi_get_trades","kalshi_get_trades_v2","ketch_get_consent","ketch_get_subscriptions","ketch_invoke_right","ketch_set_consent","ketch_set_subscriptions","knowledge_create_document","knowledge_delete_chunk","knowledge_delete_document","knowledge_get_connector","knowledge_get_document","knowledge_list_chunks","knowledge_list_connectors","knowledge_list_documents","knowledge_list_tags","knowledge_search","knowledge_trigger_sync","knowledge_update_chunk","knowledge_upload_chunk","knowledge_upsert_document","langsmith_create_feedback","langsmith_create_run","langsmith_create_runs_batch","langsmith_get_run","langsmith_update_run","latex_compile","latex_get_package","latex_list_fonts","latex_search_packages","launchdarkly_create_flag","launchdarkly_delete_flag","launchdarkly_get_audit_log","launchdarkly_get_flag","launchdarkly_get_flag_status","launchdarkly_list_environments","launchdarkly_list_flags","launchdarkly_list_members","launchdarkly_list_projects","launchdarkly_list_segments","launchdarkly_toggle_flag","launchdarkly_update_flag","leadmagic_company_search","leadmagic_email_to_profile","leadmagic_find_email","leadmagic_find_mobile","leadmagic_get_credits","leadmagic_profile_search","leadmagic_profile_to_email","leadmagic_role_finder","leadmagic_validate_email","lemlist_get_activities","lemlist_get_lead","lemlist_send_email","linear_add_label_to_issue","linear_add_label_to_project","linear_archive_issue","linear_archive_label","linear_archive_project","linear_create_attachment","linear_create_comment","linear_create_customer","linear_create_customer_request","linear_create_customer_status","linear_create_customer_tier","linear_create_cycle","linear_create_favorite","linear_create_issue","linear_create_issue_relation","linear_create_label","linear_create_project","linear_create_project_label","linear_create_project_milestone","linear_create_project_status","linear_create_project_update","linear_create_workflow_state","linear_delete_attachment","linear_delete_comment","linear_delete_customer","linear_delete_customer_status","linear_delete_customer_tier","linear_delete_issue","linear_delete_issue_relation","linear_delete_project","linear_delete_project_label","linear_delete_project_milestone","linear_delete_project_status","linear_get_active_cycle","linear_get_customer","linear_get_cycle","linear_get_issue","linear_get_project","linear_get_viewer","linear_list_attachments","linear_list_comments","linear_list_customer_requests","linear_list_customer_statuses","linear_list_customer_tiers","linear_list_customers","linear_list_cycles","linear_list_favorites","linear_list_issue_relations","linear_list_labels","linear_list_notifications","linear_list_project_labels","linear_list_project_milestones","linear_list_project_statuses","linear_list_project_updates","linear_list_projects","linear_list_teams","linear_list_users","linear_list_workflow_states","linear_merge_customers","linear_read_issues","linear_remove_label_from_issue","linear_remove_label_from_project","linear_search_issues","linear_unarchive_issue","linear_update_attachment","linear_update_comment","linear_update_customer","linear_update_customer_request","linear_update_customer_status","linear_update_customer_tier","linear_update_issue","linear_update_label","linear_update_notification","linear_update_project","linear_update_project_label","linear_update_project_milestone","linear_update_project_status","linear_update_workflow_state","linkedin_get_profile","linkedin_share_post","linkup_search","linq_add_participant","linq_check_imessage","linq_check_rcs","linq_create_attachment","linq_create_chat","linq_create_contact_card","linq_create_webhook_subscription","linq_delete_attachment","linq_delete_message","linq_delete_webhook_subscription","linq_edit_message","linq_get_attachment","linq_get_chat","linq_get_contact_card","linq_get_message","linq_get_webhook_subscription","linq_leave_chat","linq_list_chats","linq_list_messages","linq_list_phone_numbers","linq_list_thread","linq_list_webhook_events","linq_list_webhook_subscriptions","linq_mark_chat_read","linq_react_to_message","linq_remove_participant","linq_send_message","linq_send_voice_memo","linq_share_contact_card","linq_start_typing","linq_stop_typing","linq_update_chat","linq_update_contact_card","linq_update_webhook_subscription","llm_chat","logfire_get_token_info","logfire_get_trace","logfire_query","logfire_search_records","logs_get","logs_get_execution","logs_get_run_details","logs_query","logs_query_runs","loops_check_contact_suppression","loops_create_contact","loops_create_contact_property","loops_delete_contact","loops_find_contact","loops_get_transactional_email","loops_list_contact_properties","loops_list_mailing_lists","loops_list_transactional_emails","loops_remove_contact_suppression","loops_send_event","loops_send_transactional_email","loops_update_contact","luma_add_guests","luma_cancel_event","luma_create_event","luma_get_event","luma_get_guest","luma_get_guests","luma_list_events","luma_lookup_event","luma_send_invites","luma_update_event","luma_update_guest_status","mailchimp_add_member","mailchimp_add_member_tags","mailchimp_add_or_update_member","mailchimp_add_segment_member","mailchimp_add_subscriber_to_automation","mailchimp_archive_member","mailchimp_create_audience","mailchimp_create_batch_operation","mailchimp_create_campaign","mailchimp_create_interest","mailchimp_create_interest_category","mailchimp_create_landing_page","mailchimp_create_merge_field","mailchimp_create_segment","mailchimp_create_template","mailchimp_delete_audience","mailchimp_delete_batch_operation","mailchimp_delete_campaign","mailchimp_delete_interest","mailchimp_delete_interest_category","mailchimp_delete_landing_page","mailchimp_delete_member","mailchimp_delete_merge_field","mailchimp_delete_segment","mailchimp_delete_template","mailchimp_get_audience","mailchimp_get_audiences","mailchimp_get_automation","mailchimp_get_automations","mailchimp_get_batch_operation","mailchimp_get_batch_operations","mailchimp_get_campaign","mailchimp_get_campaign_content","mailchimp_get_campaign_report","mailchimp_get_campaign_reports","mailchimp_get_campaigns","mailchimp_get_interest","mailchimp_get_interest_categories","mailchimp_get_interest_category","mailchimp_get_interests","mailchimp_get_landing_page","mailchimp_get_landing_pages","mailchimp_get_member","mailchimp_get_member_tags","mailchimp_get_members","mailchimp_get_merge_field","mailchimp_get_merge_fields","mailchimp_get_segment","mailchimp_get_segment_members","mailchimp_get_segments","mailchimp_get_template","mailchimp_get_templates","mailchimp_pause_automation","mailchimp_publish_landing_page","mailchimp_remove_member_tags","mailchimp_remove_segment_member","mailchimp_replicate_campaign","mailchimp_schedule_campaign","mailchimp_send_campaign","mailchimp_set_campaign_content","mailchimp_start_automation","mailchimp_unarchive_member","mailchimp_unpublish_landing_page","mailchimp_unschedule_campaign","mailchimp_update_audience","mailchimp_update_campaign","mailchimp_update_interest","mailchimp_update_interest_category","mailchimp_update_landing_page","mailchimp_update_member","mailchimp_update_merge_field","mailchimp_update_segment","mailchimp_update_template","mailgun_add_list_member","mailgun_create_mailing_list","mailgun_get_domain","mailgun_get_mailing_list","mailgun_get_message","mailgun_list_domains","mailgun_list_messages","mailgun_send_message","managed_agent_archive_session","managed_agent_create_session","managed_agent_delete_session","managed_agent_get_session","managed_agent_interrupt_session","managed_agent_list_events","managed_agent_respond_custom_tool","managed_agent_respond_tool_confirmation","managed_agent_run_session","managed_agent_send_message","managed_agent_update_session","mem0_add_memories","mem0_get_memories","mem0_search_memories","memory_add","memory_delete","memory_get","memory_get_all","microsoft_ad_add_group_member","microsoft_ad_create_group","microsoft_ad_create_user","microsoft_ad_delete_group","microsoft_ad_delete_user","microsoft_ad_get_group","microsoft_ad_get_user","microsoft_ad_list_group_members","microsoft_ad_list_groups","microsoft_ad_list_users","microsoft_ad_remove_group_member","microsoft_ad_update_group","microsoft_ad_update_user","microsoft_dataverse_associate","microsoft_dataverse_create_multiple","microsoft_dataverse_create_record","microsoft_dataverse_delete_record","microsoft_dataverse_disassociate","microsoft_dataverse_download_file","microsoft_dataverse_execute_action","microsoft_dataverse_execute_function","microsoft_dataverse_fetchxml_query","microsoft_dataverse_get_entity_metadata","microsoft_dataverse_get_record","microsoft_dataverse_list_records","microsoft_dataverse_search","microsoft_dataverse_update_multiple","microsoft_dataverse_update_record","microsoft_dataverse_upload_file","microsoft_dataverse_upsert_record","microsoft_dataverse_whoami","microsoft_excel_clear_range","microsoft_excel_create_table","microsoft_excel_delete_worksheet","microsoft_excel_format_range","microsoft_excel_read","microsoft_excel_read_v2","microsoft_excel_sort_range","microsoft_excel_table_add","microsoft_excel_worksheet_add","microsoft_excel_write","microsoft_excel_write_v2","microsoft_planner_create_bucket","microsoft_planner_create_plan","microsoft_planner_create_task","microsoft_planner_delete_bucket","microsoft_planner_delete_plan","microsoft_planner_delete_task","microsoft_planner_get_plan_details","microsoft_planner_get_task_details","microsoft_planner_list_buckets","microsoft_planner_list_plans","microsoft_planner_read_bucket","microsoft_planner_read_plan","microsoft_planner_read_task","microsoft_planner_update_bucket","microsoft_planner_update_plan","microsoft_planner_update_plan_details","microsoft_planner_update_task","microsoft_planner_update_task_details","microsoft_teams_delete_channel_message","microsoft_teams_delete_chat_message","microsoft_teams_get_message","microsoft_teams_list_channel_members","microsoft_teams_list_channels","microsoft_teams_list_chat_members","microsoft_teams_list_chats","microsoft_teams_list_team_members","microsoft_teams_list_teams","microsoft_teams_read_channel","microsoft_teams_read_chat","microsoft_teams_reply_to_message","microsoft_teams_set_reaction","microsoft_teams_unset_reaction","microsoft_teams_update_channel_message","microsoft_teams_update_chat_message","microsoft_teams_write_channel","microsoft_teams_write_chat","millionverifier_get_credits","millionverifier_verify_email","mistral_parser","mistral_parser_v2","mistral_parser_v3","monday_archive_item","monday_change_column_value","monday_create_board","monday_create_column","monday_create_group","monday_create_item","monday_create_subitem","monday_create_update","monday_delete_item","monday_duplicate_item","monday_get_board","monday_get_groups","monday_get_item","monday_get_items","monday_list_boards","monday_move_item_to_group","monday_search_items","monday_update_item","mongodb_delete","mongodb_execute","mongodb_insert","mongodb_introspect","mongodb_query","mongodb_update","mysql_delete","mysql_execute","mysql_insert","mysql_introspect","mysql_query","mysql_update","neo4j_create","neo4j_delete","neo4j_execute","neo4j_introspect","neo4j_merge","neo4j_query","neo4j_update","neverbounce_get_credits","neverbounce_verify_email","new_relic_create_deployment_event","new_relic_get_entity","new_relic_nrql_query","new_relic_search_entities","notion_add_database_row","notion_add_database_row_v2","notion_append_blocks","notion_append_blocks_v2","notion_create_comment","notion_create_comment_v2","notion_create_database","notion_create_database_v2","notion_create_page","notion_create_page_v2","notion_delete_block","notion_delete_block_v2","notion_list_comments","notion_list_comments_v2","notion_list_users","notion_list_users_v2","notion_query_database","notion_query_database_v2","notion_read","notion_read_database","notion_read_database_v2","notion_read_v2","notion_retrieve_block","notion_retrieve_block_children","notion_retrieve_block_children_v2","notion_retrieve_block_v2","notion_retrieve_user","notion_retrieve_user_v2","notion_search","notion_search_v2","notion_update_block","notion_update_block_v2","notion_update_page","notion_update_page_v2","notion_write","notion_write_v2","obsidian_append_active","obsidian_append_note","obsidian_append_periodic_note","obsidian_create_note","obsidian_delete_note","obsidian_execute_command","obsidian_get_active","obsidian_get_note","obsidian_get_periodic_note","obsidian_list_commands","obsidian_list_files","obsidian_open_file","obsidian_patch_active","obsidian_patch_note","obsidian_search","okta_activate_user","okta_add_user_to_group","okta_create_group","okta_create_user","okta_deactivate_user","okta_delete_group","okta_delete_user","okta_get_group","okta_get_user","okta_list_group_members","okta_list_groups","okta_list_users","okta_remove_user_from_group","okta_reset_password","okta_suspend_user","okta_unsuspend_user","okta_update_group","okta_update_user","onedrive_copy","onedrive_create_folder","onedrive_create_share_link","onedrive_delete","onedrive_download","onedrive_get_drive_info","onedrive_get_item","onedrive_list","onedrive_move","onedrive_search","onedrive_upload","onepassword_create_item","onepassword_delete_item","onepassword_get_item","onepassword_get_item_file","onepassword_get_vault","onepassword_list_items","onepassword_list_vaults","onepassword_replace_item","onepassword_resolve_secret","onepassword_update_item","openai_embeddings","openai_image","outlook_calendar_create_event","outlook_calendar_delete_event","outlook_calendar_get_event","outlook_calendar_list_events","outlook_calendar_respond","outlook_calendar_update_event","outlook_copy","outlook_create_folder","outlook_delete","outlook_draft","outlook_forward","outlook_get_attachment","outlook_list_attachments","outlook_list_folders","outlook_mark_read","outlook_mark_unread","outlook_move","outlook_read","outlook_reply","outlook_reply_all","outlook_search","outlook_send","outlook_update_message","pagerduty_add_note","pagerduty_create_incident","pagerduty_get_incident","pagerduty_get_service","pagerduty_list_escalation_policies","pagerduty_list_incident_alerts","pagerduty_list_incidents","pagerduty_list_oncalls","pagerduty_list_schedules","pagerduty_list_services","pagerduty_list_users","pagerduty_merge_incidents","pagerduty_send_event","pagerduty_snooze_incident","pagerduty_update_incident","parallel_deep_research","parallel_extract","parallel_search","pdl_autocomplete","pdl_bulk_company_enrich","pdl_bulk_person_enrich","pdl_clean_company","pdl_clean_location","pdl_clean_school","pdl_company_enrich","pdl_company_search","pdl_person_enrich","pdl_person_identify","pdl_person_search","perplexity_chat","perplexity_search","persona_approve_inquiry","persona_create_account","persona_create_inquiry","persona_create_report","persona_decline_inquiry","persona_expire_inquiry","persona_generate_inquiry_link","persona_get_account","persona_get_case","persona_get_document","persona_get_inquiry","persona_get_report","persona_get_verification","persona_import_accounts","persona_list_accounts","persona_list_cases","persona_list_inquiries","persona_list_inquiry_templates","persona_list_reports","persona_mark_inquiry_for_review","persona_print_inquiry_pdf","persona_redact_account","persona_redact_inquiry","persona_resume_inquiry","persona_update_account","persona_update_inquiry","pinecone_delete_vectors","pinecone_describe_index","pinecone_describe_index_stats","pinecone_fetch","pinecone_generate_embeddings","pinecone_list_indexes","pinecone_list_vector_ids","pinecone_search_text","pinecone_search_vector","pinecone_update_vector","pinecone_upsert_text","pipedrive_create_activity","pipedrive_create_deal","pipedrive_create_lead","pipedrive_create_project","pipedrive_delete_lead","pipedrive_get_activities","pipedrive_get_all_deals","pipedrive_get_deal","pipedrive_get_files","pipedrive_get_leads","pipedrive_get_mail_messages","pipedrive_get_mail_thread","pipedrive_get_pipeline_deals","pipedrive_get_pipelines","pipedrive_get_projects","pipedrive_update_activity","pipedrive_update_deal","pipedrive_update_lead","polymarket_get_activity","polymarket_get_event","polymarket_get_events","polymarket_get_holders","polymarket_get_last_trade_price","polymarket_get_leaderboard","polymarket_get_market","polymarket_get_markets","polymarket_get_midpoint","polymarket_get_orderbook","polymarket_get_positions","polymarket_get_price","polymarket_get_price_history","polymarket_get_series","polymarket_get_series_by_id","polymarket_get_spread","polymarket_get_tags","polymarket_get_tick_size","polymarket_get_trades","polymarket_search","postgresql_delete","postgresql_execute","postgresql_insert","postgresql_introspect","postgresql_query","postgresql_update","posthog_batch_events","posthog_capture_event","posthog_create_annotation","posthog_create_cohort","posthog_create_dashboard","posthog_create_experiment","posthog_create_feature_flag","posthog_create_insight","posthog_create_survey","posthog_delete_feature_flag","posthog_delete_person","posthog_delete_survey","posthog_evaluate_flags","posthog_get_cohort","posthog_get_dashboard","posthog_get_event_definition","posthog_get_experiment","posthog_get_feature_flag","posthog_get_insight","posthog_get_organization","posthog_get_person","posthog_get_project","posthog_get_property_definition","posthog_get_session_recording","posthog_get_survey","posthog_list_actions","posthog_list_annotations","posthog_list_cohorts","posthog_list_dashboards","posthog_list_event_definitions","posthog_list_experiments","posthog_list_feature_flags","posthog_list_insights","posthog_list_organizations","posthog_list_persons","posthog_list_projects","posthog_list_property_definitions","posthog_list_recording_playlists","posthog_list_session_recordings","posthog_list_surveys","posthog_query","posthog_update_cohort","posthog_update_event_definition","posthog_update_experiment","posthog_update_feature_flag","posthog_update_insight","posthog_update_property_definition","posthog_update_survey","profound_bot_logs","profound_bots_report","profound_category_assets","profound_category_personas","profound_category_prompts","profound_category_tags","profound_category_topics","profound_citation_prompts","profound_citations_report","profound_list_assets","profound_list_categories","profound_list_domains","profound_list_models","profound_list_optimizations","profound_list_personas","profound_list_regions","profound_optimization_analysis","profound_prompt_answers","profound_prompt_volume","profound_query_fanouts","profound_raw_logs","profound_referrals_report","profound_sentiment_report","profound_visibility_report","prospeo_account_information","prospeo_bulk_enrich_company","prospeo_bulk_enrich_person","prospeo_enrich_company","prospeo_enrich_person","prospeo_search_company","prospeo_search_person","prospeo_search_suggestions","pulse_parser","pulse_parser_v2","qdrant_fetch_points","qdrant_search_vector","qdrant_upsert_points","quartr_get_audio","quartr_get_company","quartr_get_event","quartr_get_event_summary","quartr_get_report","quartr_get_slide_deck","quartr_get_transcript","quartr_list_audio","quartr_list_companies","quartr_list_document_types","quartr_list_documents","quartr_list_event_types","quartr_list_events","quartr_list_live_events","quartr_list_reports","quartr_list_slide_decks","quartr_list_transcripts","quickbooks_add_attachment","quickbooks_create_bill","quickbooks_create_bill_payment","quickbooks_create_credit_memo","quickbooks_create_customer","quickbooks_create_customer_payment","quickbooks_create_deposit","quickbooks_create_employee","quickbooks_create_estimate","quickbooks_create_invoice","quickbooks_create_item","quickbooks_create_journal_entry","quickbooks_create_purchase","quickbooks_create_purchase_order","quickbooks_create_refund_receipt","quickbooks_create_sales_receipt","quickbooks_create_vendor","quickbooks_create_vendor_credit","quickbooks_download_attachment","quickbooks_download_transaction_pdf","quickbooks_email_transaction","quickbooks_get_company_info","quickbooks_read_accounting_transactions","quickbooks_read_attachments","quickbooks_read_master_data","quickbooks_read_purchasing_transactions","quickbooks_read_sales_transactions","quickbooks_run_financial_report","quickbooks_update_bill","quickbooks_update_bill_payment","quickbooks_update_credit_memo","quickbooks_update_customer","quickbooks_update_customer_payment","quickbooks_update_deposit","quickbooks_update_employee","quickbooks_update_estimate","quickbooks_update_invoice","quickbooks_update_item","quickbooks_update_journal_entry","quickbooks_update_purchase","quickbooks_update_purchase_order","quickbooks_update_refund_receipt","quickbooks_update_sales_receipt","quickbooks_update_vendor","quickbooks_update_vendor_credit","quickbooks_void_customer_payment","quickbooks_void_invoice","quiver_image_to_svg","quiver_list_models","quiver_text_to_svg","railway_create_environment","railway_create_project","railway_create_service","railway_delete_environment","railway_delete_project","railway_delete_service","railway_delete_variable","railway_deploy_service","railway_get_deployment","railway_get_deployment_logs","railway_get_project","railway_list_deployments","railway_list_project_members","railway_list_projects","railway_list_variables","railway_restart_deployment","railway_rollback_deployment","railway_transfer_project","railway_update_project","railway_upsert_variable","rb2b_credit_check","rb2b_email_to_activity","rb2b_hem_to_best_linkedin","rb2b_hem_to_business_profile","rb2b_hem_to_linkedin","rb2b_hem_to_maid","rb2b_ip_to_company","rb2b_ip_to_hem","rb2b_ip_to_maid","rb2b_linkedin_slug_search","rb2b_linkedin_to_best_personal_email","rb2b_linkedin_to_business_profile","rb2b_linkedin_to_hashed_emails","rb2b_linkedin_to_mobile_phone","rb2b_linkedin_to_personal_email","rds_delete","rds_execute","rds_insert","rds_introspect","rds_query","rds_update","reddit_delete","reddit_edit","reddit_get_comments","reddit_get_controversial","reddit_get_info","reddit_get_me","reddit_get_messages","reddit_get_posts","reddit_get_saved","reddit_get_subreddit_info","reddit_get_subreddit_rules","reddit_get_user","reddit_get_user_comments","reddit_get_user_posts","reddit_hide","reddit_hot_posts","reddit_list_my_subreddits","reddit_lock","reddit_mark_all_read","reddit_mark_read","reddit_marknsfw","reddit_mod_approve","reddit_mod_distinguish","reddit_mod_remove","reddit_mod_sticky","reddit_reply","reddit_report","reddit_save","reddit_search","reddit_search_subreddits","reddit_send_message","reddit_submit_post","reddit_subscribe","reddit_unhide","reddit_unlock","reddit_unmarknsfw","reddit_unsave","reddit_vote","redis_command","redis_delete","redis_exists","redis_expire","redis_get","redis_hdel","redis_hget","redis_hgetall","redis_hset","redis_incr","redis_incrby","redis_keys","redis_llen","redis_lpop","redis_lpush","redis_lrange","redis_persist","redis_rpop","redis_rpush","redis_set","redis_setnx","redis_ttl","reducto_parser","reducto_parser_v2","resend_cancel_email","resend_create_audience","resend_create_broadcast","resend_create_contact","resend_delete_audience","resend_delete_contact","resend_get_audience","resend_get_broadcast","resend_get_contact","resend_get_email","resend_list_audiences","resend_list_contacts","resend_list_domains","resend_send","resend_send_broadcast","resend_update_contact","revenuecat_create_purchase","revenuecat_defer_google_subscription","revenuecat_delete_customer","revenuecat_get_customer","revenuecat_grant_entitlement","revenuecat_list_offerings","revenuecat_refund_google_subscription","revenuecat_revoke_entitlement","revenuecat_revoke_google_subscription","revenuecat_update_subscriber_attributes","rippling_bulk_create_custom_object_records","rippling_bulk_delete_custom_object_records","rippling_bulk_update_custom_object_records","rippling_create_business_partner","rippling_create_business_partner_group","rippling_create_custom_app","rippling_create_custom_object","rippling_create_custom_object_field","rippling_create_custom_object_record","rippling_create_custom_page","rippling_create_custom_setting","rippling_create_department","rippling_create_draft_hires","rippling_create_object_category","rippling_create_title","rippling_create_work_location","rippling_delete_business_partner","rippling_delete_business_partner_group","rippling_delete_custom_app","rippling_delete_custom_object","rippling_delete_custom_object_field","rippling_delete_custom_object_record","rippling_delete_custom_page","rippling_delete_custom_setting","rippling_delete_object_category","rippling_delete_title","rippling_delete_work_location","rippling_get_business_partner","rippling_get_business_partner_group","rippling_get_current_user","rippling_get_custom_app","rippling_get_custom_object","rippling_get_custom_object_field","rippling_get_custom_object_record","rippling_get_custom_object_record_by_external_id","rippling_get_custom_page","rippling_get_custom_setting","rippling_get_department","rippling_get_employment_type","rippling_get_job_function","rippling_get_object_category","rippling_get_report_run","rippling_get_supergroup","rippling_get_team","rippling_get_title","rippling_get_user","rippling_get_work_location","rippling_get_worker","rippling_list_business_partner_groups","rippling_list_business_partners","rippling_list_companies","rippling_list_custom_apps","rippling_list_custom_fields","rippling_list_custom_object_fields","rippling_list_custom_object_records","rippling_list_custom_objects","rippling_list_custom_pages","rippling_list_custom_settings","rippling_list_departments","rippling_list_employment_types","rippling_list_entitlements","rippling_list_job_functions","rippling_list_object_categories","rippling_list_supergroup_exclusion_members","rippling_list_supergroup_inclusion_members","rippling_list_supergroup_members","rippling_list_supergroups","rippling_list_teams","rippling_list_titles","rippling_list_users","rippling_list_work_locations","rippling_list_workers","rippling_query_custom_object_records","rippling_trigger_report_run","rippling_update_custom_app","rippling_update_custom_object","rippling_update_custom_object_field","rippling_update_custom_object_record","rippling_update_custom_page","rippling_update_custom_setting","rippling_update_department","rippling_update_object_category","rippling_update_supergroup_exclusion_members","rippling_update_supergroup_inclusion_members","rippling_update_title","rippling_update_work_location","rocketlane_add_field_option","rocketlane_add_project_members","rocketlane_add_task_assignees","rocketlane_add_task_dependencies","rocketlane_add_task_followers","rocketlane_archive_project","rocketlane_assign_placeholders","rocketlane_create_field","rocketlane_create_phase","rocketlane_create_project","rocketlane_create_space","rocketlane_create_space_document","rocketlane_create_task","rocketlane_create_time_entry","rocketlane_create_time_off","rocketlane_delete_field","rocketlane_delete_phase","rocketlane_delete_project","rocketlane_delete_space","rocketlane_delete_space_document","rocketlane_delete_task","rocketlane_delete_time_entry","rocketlane_delete_time_off","rocketlane_get_field","rocketlane_get_invoice","rocketlane_get_invoice_line_items","rocketlane_get_invoice_payments","rocketlane_get_phase","rocketlane_get_project","rocketlane_get_space","rocketlane_get_space_document","rocketlane_get_task","rocketlane_get_time_entry","rocketlane_get_time_off","rocketlane_get_user","rocketlane_import_template","rocketlane_list_fields","rocketlane_list_invoices","rocketlane_list_phases","rocketlane_list_placeholders","rocketlane_list_projects","rocketlane_list_resource_allocations","rocketlane_list_space_documents","rocketlane_list_spaces","rocketlane_list_tasks","rocketlane_list_time_entries","rocketlane_list_time_entry_categories","rocketlane_list_time_offs","rocketlane_list_users","rocketlane_move_task_to_phase","rocketlane_remove_project_members","rocketlane_remove_task_assignees","rocketlane_remove_task_dependencies","rocketlane_remove_task_followers","rocketlane_search_time_entries","rocketlane_unassign_placeholders","rocketlane_update_field","rocketlane_update_field_option","rocketlane_update_phase","rocketlane_update_project","rocketlane_update_space","rocketlane_update_space_document","rocketlane_update_task","rocketlane_update_time_entry","rootly_acknowledge_alert","rootly_add_incident_event","rootly_add_subscribers","rootly_assign_incident_role","rootly_create_action_item","rootly_create_alert","rootly_create_incident","rootly_create_status_page_event","rootly_delete_action_item","rootly_delete_incident","rootly_escalate_alert","rootly_get_alert","rootly_get_incident","rootly_list_action_items","rootly_list_alerts","rootly_list_causes","rootly_list_environments","rootly_list_escalation_policies","rootly_list_functionalities","rootly_list_incident_events","rootly_list_incident_roles","rootly_list_incident_types","rootly_list_incidents","rootly_list_on_calls","rootly_list_playbooks","rootly_list_retrospectives","rootly_list_schedules","rootly_list_services","rootly_list_severities","rootly_list_teams","rootly_list_users","rootly_mitigate_incident","rootly_remove_subscribers","rootly_resolve_alert","rootly_resolve_incident","rootly_run_workflow","rootly_snooze_alert","rootly_unassign_incident_role","rootly_update_action_item","rootly_update_alert","rootly_update_incident","s3_copy_object","s3_create_bucket","s3_delete_bucket","s3_delete_object","s3_delete_objects","s3_get_object","s3_head_object","s3_list_buckets","s3_list_objects","s3_presigned_url","s3_put_object","salesforce_create_account","salesforce_create_case","salesforce_create_contact","salesforce_create_custom_field","salesforce_create_custom_object","salesforce_create_lead","salesforce_create_opportunity","salesforce_create_task","salesforce_delete_account","salesforce_delete_case","salesforce_delete_contact","salesforce_delete_custom_field","salesforce_delete_lead","salesforce_delete_opportunity","salesforce_delete_task","salesforce_describe_object","salesforce_get_accounts","salesforce_get_cases","salesforce_get_contacts","salesforce_get_dashboard","salesforce_get_leads","salesforce_get_opportunities","salesforce_get_report","salesforce_get_tasks","salesforce_list_dashboards","salesforce_list_objects","salesforce_list_report_types","salesforce_list_reports","salesforce_query","salesforce_query_more","salesforce_refresh_dashboard","salesforce_run_report","salesforce_tooling_query","salesforce_update_account","salesforce_update_case","salesforce_update_contact","salesforce_update_custom_field","salesforce_update_lead","salesforce_update_opportunity","salesforce_update_task","sap_concur_approve_expense_report","sap_concur_associate_attendees","sap_concur_create_cash_advance","sap_concur_create_expected_expense","sap_concur_create_expense_report","sap_concur_create_list_item","sap_concur_create_purchase_request","sap_concur_create_quick_expense","sap_concur_create_quick_expense_with_image","sap_concur_create_report_comment","sap_concur_create_travel_request","sap_concur_create_user","sap_concur_delete_expected_expense","sap_concur_delete_expense","sap_concur_delete_expense_report","sap_concur_delete_list_item","sap_concur_delete_travel_request","sap_concur_delete_user","sap_concur_get_allocation","sap_concur_get_budget","sap_concur_get_cash_advance","sap_concur_get_expected_expense","sap_concur_get_expense","sap_concur_get_expense_report","sap_concur_get_itemizations","sap_concur_get_itinerary","sap_concur_get_list","sap_concur_get_list_item","sap_concur_get_purchase_request","sap_concur_get_receipt","sap_concur_get_receipt_status","sap_concur_get_request_cash_advance","sap_concur_get_travel_profile","sap_concur_get_travel_request","sap_concur_get_user","sap_concur_issue_cash_advance","sap_concur_list_allocations","sap_concur_list_attendee_associations","sap_concur_list_budget_categories","sap_concur_list_budgets","sap_concur_list_exceptions","sap_concur_list_expected_expenses","sap_concur_list_expense_reports","sap_concur_list_expenses","sap_concur_list_itineraries","sap_concur_list_list_items","sap_concur_list_lists","sap_concur_list_receipts","sap_concur_list_report_comments","sap_concur_list_reports_to_approve","sap_concur_list_travel_profiles_summary","sap_concur_list_travel_request_comments","sap_concur_list_travel_requests","sap_concur_list_users","sap_concur_move_travel_request","sap_concur_recall_expense_report","sap_concur_remove_all_attendees","sap_concur_search_locations","sap_concur_search_users","sap_concur_send_back_expense_report","sap_concur_submit_expense_report","sap_concur_update_allocation","sap_concur_update_expected_expense","sap_concur_update_expense","sap_concur_update_expense_report","sap_concur_update_list_item","sap_concur_update_travel_request","sap_concur_update_user","sap_concur_upload_exchange_rates","sap_concur_upload_receipt_image","sap_s4hana_create_business_partner","sap_s4hana_create_purchase_order","sap_s4hana_create_purchase_requisition","sap_s4hana_create_sales_order","sap_s4hana_delete_sales_order","sap_s4hana_get_billing_document","sap_s4hana_get_business_partner","sap_s4hana_get_customer","sap_s4hana_get_inbound_delivery","sap_s4hana_get_material_document","sap_s4hana_get_outbound_delivery","sap_s4hana_get_product","sap_s4hana_get_purchase_order","sap_s4hana_get_purchase_requisition","sap_s4hana_get_sales_order","sap_s4hana_get_supplier","sap_s4hana_get_supplier_invoice","sap_s4hana_list_billing_documents","sap_s4hana_list_business_partners","sap_s4hana_list_customers","sap_s4hana_list_inbound_deliveries","sap_s4hana_list_material_documents","sap_s4hana_list_material_stock","sap_s4hana_list_outbound_deliveries","sap_s4hana_list_products","sap_s4hana_list_purchase_orders","sap_s4hana_list_purchase_requisitions","sap_s4hana_list_sales_orders","sap_s4hana_list_supplier_invoices","sap_s4hana_list_suppliers","sap_s4hana_odata_query","sap_s4hana_update_business_partner","sap_s4hana_update_customer","sap_s4hana_update_product","sap_s4hana_update_purchase_order","sap_s4hana_update_purchase_requisition","sap_s4hana_update_sales_order","sap_s4hana_update_supplier","search_tool","secrets_manager_create_secret","secrets_manager_delete_secret","secrets_manager_describe_secret","secrets_manager_get_secret","secrets_manager_list_secrets","secrets_manager_restore_secret","secrets_manager_rotate_secret","secrets_manager_tag_resource","secrets_manager_untag_resource","secrets_manager_update_secret","sendblue_evaluate_service","sendblue_get_message","sendblue_send_group_message","sendblue_send_message","sendblue_send_typing_indicator","sendgrid_add_contact","sendgrid_add_contacts_to_list","sendgrid_create_list","sendgrid_create_template","sendgrid_create_template_version","sendgrid_delete_contacts","sendgrid_delete_list","sendgrid_delete_template","sendgrid_get_contact","sendgrid_get_list","sendgrid_get_template","sendgrid_list_all_lists","sendgrid_list_templates","sendgrid_remove_contacts_from_list","sendgrid_search_contacts","sendgrid_send_mail","sentry_events_get","sentry_events_list","sentry_issues_get","sentry_issues_list","sentry_issues_update","sentry_projects_create","sentry_projects_get","sentry_projects_list","sentry_projects_update","sentry_releases_create","sentry_releases_deploy","sentry_releases_list","sentry_teams_list","serper_search","servicenow_aggregate","servicenow_create_record","servicenow_delete_record","servicenow_download_attachment","servicenow_list_attachments","servicenow_read_record","servicenow_update_record","servicenow_upload_attachment","ses_create_configuration_set","ses_create_email_identity","ses_create_template","ses_delete_email_identity","ses_delete_suppressed_destination","ses_delete_template","ses_get_account","ses_get_email_identity","ses_get_suppressed_destination","ses_get_template","ses_list_identities","ses_list_suppressed_destinations","ses_list_templates","ses_put_suppressed_destination","ses_send_bulk_email","ses_send_custom_verification_email","ses_send_email","ses_send_templated_email","ses_update_template","sftp_delete","sftp_download","sftp_list","sftp_mkdir","sftp_upload","sharepoint_add_list_items","sharepoint_create_list","sharepoint_create_page","sharepoint_delete_file","sharepoint_delete_list_item","sharepoint_delete_page","sharepoint_download_file","sharepoint_get_drive_item","sharepoint_get_list","sharepoint_get_list_item","sharepoint_list_sites","sharepoint_publish_page","sharepoint_read_page","sharepoint_update_list","sharepoint_update_page","sharepoint_upload_file","shopify_adjust_inventory","shopify_cancel_order","shopify_create_customer","shopify_create_fulfillment","shopify_create_product","shopify_delete_customer","shopify_delete_product","shopify_get_collection","shopify_get_customer","shopify_get_inventory_level","shopify_get_order","shopify_get_product","shopify_list_collections","shopify_list_customers","shopify_list_inventory_items","shopify_list_locations","shopify_list_orders","shopify_list_products","shopify_update_customer","shopify_update_order","shopify_update_product","similarweb_bounce_rate","similarweb_page_views","similarweb_pages_per_visit","similarweb_traffic_visits","similarweb_visit_duration","similarweb_website_overview","sixtyfour_enrich_company","sixtyfour_enrich_lead","sixtyfour_find_email","sixtyfour_find_phone","slack_add_reaction","slack_archive_conversation","slack_canvas","slack_create_channel_canvas","slack_create_conversation","slack_delete_canvas","slack_delete_message","slack_delete_scheduled_message","slack_download","slack_edit_canvas","slack_ephemeral_message","slack_get_canvas","slack_get_channel_history","slack_get_channel_info","slack_get_message","slack_get_permalink","slack_get_thread","slack_get_thread_replies","slack_get_user","slack_get_user_presence","slack_invite_to_conversation","slack_list_canvases","slack_list_channels","slack_list_members","slack_list_scheduled_messages","slack_list_users","slack_lookup_canvas_sections","slack_message","slack_message_reader","slack_open_view","slack_publish_view","slack_push_view","slack_remove_reaction","slack_rename_conversation","slack_schedule_message","slack_set_conversation_purpose","slack_set_conversation_topic","slack_set_status","slack_set_suggested_prompts","slack_set_title","slack_update_message","slack_update_view","sms_send","smtp_send_mail","sportmonks_core_get_cities","sportmonks_core_get_city","sportmonks_core_get_continent","sportmonks_core_get_continents","sportmonks_core_get_countries","sportmonks_core_get_country","sportmonks_core_get_entity_filters","sportmonks_core_get_my_usage","sportmonks_core_get_region","sportmonks_core_get_regions","sportmonks_core_get_timezones","sportmonks_core_get_type","sportmonks_core_get_type_by_entity","sportmonks_core_get_types","sportmonks_core_search_cities","sportmonks_core_search_countries","sportmonks_core_search_regions","sportmonks_football_expected_by_player","sportmonks_football_expected_by_team","sportmonks_football_get_all_commentaries","sportmonks_football_get_all_fixtures","sportmonks_football_get_all_players","sportmonks_football_get_all_rivals","sportmonks_football_get_all_teams","sportmonks_football_get_all_transfer_rumours","sportmonks_football_get_all_transfers","sportmonks_football_get_brackets_by_season","sportmonks_football_get_coach","sportmonks_football_get_coaches","sportmonks_football_get_coaches_by_country","sportmonks_football_get_commentaries_by_fixture","sportmonks_football_get_current_leagues_by_team","sportmonks_football_get_expected_lineups_by_player","sportmonks_football_get_expected_lineups_by_team","sportmonks_football_get_extended_team_squad","sportmonks_football_get_fixture","sportmonks_football_get_fixtures_by_date","sportmonks_football_get_fixtures_by_date_range","sportmonks_football_get_fixtures_by_date_range_for_team","sportmonks_football_get_fixtures_by_ids","sportmonks_football_get_grouped_standings_by_round","sportmonks_football_get_head_to_head","sportmonks_football_get_inplay_livescores","sportmonks_football_get_latest_coaches","sportmonks_football_get_latest_fixtures","sportmonks_football_get_latest_livescores","sportmonks_football_get_latest_players","sportmonks_football_get_latest_totw","sportmonks_football_get_latest_transfers","sportmonks_football_get_league","sportmonks_football_get_leagues","sportmonks_football_get_leagues_by_country","sportmonks_football_get_leagues_by_date","sportmonks_football_get_leagues_by_team","sportmonks_football_get_live_leagues","sportmonks_football_get_live_probabilities","sportmonks_football_get_live_probabilities_by_fixture","sportmonks_football_get_live_standings_by_league","sportmonks_football_get_livescores","sportmonks_football_get_match_facts","sportmonks_football_get_match_facts_by_date_range","sportmonks_football_get_match_facts_by_fixture","sportmonks_football_get_match_facts_by_league","sportmonks_football_get_past_fixtures_by_tv_station","sportmonks_football_get_player","sportmonks_football_get_players_by_country","sportmonks_football_get_postmatch_news","sportmonks_football_get_postmatch_news_by_season","sportmonks_football_get_predictability_by_league","sportmonks_football_get_prematch_news","sportmonks_football_get_prematch_news_by_season","sportmonks_football_get_prematch_news_upcoming","sportmonks_football_get_probabilities","sportmonks_football_get_probabilities_by_fixture","sportmonks_football_get_referee","sportmonks_football_get_referees","sportmonks_football_get_referees_by_country","sportmonks_football_get_referees_by_season","sportmonks_football_get_rivals_by_team","sportmonks_football_get_round","sportmonks_football_get_round_statistics","sportmonks_football_get_rounds","sportmonks_football_get_rounds_by_season","sportmonks_football_get_schedules_by_season","sportmonks_football_get_schedules_by_season_and_team","sportmonks_football_get_schedules_by_team","sportmonks_football_get_season","sportmonks_football_get_seasons","sportmonks_football_get_seasons_by_team","sportmonks_football_get_stage","sportmonks_football_get_stage_statistics","sportmonks_football_get_stages","sportmonks_football_get_stages_by_season","sportmonks_football_get_standing_corrections_by_season","sportmonks_football_get_standings","sportmonks_football_get_standings_by_round","sportmonks_football_get_standings_by_season","sportmonks_football_get_state","sportmonks_football_get_states","sportmonks_football_get_team","sportmonks_football_get_team_rankings","sportmonks_football_get_team_rankings_by_date","sportmonks_football_get_team_rankings_by_team","sportmonks_football_get_team_squad","sportmonks_football_get_team_squad_by_season","sportmonks_football_get_teams_by_country","sportmonks_football_get_teams_by_season","sportmonks_football_get_topscorers_by_season","sportmonks_football_get_topscorers_by_stage","sportmonks_football_get_totw","sportmonks_football_get_totw_by_round","sportmonks_football_get_transfer","sportmonks_football_get_transfer_rumour","sportmonks_football_get_transfer_rumours_between_dates","sportmonks_football_get_transfer_rumours_by_player","sportmonks_football_get_transfer_rumours_by_team","sportmonks_football_get_transfers_between_dates","sportmonks_football_get_transfers_by_player","sportmonks_football_get_transfers_by_team","sportmonks_football_get_tv_station","sportmonks_football_get_tv_stations","sportmonks_football_get_tv_stations_by_fixture","sportmonks_football_get_upcoming_fixtures_by_market","sportmonks_football_get_upcoming_fixtures_by_tv_station","sportmonks_football_get_value_bets","sportmonks_football_get_value_bets_by_fixture","sportmonks_football_get_venue","sportmonks_football_get_venues","sportmonks_football_get_venues_by_season","sportmonks_football_search_coaches","sportmonks_football_search_fixtures","sportmonks_football_search_leagues","sportmonks_football_search_players","sportmonks_football_search_referees","sportmonks_football_search_rounds","sportmonks_football_search_seasons","sportmonks_football_search_stages","sportmonks_football_search_teams","sportmonks_football_search_venues","sportmonks_motorsport_get_all_fixtures","sportmonks_motorsport_get_current_leagues_by_team","sportmonks_motorsport_get_driver","sportmonks_motorsport_get_driver_standings","sportmonks_motorsport_get_driver_standings_by_season","sportmonks_motorsport_get_drivers","sportmonks_motorsport_get_drivers_by_country","sportmonks_motorsport_get_drivers_by_season","sportmonks_motorsport_get_fixture","sportmonks_motorsport_get_fixtures_by_date","sportmonks_motorsport_get_fixtures_by_date_range","sportmonks_motorsport_get_fixtures_by_ids","sportmonks_motorsport_get_laps_by_fixture","sportmonks_motorsport_get_laps_by_fixture_and_driver","sportmonks_motorsport_get_laps_by_fixture_and_lap","sportmonks_motorsport_get_latest_laps_by_fixture","sportmonks_motorsport_get_latest_pitstops_by_fixture","sportmonks_motorsport_get_latest_stints_by_fixture","sportmonks_motorsport_get_latest_updated_drivers","sportmonks_motorsport_get_latest_updated_fixtures","sportmonks_motorsport_get_league","sportmonks_motorsport_get_leagues","sportmonks_motorsport_get_leagues_by_country","sportmonks_motorsport_get_leagues_by_date","sportmonks_motorsport_get_leagues_by_live","sportmonks_motorsport_get_leagues_by_team","sportmonks_motorsport_get_livescores","sportmonks_motorsport_get_pitstops_by_fixture","sportmonks_motorsport_get_pitstops_by_fixture_and_driver","sportmonks_motorsport_get_pitstops_by_fixture_and_lap","sportmonks_motorsport_get_race_results_by_season_and_driver","sportmonks_motorsport_get_race_results_by_season_and_team","sportmonks_motorsport_get_schedules_by_season","sportmonks_motorsport_get_season","sportmonks_motorsport_get_seasons","sportmonks_motorsport_get_stage","sportmonks_motorsport_get_stages","sportmonks_motorsport_get_stages_by_season","sportmonks_motorsport_get_state","sportmonks_motorsport_get_states","sportmonks_motorsport_get_stints_by_fixture","sportmonks_motorsport_get_stints_by_fixture_and_driver","sportmonks_motorsport_get_stints_by_fixture_and_stint","sportmonks_motorsport_get_team","sportmonks_motorsport_get_team_standings","sportmonks_motorsport_get_team_standings_by_season","sportmonks_motorsport_get_teams","sportmonks_motorsport_get_teams_by_country","sportmonks_motorsport_get_teams_by_season","sportmonks_motorsport_get_venue","sportmonks_motorsport_get_venues","sportmonks_motorsport_get_venues_by_season","sportmonks_motorsport_search_drivers","sportmonks_motorsport_search_leagues","sportmonks_motorsport_search_stages","sportmonks_motorsport_search_teams","sportmonks_motorsport_search_venues","sportmonks_odds_get_all_historical_odds","sportmonks_odds_get_all_inplay_odds","sportmonks_odds_get_all_pre_match_odds","sportmonks_odds_get_all_premium_odds","sportmonks_odds_get_bookmaker","sportmonks_odds_get_bookmaker_event_ids_by_fixture","sportmonks_odds_get_bookmakers","sportmonks_odds_get_bookmakers_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture_and_bookmaker","sportmonks_odds_get_inplay_odds_by_fixture_and_market","sportmonks_odds_get_last_updated_inplay_odds","sportmonks_odds_get_last_updated_pre_match_odds","sportmonks_odds_get_market","sportmonks_odds_get_markets","sportmonks_odds_get_pre_match_odds_by_fixture","sportmonks_odds_get_pre_match_odds_by_fixture_and_bookmaker","sportmonks_odds_get_pre_match_odds_by_fixture_and_market","sportmonks_odds_get_premium_odds_by_fixture","sportmonks_odds_get_premium_odds_by_fixture_and_bookmaker","sportmonks_odds_get_premium_odds_by_fixture_and_market","sportmonks_odds_get_updated_historical_odds_between","sportmonks_odds_get_updated_premium_odds_between","sportmonks_odds_search_bookmakers","sportmonks_odds_search_markets","spotify_add_playlist_cover","spotify_add_to_queue","spotify_add_tracks_to_playlist","spotify_check_following","spotify_check_playlist_followers","spotify_check_saved_albums","spotify_check_saved_audiobooks","spotify_check_saved_episodes","spotify_check_saved_shows","spotify_check_saved_tracks","spotify_create_playlist","spotify_follow_artists","spotify_follow_playlist","spotify_get_album","spotify_get_album_tracks","spotify_get_albums","spotify_get_artist","spotify_get_artist_albums","spotify_get_artist_top_tracks","spotify_get_artists","spotify_get_audiobook","spotify_get_audiobook_chapters","spotify_get_audiobooks","spotify_get_categories","spotify_get_current_user","spotify_get_currently_playing","spotify_get_devices","spotify_get_episode","spotify_get_episodes","spotify_get_followed_artists","spotify_get_markets","spotify_get_new_releases","spotify_get_playback_state","spotify_get_playlist","spotify_get_playlist_cover","spotify_get_playlist_tracks","spotify_get_queue","spotify_get_recently_played","spotify_get_saved_albums","spotify_get_saved_audiobooks","spotify_get_saved_episodes","spotify_get_saved_shows","spotify_get_saved_tracks","spotify_get_show","spotify_get_show_episodes","spotify_get_shows","spotify_get_top_artists","spotify_get_top_tracks","spotify_get_track","spotify_get_tracks","spotify_get_user_playlists","spotify_get_user_profile","spotify_pause","spotify_play","spotify_remove_saved_albums","spotify_remove_saved_audiobooks","spotify_remove_saved_episodes","spotify_remove_saved_shows","spotify_remove_saved_tracks","spotify_remove_tracks_from_playlist","spotify_reorder_playlist_items","spotify_replace_playlist_items","spotify_save_albums","spotify_save_audiobooks","spotify_save_episodes","spotify_save_shows","spotify_save_tracks","spotify_search","spotify_seek","spotify_set_repeat","spotify_set_shuffle","spotify_set_volume","spotify_skip_next","spotify_skip_previous","spotify_transfer_playback","spotify_unfollow_artists","spotify_unfollow_playlist","spotify_update_playlist","sqs_send","square_batch_retrieve_inventory_counts","square_cancel_invoice","square_cancel_payment","square_complete_payment","square_create_catalog_image","square_create_customer","square_create_invoice","square_create_order","square_create_payment","square_delete_catalog_object","square_delete_customer","square_delete_invoice","square_get_catalog_object","square_get_customer","square_get_invoice","square_get_location","square_get_order","square_get_payment","square_get_refund","square_list_catalog","square_list_customers","square_list_invoices","square_list_locations","square_list_payments","square_list_refunds","square_pay_order","square_publish_invoice","square_refund_payment","square_search_catalog_objects","square_search_customers","square_search_invoices","square_search_orders","square_update_customer","square_upsert_catalog_object","ssh_check_command_exists","ssh_check_file_exists","ssh_create_directory","ssh_delete_file","ssh_download_file","ssh_execute_command","ssh_execute_script","ssh_get_system_info","ssh_list_directory","ssh_move_rename","ssh_read_file_content","ssh_upload_file","ssh_write_file_content","stagehand_agent","stagehand_extract","stripe_cancel_payment_intent","stripe_cancel_subscription","stripe_capture_charge","stripe_capture_payment_intent","stripe_confirm_payment_intent","stripe_create_charge","stripe_create_customer","stripe_create_invoice","stripe_create_payment_intent","stripe_create_price","stripe_create_product","stripe_create_subscription","stripe_delete_customer","stripe_delete_invoice","stripe_delete_product","stripe_finalize_invoice","stripe_list_charges","stripe_list_customers","stripe_list_events","stripe_list_invoices","stripe_list_payment_intents","stripe_list_prices","stripe_list_products","stripe_list_subscriptions","stripe_pay_invoice","stripe_resume_subscription","stripe_retrieve_charge","stripe_retrieve_customer","stripe_retrieve_event","stripe_retrieve_invoice","stripe_retrieve_payment_intent","stripe_retrieve_price","stripe_retrieve_product","stripe_retrieve_subscription","stripe_search_charges","stripe_search_customers","stripe_search_invoices","stripe_search_payment_intents","stripe_search_prices","stripe_search_products","stripe_search_subscriptions","stripe_send_invoice","stripe_update_charge","stripe_update_customer","stripe_update_invoice","stripe_update_payment_intent","stripe_update_price","stripe_update_product","stripe_update_subscription","stripe_void_invoice","sts_assume_role","sts_assume_role_with_saml","sts_assume_role_with_web_identity","sts_get_access_key_info","sts_get_caller_identity","sts_get_session_token","stt_assemblyai","stt_assemblyai_v2","stt_deepgram","stt_deepgram_v2","stt_elevenlabs","stt_elevenlabs_v2","stt_gemini","stt_gemini_v2","stt_whisper","stt_whisper_v2","supabase_count","supabase_delete","supabase_get_row","supabase_insert","supabase_introspect","supabase_invoke_function","supabase_query","supabase_rpc","supabase_storage_copy","supabase_storage_create_bucket","supabase_storage_create_signed_upload_url","supabase_storage_create_signed_url","supabase_storage_delete","supabase_storage_delete_bucket","supabase_storage_download","supabase_storage_empty_bucket","supabase_storage_get_public_url","supabase_storage_list","supabase_storage_list_buckets","supabase_storage_move","supabase_storage_update_bucket","supabase_storage_upload","supabase_text_search","supabase_update","supabase_upsert","supabase_vector_search","table_batch_insert_rows","table_create","table_delete_row","table_delete_rows_by_filter","table_get_row","table_get_schema","table_insert_row","table_list","table_query_rows","table_query_rows_v2","table_update_row","table_update_rows_by_filter","table_upsert_row","tailscale_authorize_device","tailscale_create_auth_key","tailscale_delete_auth_key","tailscale_delete_device","tailscale_delete_user","tailscale_expire_device_key","tailscale_get_acl","tailscale_get_auth_key","tailscale_get_device","tailscale_get_device_routes","tailscale_get_dns_preferences","tailscale_get_dns_searchpaths","tailscale_list_auth_keys","tailscale_list_devices","tailscale_list_dns_nameservers","tailscale_list_users","tailscale_set_acl","tailscale_set_device_routes","tailscale_set_device_tags","tailscale_set_dns_nameservers","tailscale_set_dns_preferences","tailscale_set_dns_searchpaths","tailscale_suspend_user","tailscale_update_device_key","tavily_crawl","tavily_extract","tavily_map","tavily_search","telegram_copy_message","telegram_delete_message","telegram_edit_message_text","telegram_forward_message","telegram_get_chat","telegram_get_chat_member","telegram_message","telegram_pin_message","telegram_send_animation","telegram_send_audio","telegram_send_chat_action","telegram_send_contact","telegram_send_document","telegram_send_location","telegram_send_photo","telegram_send_poll","telegram_send_video","telegram_set_message_reaction","telegram_unpin_message","temporal_cancel_workflow","temporal_count_workflows","temporal_create_schedule","temporal_delete_schedule","temporal_describe_schedule","temporal_describe_task_queue","temporal_describe_workflow","temporal_get_workflow_history","temporal_list_schedules","temporal_list_workflows","temporal_pause_schedule","temporal_query_workflow","temporal_reset_workflow","temporal_signal_with_start","temporal_signal_workflow","temporal_start_workflow","temporal_terminate_workflow","temporal_trigger_schedule","temporal_unpause_schedule","temporal_update_workflow","textract_analyze_expense","textract_analyze_id","textract_parser","textract_parser_v2","thinking_tool","thrive_add_audience_managers","thrive_add_audience_members","thrive_add_user_tags","thrive_create_assignment","thrive_create_audience","thrive_create_completion","thrive_create_user","thrive_delete_assignment","thrive_delete_audience","thrive_delete_user","thrive_get_activity","thrive_get_assignment","thrive_get_audience","thrive_get_completion","thrive_get_content","thrive_get_cpd_category","thrive_get_cpd_entry","thrive_get_cpd_requirement","thrive_get_enrolment","thrive_get_skill_levels","thrive_get_tag","thrive_get_user_by_id","thrive_get_user_by_ref","thrive_list_assignments","thrive_list_audience_managers","thrive_list_audience_members","thrive_list_audiences","thrive_list_completions","thrive_list_enrolments","thrive_list_tags","thrive_query_activities","thrive_query_content","thrive_query_cpd_categories","thrive_query_cpd_entries","thrive_query_cpd_requirements","thrive_query_cpd_user_summaries","thrive_remove_audience_manager","thrive_remove_audience_member","thrive_remove_user_tags","thrive_replace_audience_managers","thrive_replace_audience_members","thrive_search_users","thrive_suspend_user","thrive_update_assignment","thrive_update_audience","thrive_update_user","thrive_update_user_skills","tiktok_get_post_status","tiktok_get_user","tiktok_list_videos","tiktok_query_videos","tiktok_upload_video_draft","tinybird_append_datasource","tinybird_delete_datasource_rows","tinybird_events","tinybird_get_job","tinybird_query","tinybird_query_pipe","tinybird_truncate_datasource","trello_add_checklist","trello_add_checklist_item","trello_add_comment","trello_add_label","trello_add_member","trello_create_board","trello_create_card","trello_create_list","trello_delete_card","trello_get_actions","trello_get_board","trello_get_card","trello_list_cards","trello_list_lists","trello_list_members","trello_remove_label","trello_remove_member","trello_search","trello_update_card","trello_update_checklist_item","trello_update_list","trigger_dev_activate_schedule","trigger_dev_add_run_tags","trigger_dev_batch_trigger_task","trigger_dev_cancel_run","trigger_dev_complete_waitpoint_token","trigger_dev_create_env_var","trigger_dev_create_schedule","trigger_dev_create_waitpoint_token","trigger_dev_deactivate_schedule","trigger_dev_delete_env_var","trigger_dev_delete_schedule","trigger_dev_execute_query","trigger_dev_get_batch","trigger_dev_get_batch_results","trigger_dev_get_deployment","trigger_dev_get_env_var","trigger_dev_get_latest_deployment","trigger_dev_get_query_schema","trigger_dev_get_queue","trigger_dev_get_run","trigger_dev_get_run_events","trigger_dev_get_run_result","trigger_dev_get_run_trace","trigger_dev_get_schedule","trigger_dev_get_waitpoint_token","trigger_dev_import_env_vars","trigger_dev_list_deployments","trigger_dev_list_env_vars","trigger_dev_list_queues","trigger_dev_list_runs","trigger_dev_list_schedules","trigger_dev_list_timezones","trigger_dev_list_waitpoint_tokens","trigger_dev_override_queue_concurrency","trigger_dev_pause_queue","trigger_dev_promote_deployment","trigger_dev_replay_run","trigger_dev_reschedule_run","trigger_dev_reset_queue_concurrency","trigger_dev_resume_queue","trigger_dev_trigger_task","trigger_dev_update_env_var","trigger_dev_update_run_metadata","trigger_dev_update_schedule","tts_azure","tts_cartesia","tts_deepgram","tts_elevenlabs","tts_google","tts_openai","tts_playht","twilio_send_sms","twilio_voice_get_recording","twilio_voice_list_calls","twilio_voice_make_call","typeform_create_form","typeform_delete_form","typeform_files","typeform_get_form","typeform_insights","typeform_list_forms","typeform_responses","typeform_update_form","upstash_redis_command","upstash_redis_delete","upstash_redis_exists","upstash_redis_expire","upstash_redis_get","upstash_redis_hget","upstash_redis_hgetall","upstash_redis_hset","upstash_redis_incr","upstash_redis_incrby","upstash_redis_keys","upstash_redis_lpush","upstash_redis_lrange","upstash_redis_set","upstash_redis_setnx","upstash_redis_ttl","uptimerobot_create_alert_contact","uptimerobot_create_maintenance_window","uptimerobot_create_monitor","uptimerobot_create_psp","uptimerobot_delete_alert_contact","uptimerobot_delete_maintenance_window","uptimerobot_delete_monitor","uptimerobot_delete_psp","uptimerobot_get_account","uptimerobot_get_alert_contact","uptimerobot_get_incident","uptimerobot_get_maintenance_window","uptimerobot_get_monitor","uptimerobot_get_psp","uptimerobot_list_alert_contacts","uptimerobot_list_incidents","uptimerobot_list_maintenance_windows","uptimerobot_list_monitors","uptimerobot_list_psps","uptimerobot_pause_monitor","uptimerobot_start_monitor","uptimerobot_update_maintenance_window","uptimerobot_update_monitor","uptimerobot_update_psp","vanta_download_document_file","vanta_get_control","vanta_get_document","vanta_get_framework","vanta_get_person","vanta_get_policy","vanta_get_risk_scenario","vanta_get_test","vanta_get_vendor","vanta_get_vulnerable_asset","vanta_list_control_documents","vanta_list_control_tests","vanta_list_controls","vanta_list_document_uploads","vanta_list_documents","vanta_list_framework_controls","vanta_list_frameworks","vanta_list_monitored_computers","vanta_list_people","vanta_list_policies","vanta_list_risk_scenarios","vanta_list_test_entities","vanta_list_tests","vanta_list_vendors","vanta_list_vulnerabilities","vanta_list_vulnerability_remediations","vanta_list_vulnerable_assets","vanta_submit_document","vanta_upload_document_file","vercel_add_domain","vercel_add_project_domain","vercel_cancel_deployment","vercel_create_alias","vercel_create_check","vercel_create_deployment","vercel_create_dns_record","vercel_create_edge_config","vercel_create_env_var","vercel_create_project","vercel_create_webhook","vercel_delete_alias","vercel_delete_deployment","vercel_delete_dns_record","vercel_delete_domain","vercel_delete_edge_config","vercel_delete_env_var","vercel_delete_project","vercel_delete_webhook","vercel_get_alias","vercel_get_check","vercel_get_deployment","vercel_get_deployment_events","vercel_get_domain","vercel_get_domain_config","vercel_get_edge_config","vercel_get_edge_config_items","vercel_get_env_vars","vercel_get_project","vercel_get_team","vercel_get_user","vercel_get_webhook","vercel_list_aliases","vercel_list_checks","vercel_list_deployment_files","vercel_list_deployments","vercel_list_dns_records","vercel_list_domains","vercel_list_edge_configs","vercel_list_project_domains","vercel_list_projects","vercel_list_team_members","vercel_list_teams","vercel_list_webhooks","vercel_pause_project","vercel_promote_deployment","vercel_remove_project_domain","vercel_rerequest_check","vercel_unpause_project","vercel_update_check","vercel_update_dns_record","vercel_update_edge_config_items","vercel_update_env_var","vercel_update_project","vercel_update_project_domain","vercel_verify_project_domain","video_falai","video_luma","video_minimax","video_runway","video_veo","vision_tool","vision_tool_v2","wealthbox_read_contact","wealthbox_read_note","wealthbox_read_task","wealthbox_write_contact","wealthbox_write_note","wealthbox_write_task","webflow_create_item","webflow_delete_item","webflow_get_item","webflow_list_items","webflow_update_item","webhook_request","whatsapp_get_media","whatsapp_mark_read","whatsapp_send_interactive","whatsapp_send_media","whatsapp_send_message","whatsapp_send_reaction","whatsapp_send_template","whatsapp_upload_media","wikipedia_content","wikipedia_random","wikipedia_search","wikipedia_summary","wiza_company_enrichment","wiza_get_credits","wiza_individual_reveal","wiza_prospect_search","wordpress_create_category","wordpress_create_comment","wordpress_create_page","wordpress_create_post","wordpress_create_tag","wordpress_delete_category","wordpress_delete_comment","wordpress_delete_media","wordpress_delete_page","wordpress_delete_post","wordpress_delete_tag","wordpress_get_category","wordpress_get_current_user","wordpress_get_media","wordpress_get_page","wordpress_get_post","wordpress_get_tag","wordpress_get_user","wordpress_list_categories","wordpress_list_comments","wordpress_list_media","wordpress_list_pages","wordpress_list_posts","wordpress_list_tags","wordpress_list_users","wordpress_search_content","wordpress_update_category","wordpress_update_comment","wordpress_update_page","wordpress_update_post","wordpress_update_tag","wordpress_upload_media","workday_assign_onboarding","workday_change_job","workday_create_prehire","workday_get_compensation","workday_get_organizations","workday_get_worker","workday_hire_employee","workday_list_workers","workday_terminate_worker","workday_update_worker","workflow_executor","x_create_bookmark","x_create_tweet","x_delete_bookmark","x_delete_tweet","x_get_blocking","x_get_bookmarks","x_get_followers","x_get_following","x_get_liked_tweets","x_get_liking_users","x_get_me","x_get_personalized_trends","x_get_quote_tweets","x_get_retweeted_by","x_get_trends_by_woeid","x_get_tweets_by_ids","x_get_usage","x_get_user_mentions","x_get_user_timeline","x_get_user_tweets","x_hide_reply","x_manage_block","x_manage_follow","x_manage_like","x_manage_mute","x_manage_retweet","x_read","x_search","x_search_tweets","x_search_users","x_user","x_write","youtube_channel_info","youtube_channel_playlists","youtube_channel_videos","youtube_comments","youtube_playlist_items","youtube_search","youtube_trending","youtube_video_categories","youtube_video_details","zendesk_autocomplete_organizations","zendesk_create_organization","zendesk_create_organizations_bulk","zendesk_create_ticket","zendesk_create_tickets_bulk","zendesk_create_user","zendesk_create_users_bulk","zendesk_delete_organization","zendesk_delete_ticket","zendesk_delete_user","zendesk_get_current_user","zendesk_get_organization","zendesk_get_organizations","zendesk_get_ticket","zendesk_get_tickets","zendesk_get_user","zendesk_get_users","zendesk_merge_tickets","zendesk_search","zendesk_search_count","zendesk_search_users","zendesk_update_organization","zendesk_update_ticket","zendesk_update_tickets_bulk","zendesk_update_user","zendesk_update_users_bulk","zep_add_messages","zep_add_user","zep_create_thread","zep_delete_thread","zep_get_context","zep_get_messages","zep_get_threads","zep_get_user","zep_get_user_threads","zerobounce_get_credits","zerobounce_verify_email","zoho_desk_add_comment","zoho_desk_get_attachment","zoho_desk_get_contact","zoho_desk_get_thread","zoho_desk_get_ticket","zoho_desk_list_comments","zoho_desk_list_organizations","zoho_desk_list_threads","zoho_desk_list_tickets","zoho_desk_update_ticket","zoom_create_meeting","zoom_delete_meeting","zoom_delete_recording","zoom_get_meeting","zoom_get_meeting_invitation","zoom_get_meeting_recordings","zoom_list_meetings","zoom_list_past_participants","zoom_list_recordings","zoom_update_meeting","zoominfo_enrich_companies","zoominfo_enrich_contacts","zoominfo_search_companies","zoominfo_search_contacts","zoominfo_search_intent","zoominfo_search_news"]' ) export default toolIds diff --git a/apps/sim/tools/generated/tool-metadata.ts b/apps/sim/tools/generated/tool-metadata.ts index a5c4970d060..22a1bc76aa9 100644 --- a/apps/sim/tools/generated/tool-metadata.ts +++ b/apps/sim/tools/generated/tool-metadata.ts @@ -3,7 +3,7 @@ /** Serializable metadata for every built-in tool, keyed by tool id. */ const toolMetadata: Record = JSON.parse( - '{"a2a_cancel_task":{"id":"a2a_cancel_task","name":"A2A Cancel Task","description":"Request cancellation of an in-progress A2A task.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The task ID to cancel"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_get_agent_card":{"id":"a2a_get_agent_card","name":"A2A Get Agent Card","description":"Fetch the Agent Card (discovery document) for an external A2A agent.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_get_task":{"id":"a2a_get_task","name":"A2A Get Task","description":"Retrieve the current state and result of an A2A task.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The task ID to retrieve"},"historyLength":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of history messages to include"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_send_message":{"id":"a2a_send_message","name":"A2A Send Message","description":"Send a message to an external A2A agent and return its response.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"message":{"type":"string","required":true,"visibility":"user-or-llm","description":"The message text to send"},"data":{"type":"json","required":false,"visibility":"user-or-llm","description":"Optional structured JSON data to attach"},"files":{"type":"json","required":false,"visibility":"user-or-llm","description":"Optional files to attach"},"taskId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Existing task ID to continue"},"contextId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Conversation context ID to continue"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"agentmail_create_draft":{"id":"agentmail_create_draft","name":"Create Draft","description":"Create a new email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to create the draft in"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Draft subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text draft body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML draft body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"},"inReplyTo":{"type":"string","required":false,"visibility":"user-or-llm","description":"ID of message being replied to"},"sendAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to schedule sending"}}},"agentmail_create_inbox":{"id":"agentmail_create_inbox","name":"Create Inbox","description":"Create a new email inbox with AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"username":{"type":"string","required":false,"visibility":"user-or-llm","description":"Username for the inbox email address"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Domain for the inbox email address"},"displayName":{"type":"string","required":false,"visibility":"user-or-llm","description":"Display name for the inbox"}}},"agentmail_delete_draft":{"id":"agentmail_delete_draft","name":"Delete Draft","description":"Delete an email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to delete"}}},"agentmail_delete_inbox":{"id":"agentmail_delete_inbox","name":"Delete Inbox","description":"Delete an email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to delete"}}},"agentmail_delete_thread":{"id":"agentmail_delete_thread","name":"Delete Thread","description":"Delete an email thread in AgentMail (moves to trash, or permanently deletes if already in trash)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to delete"},"permanent":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Force permanent deletion instead of moving to trash"}}},"agentmail_forward_message":{"id":"agentmail_forward_message","name":"Forward Message","description":"Forward an email message to new recipients in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to forward"},"to":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Override subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Additional plain text to prepend"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"Additional HTML to prepend"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"}}},"agentmail_get_draft":{"id":"agentmail_get_draft","name":"Get Draft","description":"Get details of a specific email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox the draft belongs to"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to retrieve"}}},"agentmail_get_inbox":{"id":"agentmail_get_inbox","name":"Get Inbox","description":"Get details of a specific email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to retrieve"}}},"agentmail_get_message":{"id":"agentmail_get_message","name":"Get Message","description":"Get details of a specific email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to retrieve"}}},"agentmail_get_thread":{"id":"agentmail_get_thread","name":"Get Thread","description":"Get details of a specific email thread including messages in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to retrieve"}}},"agentmail_list_drafts":{"id":"agentmail_list_drafts","name":"List Drafts","description":"List email drafts in an inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list drafts from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of drafts to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_inboxes":{"id":"agentmail_list_inboxes","name":"List Inboxes","description":"List all email inboxes in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of inboxes to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_messages":{"id":"agentmail_list_messages","name":"List Messages","description":"List messages in an inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list messages from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of messages to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_threads":{"id":"agentmail_list_threads","name":"List Threads","description":"List email threads in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list threads from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of threads to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"},"labels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to filter threads by"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter threads before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter threads after this ISO 8601 timestamp"}}},"agentmail_reply_message":{"id":"agentmail_reply_message","name":"Reply to Message","description":"Reply to an existing email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to reply from"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to reply to"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text reply body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML reply body"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Override recipient email addresses (comma-separated)"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC email addresses (comma-separated)"},"replyAll":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Reply to all recipients of the original message"}}},"agentmail_send_draft":{"id":"agentmail_send_draft","name":"Send Draft","description":"Send an existing email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to send"}}},"agentmail_send_message":{"id":"agentmail_send_message","name":"Send Message","description":"Send an email message from an AgentMail inbox","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to send from"},"to":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient email address (comma-separated for multiple)"},"subject":{"type":"string","required":true,"visibility":"user-or-llm","description":"Email subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text email body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML email body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"}}},"agentmail_update_draft":{"id":"agentmail_update_draft","name":"Update Draft","description":"Update an existing email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to update"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Draft subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text draft body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML draft body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"},"sendAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to schedule sending"}}},"agentmail_update_inbox":{"id":"agentmail_update_inbox","name":"Update Inbox","description":"Update the display name of an email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to update"},"displayName":{"type":"string","required":true,"visibility":"user-or-llm","description":"New display name for the inbox"}}},"agentmail_update_message":{"id":"agentmail_update_message","name":"Update Message","description":"Add or remove labels on an email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to update"},"addLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to add to the message"},"removeLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to remove from the message"}}},"agentmail_update_thread":{"id":"agentmail_update_thread","name":"Update Thread Labels","description":"Add or remove labels on an email thread in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to update"},"addLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to add to the thread"},"removeLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to remove from the thread"}}},"agentphone_create_call":{"id":"agentphone_create_call","name":"Create Outbound Call","description":"Initiate an outbound voice call from an AgentPhone agent","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"agentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Agent that will handle the call"},"toNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Phone number to call in E.164 format (e.g. +14155551234)"},"fromNumberId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Phone number ID to use as caller ID. Must belong to the agent. If omitted, the agent\'s first assigned number is used."},"initialGreeting":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optional greeting spoken when the recipient answers"},"voice":{"type":"string","required":false,"visibility":"user-or-llm","description":"Voice ID override for this call (defaults to the agent\'s configured voice)"},"systemPrompt":{"type":"string","required":false,"visibility":"user-or-llm","description":"When provided, uses a built-in LLM for the conversation instead of forwarding to your webhook"}}},"agentphone_create_contact":{"id":"agentphone_create_contact","name":"Create Contact","description":"Create a new contact in AgentPhone","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"phoneNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Phone number in E.164 format (e.g. +14155551234)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact\'s full name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Contact\'s email address"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Freeform notes stored on the contact"}}},"agentphone_create_number":{"id":"agentphone_create_number","name":"Create Phone Number","description":"Provision a new SMS- and voice-enabled phone number","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Two-letter country code (e.g. US, CA). Defaults to US."},"areaCode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Preferred area code (US/CA only, e.g. \\"415\\"). Best-effort — may be ignored if unavailable."},"agentId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optionally attach the number to an agent immediately"}}},"agentphone_delete_contact":{"id":"agentphone_delete_contact","name":"Delete Contact","description":"Delete a contact by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"}}},"agentphone_get_call":{"id":"agentphone_get_call","name":"Get Call","description":"Fetch a call and its full transcript","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"callId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the call to retrieve"}}},"agentphone_get_call_transcript":{"id":"agentphone_get_call_transcript","name":"Get Call Transcript","description":"Get the full ordered transcript for a call","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"callId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the call to retrieve the transcript for"}}},"agentphone_get_contact":{"id":"agentphone_get_contact","name":"Get Contact","description":"Fetch a single contact by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"}}},"agentphone_get_conversation":{"id":"agentphone_get_conversation","name":"Get Conversation","description":"Get a conversation along with its recent messages","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"messageLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of recent messages to include (default 50, max 100)"}}},"agentphone_get_conversation_messages":{"id":"agentphone_get_conversation_messages","name":"Get Conversation Messages","description":"Get paginated messages for a conversation","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of messages to return (default 50, max 200)"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received after this ISO 8601 timestamp"}}},"agentphone_get_number_messages":{"id":"agentphone_get_number_messages","name":"Get Phone Number Messages","description":"Fetch messages received on a specific phone number","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"numberId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the phone number"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of messages to return (default 50, max 200)"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received after this ISO 8601 timestamp"}}},"agentphone_get_usage":{"id":"agentphone_get_usage","name":"Get Usage","description":"Retrieve current usage statistics for the AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"}}},"agentphone_get_usage_daily":{"id":"agentphone_get_usage_daily","name":"Get Daily Usage","description":"Get a daily breakdown of usage (messages, calls, webhooks) for the last N days","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"days":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of days to return (1-365, default 30)"}}},"agentphone_get_usage_monthly":{"id":"agentphone_get_usage_monthly","name":"Get Monthly Usage","description":"Get monthly usage aggregation (messages, calls, webhooks) for the last N months","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"months":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of months to return (1-24, default 6)"}}},"agentphone_list_calls":{"id":"agentphone_list_calls","name":"List Calls","description":"List voice calls for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"},"status":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by status (completed, in-progress, failed)"},"direction":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by direction (inbound, outbound)"},"type":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by call type (pstn, web)"},"search":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search by phone number (matches fromNumber or toNumber)"}}},"agentphone_list_contacts":{"id":"agentphone_list_contacts","name":"List Contacts","description":"List contacts for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"search":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by name or phone number (case-insensitive contains)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 50, max 200)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_list_conversations":{"id":"agentphone_list_conversations","name":"List Conversations","description":"List conversations (message threads) for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_list_numbers":{"id":"agentphone_list_numbers","name":"List Phone Numbers","description":"List all phone numbers provisioned for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_react_to_message":{"id":"agentphone_react_to_message","name":"React to Message","description":"Send an iMessage tapback reaction to a message (iMessage only)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to react to"},"reaction":{"type":"string","required":true,"visibility":"user-or-llm","description":"Reaction type: love, like, dislike, laugh, emphasize, or question"}}},"agentphone_release_number":{"id":"agentphone_release_number","name":"Release Phone Number","description":"Release (delete) a phone number. This action is irreversible.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"numberId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the phone number to release"}}},"agentphone_send_message":{"id":"agentphone_send_message","name":"Send Message","description":"Send an outbound SMS or iMessage from an AgentPhone agent","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"agentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Agent sending the message"},"toNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient phone number in E.164 format (e.g. +14155551234)"},"body":{"type":"string","required":true,"visibility":"user-or-llm","description":"Message text to send"},"mediaUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optional URL of an image, video, or file to attach"},"numberId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Phone number ID to send from. If omitted, the agent\'s first assigned number is used."}}},"agentphone_update_contact":{"id":"agentphone_update_contact","name":"Update Contact","description":"Update a contact\'s fields","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"},"phoneNumber":{"type":"string","required":false,"visibility":"user-or-llm","description":"New phone number in E.164 format"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New contact name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"New email address"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"New freeform notes"}}},"agentphone_update_conversation":{"id":"agentphone_update_conversation","name":"Update Conversation","description":"Update conversation metadata (stored state). Pass null to clear existing metadata.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"metadata":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom key-value metadata to store on the conversation. Pass null to clear existing metadata."}}},"agiloft_attach_file":{"id":"agiloft_attach_file","name":"Agiloft Attach File","description":"Attach a file to a field in an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to attach the file to"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"file":{"type":"file","required":false,"visibility":"user-or-llm","description":"File to attach"},"fileName":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name to assign to the file (defaults to original file name)"}}},"agiloft_attachment_info":{"id":"agiloft_attachment_info","name":"Agiloft Attachment Info","description":"Get information about file attachments on a record field.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to check attachments on"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field to inspect"}}},"agiloft_create_record":{"id":"agiloft_create_record","name":"Agiloft Create Record","description":"Create a new record in an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"data":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record field values as a JSON object (e.g., {\\"first_name\\": \\"John\\", \\"status\\": \\"Active\\"})"}}},"agiloft_delete_record":{"id":"agiloft_delete_record","name":"Agiloft Delete Record","description":"Delete a record from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to delete"}}},"agiloft_get_choice_line_id":{"id":"agiloft_get_choice_line_id","name":"Agiloft Get Choice Line ID","description":"Resolve the internal numeric ID of a choice-list value, for use in EWSelect WHERE clauses against choice fields.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"case\\", \\"contracts\\")"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Choice field name (e.g., \\"priority\\", \\"status\\")"},"value":{"type":"string","required":true,"visibility":"user-or-llm","description":"Choice display value to resolve (e.g., \\"High\\", \\"Active\\")"}}},"agiloft_lock_record":{"id":"agiloft_lock_record","name":"Agiloft Lock Record","description":"Lock, unlock, or check the lock status of an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to lock, unlock, or check"},"lockAction":{"type":"string","required":true,"visibility":"user-or-llm","description":"Action to perform: \\"lock\\", \\"unlock\\", or \\"check\\""}}},"agiloft_read_record":{"id":"agiloft_read_record","name":"Agiloft Read Record","description":"Read a record by ID from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to read"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of field names to include in the response"}}},"agiloft_remove_attachment":{"id":"agiloft_remove_attachment","name":"Agiloft Remove Attachment","description":"Remove an attached file from a field in an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record containing the attachment"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"position":{"type":"string","required":true,"visibility":"user-or-llm","description":"Position index of the file to remove (starting from 0)"}}},"agiloft_retrieve_attachment":{"id":"agiloft_retrieve_attachment","name":"Agiloft Retrieve Attachment","description":"Download an attached file from an Agiloft record field.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record containing the attachment"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"position":{"type":"string","required":true,"visibility":"user-or-llm","description":"Position index of the file in the field (starting from 0)"}}},"agiloft_saved_search":{"id":"agiloft_saved_search","name":"Agiloft Saved Search","description":"List saved searches defined for an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name to list saved searches for (e.g., \\"contracts\\")"}}},"agiloft_search_records":{"id":"agiloft_search_records","name":"Agiloft Search Records","description":"Search for records in an Agiloft table using a query.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name to search in (e.g., \\"contracts\\", \\"contacts.employees\\")"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"Search query using Agiloft query syntax (e.g., \\"status=\'Active\'\\" or \\"company_name~=\'Acme\'\\")"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of field names to include in the results"},"page":{"type":"string","required":false,"visibility":"user-or-llm","description":"Page number for paginated results (starting from 0)"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of records to return per page"}}},"agiloft_select_records":{"id":"agiloft_select_records","name":"Agiloft Select Records","description":"Select record IDs matching a SQL WHERE clause from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"where":{"type":"string","required":true,"visibility":"user-or-llm","description":"SQL WHERE clause using database column names (e.g., \\"summary like \'%new%\'\\" or \\"assigned_person=\'John Doe\'\\")"}}},"agiloft_update_record":{"id":"agiloft_update_record","name":"Agiloft Update Record","description":"Update an existing record in an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to update"},"data":{"type":"string","required":true,"visibility":"user-or-llm","description":"Updated field values as a JSON object (e.g., {\\"status\\": \\"Active\\", \\"priority\\": \\"High\\"})"}}},"ahrefs_anchors":{"id":"ahrefs_anchors","name":"Ahrefs Anchors","description":"Get the anchor text distribution for a target domain or URL\'s backlinks, showing how many links and referring domains use each anchor text.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live), \\"all_time\\" (default, includes lost backlinks), or \\"since:YYYY-MM-DD\\" (backlinks found since a date)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_backlinks":{"id":"ahrefs_backlinks","name":"Ahrefs Backlinks","description":"Get a list of backlinks pointing to a target domain or URL. Returns details about each backlink including source URL, anchor text, and domain rating.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live backlinks), \\"all_time\\" (default, includes lost backlinks), or \\"since:YYYY-MM-DD\\" (backlinks found since a date)."},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_backlinks_stats":{"id":"ahrefs_backlinks_stats","name":"Ahrefs Backlinks Stats","description":"Get backlink and referring domain totals for a target domain or URL, both currently live and across all time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_batch_analysis":{"id":"ahrefs_batch_analysis","name":"Ahrefs Batch Analysis","description":"Get bulk SEO metrics (Domain Rating, backlinks, referring domains, organic traffic, and more) for multiple domains or URLs in a single request. Useful for comparing many competitors at once.","version":"1.0.0","params":{"targets":{"type":"string","required":true,"visibility":"user-or-llm","description":"Comma-separated list of domains or URLs to analyze. Example: \\"example.com,competitor.com\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode applied to every target: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"protocol":{"type":"string","required":false,"visibility":"user-or-llm","description":"Protocol applied to every target: \\"both\\" (default), \\"http\\", or \\"https\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_broken_backlinks":{"id":"ahrefs_broken_backlinks","name":"Ahrefs Broken Backlinks","description":"Get a list of broken backlinks pointing to a target domain or URL. Useful for identifying link reclamation opportunities.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_domain_rating":{"id":"ahrefs_domain_rating","name":"Ahrefs Domain Rating","description":"Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website\'s backlink profile on a scale from 0 to 100.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain to analyze (e.g., example.com)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date for historical data in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_domain_rating_history":{"id":"ahrefs_domain_rating_history","name":"Ahrefs Domain Rating History","description":"Get the historical Domain Rating (DR) trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_keyword_overview":{"id":"ahrefs_keyword_overview","name":"Ahrefs Keyword Overview","description":"Get detailed metrics for a keyword including search volume, keyword difficulty, CPC, clicks, and traffic potential.","version":"1.0.0","params":{"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The keyword to analyze"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for keyword data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_keywords_history":{"id":"ahrefs_keywords_history","name":"Ahrefs Keywords History","description":"Get the historical organic keyword ranking distribution for a target domain or URL over a date range: how many keywords rank in each position bucket at each point in time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_metrics":{"id":"ahrefs_metrics","name":"Ahrefs Metrics","description":"Get a one-call organic and paid search overview for a target domain or URL: organic traffic, organic keywords, paid traffic, paid keywords, and estimated traffic cost.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_metrics_history":{"id":"ahrefs_metrics_history","name":"Ahrefs Metrics History","description":"Get the historical organic and paid traffic trend for a target domain or URL over a date range: organic traffic/cost and paid traffic/cost at each point in time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_organic_competitors":{"id":"ahrefs_organic_competitors","name":"Ahrefs Organic Competitors","description":"Get domains that compete with a target domain or URL for the same organic keywords, ranked by keyword overlap.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_organic_keywords":{"id":"ahrefs_organic_keywords","name":"Ahrefs Organic Keywords","description":"Get organic keywords that a target domain or URL ranks for in Google search results. Returns keyword details including search volume, ranking position, and estimated traffic.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_paid_pages":{"id":"ahrefs_paid_pages","name":"Ahrefs Paid Pages","description":"Get a target domain\'s pages that receive paid search traffic, sorted by estimated paid traffic. Returns page URLs with their paid traffic, keyword counts, and estimated spend.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_competitors_overview":{"id":"ahrefs_rank_tracker_competitors_overview","name":"Ahrefs Rank Tracker Competitors Overview","description":"Get competitor rankings for the keywords tracked in an Ahrefs Rank Tracker project: each tracked keyword\'s volume and difficulty alongside every competitor\'s position, traffic, and traffic value. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report rankings for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"dateCompared":{"type":"string","required":false,"visibility":"user-only","description":"Comparison date in YYYY-MM-DD format, to compute position/traffic deltas"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_competitors_stats":{"id":"ahrefs_rank_tracker_competitors_stats","name":"Ahrefs Rank Tracker Competitors Stats","description":"Get aggregate competitor stats for an Ahrefs Rank Tracker project: each competitor\'s traffic, traffic value, average position, and share of voice across all tracked keywords. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report metrics for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_overview":{"id":"ahrefs_rank_tracker_overview","name":"Ahrefs Rank Tracker Overview","description":"Get ranking overview metrics for the keywords tracked in an Ahrefs Rank Tracker project: position, search volume, keyword difficulty, and estimated traffic. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report rankings for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"dateCompared":{"type":"string","required":false,"visibility":"user-only","description":"Comparison date in YYYY-MM-DD format, to compute position/traffic deltas"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_serp_overview":{"id":"ahrefs_rank_tracker_serp_overview","name":"Ahrefs Rank Tracker SERP Overview","description":"Get the full SERP (search engine results page) for a keyword tracked in an Ahrefs Rank Tracker project, including every ranking URL with its position, title, and authority metrics. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The tracked keyword to retrieve SERP data for"},"country":{"type":"string","required":true,"visibility":"user-or-llm","description":"Country code for the tracked keyword. Example: \\"us\\", \\"gb\\", \\"de\\""},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"topPositions":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of top organic positions to return (defaults to all available)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Timestamp to return the last available SERP Overview at, in YYYY-MM-DDThh:mm:ss format"},"locationId":{"type":"number","required":false,"visibility":"user-or-llm","description":"Location ID of the tracked keyword, if tracked at a specific location"},"languageCode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Language code of the tracked keyword"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_refdomains_history":{"id":"ahrefs_refdomains_history","name":"Ahrefs Referring Domains History","description":"Get the historical referring domains trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_referring_domains":{"id":"ahrefs_referring_domains","name":"Ahrefs Referring Domains","description":"Get a list of domains that link to a target domain or URL. Returns unique referring domains with their domain rating, backlink counts, and discovery dates.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live), \\"all_time\\" (default, includes lost domains), or \\"since:YYYY-MM-DD\\" (domains found since a date)."},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_related_terms":{"id":"ahrefs_related_terms","name":"Ahrefs Related Terms","description":"Get keyword ideas related to a seed keyword: terms the same top-ranking pages also rank for (\\"also rank for\\") or also discuss (\\"also talk about\\"), with volume, difficulty, and CPC.","version":"1.0.0","params":{"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The seed keyword to find related terms for"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for keyword data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"terms":{"type":"string","required":false,"visibility":"user-or-llm","description":"Type of related keywords to return: \\"also_rank_for\\", \\"also_talk_about\\", or \\"all\\" (default: \\"all\\")"},"viewFor":{"type":"string","required":false,"visibility":"user-or-llm","description":"Whether to derive related terms from the top 10 or top 100 ranking pages (default: \\"top_10\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_site_audit_page_explorer":{"id":"ahrefs_site_audit_page_explorer","name":"Ahrefs Site Audit Page Explorer","description":"Get crawled pages from an Ahrefs Site Audit project with health and SEO metrics: HTTP status, title, link counts, backlinks, indexability, and traffic. Optionally filter to pages affected by a specific issue.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Site Audit project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Crawl date in YYYY-MM-DDThh:mm:ss format (defaults to the most recent crawl)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip, for pagination"},"issueId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Only return pages affected by this issue ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_top_pages":{"id":"ahrefs_top_pages","name":"Ahrefs Top Pages","description":"Get the top pages of a target domain sorted by organic traffic. Returns page URLs with their traffic, keyword counts, and estimated traffic value.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"airtable_create_records":{"id":"airtable_create_records","name":"Airtable Create Records","description":"Write new records to an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to create, each with a `fields` object"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_delete_records":{"id":"airtable_delete_records","name":"Airtable Delete Records","description":"Delete one or more records from an Airtable table by ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordIds":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of record IDs to delete (each starts with \\"rec\\", e.g., [\\"recXXXXXXXXXXXXXX\\"]). Pass a single-element array to delete one record."}},"oauth":{"required":true,"provider":"airtable"}},"airtable_get_base_schema":{"id":"airtable_get_base_schema","name":"Airtable Get Base Schema","description":"Get the schema of all tables, fields, and views in an Airtable base","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_get_record":{"id":"airtable_get_record","name":"Airtable Get Record","description":"Retrieve a single record from an Airtable table by its ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record ID to retrieve (starts with \\"rec\\", e.g., \\"recXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_bases":{"id":"airtable_list_bases","name":"Airtable List Bases","description":"List all bases the authenticated user has access to","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"offset":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination offset for retrieving additional bases"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_records":{"id":"airtable_list_records","name":"Airtable List Records","description":"Read records from an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"maxRecords":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of records to return (default: all records)"},"filterFormula":{"type":"string","required":false,"visibility":"user-or-llm","description":"Formula to filter records (e.g., \\"({Field Name} = \'Value\')\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_tables":{"id":"airtable_list_tables","name":"Airtable List Tables","description":"List all tables and their schema in an Airtable base","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_update_multiple_records":{"id":"airtable_update_multiple_records","name":"Airtable Update Multiple Records","description":"Update multiple existing records in an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to update, each with an `id` and a `fields` object"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_update_record":{"id":"airtable_update_record","name":"Airtable Update Record","description":"Update an existing record in an Airtable table by ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record ID to update (starts with \\"rec\\", e.g., \\"recXXXXXXXXXXXXXX\\")"},"fields":{"type":"json","required":true,"visibility":"user-or-llm","description":"An object containing the field names and their new values"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_upsert_records":{"id":"airtable_upsert_records","name":"Airtable Upsert Records","description":"Update existing records or create new ones in an Airtable table, matching on the specified merge fields","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to upsert, each with a `fields` object"},"fieldsToMergeOn":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of field names used to match existing records (max 3). A record is updated when all merge fields match, otherwise it is created. Example: [\\"Name\\"]"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airweave_search":{"id":"airweave_search","name":"Airweave Search","description":"Search your synced data collections using Airweave. Supports semantic search with hybrid, neural, or keyword retrieval strategies. Optionally generate AI-powered answers from search results.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Airweave API Key for authentication"},"collectionId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The readable ID of the collection to search"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"The search query text"},"limit":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 100)"},"retrievalStrategy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Retrieval strategy: hybrid (default), neural, or keyword"},"expandQuery":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Generate query variations to improve recall"},"rerank":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Reorder results for improved relevance using LLM"},"generateAnswer":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Generate a natural-language answer to the query"}}},"algolia_add_record":{"id":"algolia_add_record","name":"Algolia Add Record","description":"Add or replace a record in an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":false,"visibility":"user-or-llm","description":"Object ID for the record (auto-generated if not provided)"},"record":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object representing the record to add"}}},"algolia_batch_operations":{"id":"algolia_batch_operations","name":"Algolia Batch Operations","description":"Perform batch add, update, partial update, or delete operations on records in an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"requests":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of batch operations. Each item has \\"action\\" (addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject, delete, clear) and \\"body\\" (the record data; must include objectID for update/delete; use an empty object {} for the index-level delete/clear actions)"}}},"algolia_browse_records":{"id":"algolia_browse_records","name":"Algolia Browse Records","description":"Browse and iterate over all records in an Algolia index using cursor pagination","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key (must have browse ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to browse"},"query":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search query to filter browsed records"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter string to narrow down results"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of hits per page (default: 1000, max: 1000)"},"cursor":{"type":"string","required":false,"visibility":"user-or-llm","description":"Cursor from a previous browse response for pagination"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search"}}},"algolia_clear_records":{"id":"algolia_clear_records","name":"Algolia Clear Records","description":"Clear all records from an Algolia index while keeping settings, synonyms, and rules","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to clear"}}},"algolia_copy_move_index":{"id":"algolia_copy_move_index","name":"Algolia Copy/Move Index","description":"Copy or move an Algolia index to a new destination","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the source index"},"operation":{"type":"string","required":true,"visibility":"user-or-llm","description":"Operation to perform: \\"copy\\" or \\"move\\""},"destination":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the destination index"},"scope":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of scopes to copy (only for \\"copy\\" operation): [\\"settings\\", \\"synonyms\\", \\"rules\\"]. Omit to copy everything including records."}}},"algolia_delete_by_filter":{"id":"algolia_delete_by_filter","name":"Algolia Delete By Filter","description":"Delete all records matching a filter from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter expression to match records for deletion (e.g., \\"category:outdated\\")"},"facetFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of facet filters (e.g., [\\"brand:Acme\\"])"},"numericFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of numeric filters (e.g., [\\"price > 100\\"])"},"tagFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of tag filters using the _tags attribute (e.g., [\\"published\\"])"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search filter (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search filter"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search filter"}}},"algolia_delete_index":{"id":"algolia_delete_index","name":"Algolia Delete Index","description":"Delete an entire Algolia index and all its records","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to delete"}}},"algolia_delete_record":{"id":"algolia_delete_record","name":"Algolia Delete Record","description":"Delete a record by objectID from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to delete"}}},"algolia_get_record":{"id":"algolia_get_record","name":"Algolia Get Record","description":"Get a record by objectID from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to retrieve"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"}}},"algolia_get_records":{"id":"algolia_get_records","name":"Algolia Get Records","description":"Retrieve multiple records by objectID from one or more Algolia indices","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Default index name for all requests"},"requests":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of objects specifying records to retrieve. Each must have \\"objectID\\" and optionally \\"indexName\\" and \\"attributesToRetrieve\\"."}}},"algolia_get_settings":{"id":"algolia_get_settings","name":"Algolia Get Settings","description":"Retrieve the settings of an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"}}},"algolia_get_task_status":{"id":"algolia_get_task_status","name":"Algolia Get Task Status","description":"Check whether an Algolia indexing task has finished publishing","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index the task ran against"},"taskID":{"type":"number","required":true,"visibility":"user-or-llm","description":"The taskID returned by a previous write operation"}}},"algolia_list_indices":{"id":"algolia_list_indices","name":"Algolia List Indices","description":"List all indices in an Algolia application","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for paginating indices (default: not paginated)"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of indices per page (default: 100)"}}},"algolia_partial_update_record":{"id":"algolia_partial_update_record","name":"Algolia Partial Update Record","description":"Partially update a record in an Algolia index without replacing it entirely","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to update"},"attributes":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object with attributes to update. Supports built-in operations like {\\"stock\\": {\\"_operation\\": \\"Decrement\\", \\"value\\": 1}}"},"createIfNotExists":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to create the record if it does not exist (default: true)"}}},"algolia_search":{"id":"algolia_search","name":"Algolia Search","description":"Search an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to search"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"Search query text"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of hits per page (default: 20)"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number to retrieve (default: 0)"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter string (e.g., \\"category:electronics AND price < 100\\")"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"},"facets":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of facet attribute names to retrieve counts for (use \\"*\\" for all)"},"getRankingInfo":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to include detailed ranking information in each hit"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search"}}},"algolia_update_settings":{"id":"algolia_update_settings","name":"Algolia Update Settings","description":"Update the settings of an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have editSettings ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"settings":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object with settings to update (e.g., {\\"searchableAttributes\\": [\\"name\\", \\"description\\"], \\"customRanking\\": [\\"desc(popularity)\\"]})"},"forwardToReplicas":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to apply changes to replica indices (default: false)"}}},"amplitude_event_segmentation":{"id":"amplitude_event_segmentation","name":"Amplitude Event Segmentation","description":"Query event analytics data with segmentation. Get event counts, uniques, averages, and more.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"eventType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Event type name to analyze"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric type: uniques, totals, pct_dau, average, histogram, sums, value_avg, or formula (default: uniques)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by (prefix custom user properties with \\"gp:\\")"},"groupBy2":{"type":"string","required":false,"visibility":"user-or-llm","description":"Second property name to group by (prefix custom user properties with \\"gp:\\")"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of group-by values (max 1000)"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON array of filter objects applied to the event, e.g. [{\\"subprop_type\\":\\"event\\",\\"subprop_key\\":\\"city\\",\\"subprop_op\\":\\"is\\",\\"subprop_value\\":[\\"San Francisco\\"]}]"},"formula":{"type":"string","required":false,"visibility":"user-or-llm","description":"Required when metric is \\"formula\\", e.g. \\"UNIQUES(A)/UNIQUES(B)\\""},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_funnels":{"id":"amplitude_funnels","name":"Amplitude Funnels","description":"Analyze conversion rates and drop-off between a sequence of events.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"events":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON array of event objects, one per funnel step in order, e.g. [{\\"event_type\\":\\"signup\\"},{\\"event_type\\":\\"purchase\\"}]"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Funnel ordering: \\"ordered\\", \\"unordered\\", or \\"sequential\\" (default: ordered)"},"userType":{"type":"string","required":false,"visibility":"user-or-llm","description":"User type: \\"new\\" or \\"active\\" (default: active)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: -300000 (real-time), -3600000 (hourly), 1 (daily), 7 (weekly), or 30 (monthly)"},"conversionWindowSeconds":{"type":"string","required":false,"visibility":"user-or-llm","description":"Conversion window in seconds (default: 2592000, i.e. 30 days)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property to group by (limit: one; prefix custom properties with \\"gp:\\")"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of group-by values (default: 100, max: 1000)"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_get_active_users":{"id":"amplitude_get_active_users","name":"Amplitude Get Active Users","description":"Get active or new user counts over a date range from the Dashboard REST API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric type: \\"active\\" or \\"new\\" (default: active)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_get_revenue":{"id":"amplitude_get_revenue","name":"Amplitude Get Revenue","description":"Get revenue LTV data including ARPU, ARPPU, total revenue, and paying user counts.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric: 0 (ARPU), 1 (ARPPU), 2 (Total Revenue), 3 (Paying Users)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by (limit: one)"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_group_identify":{"id":"amplitude_group_identify","name":"Amplitude Group Identify","description":"Set group-level properties in Amplitude. Supports $set, $setOnce, $add, $append, $unset operations.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"groupType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Group classification (e.g., \\"company\\", \\"org_id\\")"},"groupValue":{"type":"string","required":true,"visibility":"user-or-llm","description":"Specific group identifier (e.g., \\"Acme Corp\\")"},"groupProperties":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON object of group properties. Use operations like $set, $setOnce, $add, $append, $unset."},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_identify_user":{"id":"amplitude_identify_user","name":"Amplitude Identify User","description":"Set user properties in Amplitude using the Identify API. Supports $set, $setOnce, $add, $append, $unset operations.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"User ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"userProperties":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON object of user properties. Use operations like $set, $setOnce, $add, $append, $unset."},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_list_events":{"id":"amplitude_list_events","name":"Amplitude List Events","description":"List all event types in the Amplitude project with their weekly totals and unique counts.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_realtime_active_users":{"id":"amplitude_realtime_active_users","name":"Amplitude Real-time Active Users","description":"Get real-time active user counts at 5-minute granularity for the last 2 days.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_retention":{"id":"amplitude_retention","name":"Amplitude Retention","description":"Measure how many users return to perform an action after a starting action.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"startEvent":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON starting event object, e.g. {\\"event_type\\":\\"_new\\"} or {\\"event_type\\":\\"_active\\"}"},"returnEvent":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON returning event object, e.g. {\\"event_type\\":\\"_all\\"} or {\\"event_type\\":\\"_active\\"}"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"retentionMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Retention type: \\"bracket\\", \\"rolling\\", or \\"n-day\\" (default: n-day)"},"retentionBrackets":{"type":"string","required":false,"visibility":"user-or-llm","description":"Required when Retention Mode is \\"bracket\\". Day ranges, e.g. [[0,4]]"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property to group by (limit: one; prefix custom properties with \\"gp:\\")"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_send_event":{"id":"amplitude_send_event","name":"Amplitude Send Event","description":"Track an event in Amplitude using the HTTP V2 API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"User ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"eventType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the event (e.g., \\"page_view\\", \\"purchase\\")"},"eventProperties":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON object of custom event properties"},"userProperties":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON object of user properties to set (supports $set, $setOnce, $add, $append, $unset)"},"time":{"type":"string","required":false,"visibility":"user-or-llm","description":"Event timestamp in milliseconds since epoch"},"sessionId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Session start time in milliseconds since epoch"},"insertId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Unique ID for deduplication (within 7-day window)"},"appVersion":{"type":"string","required":false,"visibility":"user-or-llm","description":"Application version string"},"platform":{"type":"string","required":false,"visibility":"user-or-llm","description":"Platform (e.g., \\"Web\\", \\"iOS\\", \\"Android\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Two-letter country code"},"language":{"type":"string","required":false,"visibility":"user-or-llm","description":"Language code (e.g., \\"en\\")"},"ip":{"type":"string","required":false,"visibility":"user-or-llm","description":"IP address for geo-location"},"price":{"type":"string","required":false,"visibility":"user-or-llm","description":"Price of the item purchased"},"quantity":{"type":"string","required":false,"visibility":"user-or-llm","description":"Quantity of items purchased"},"revenue":{"type":"string","required":false,"visibility":"user-or-llm","description":"Revenue amount"},"productId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Product identifier"},"revenueType":{"type":"string","required":false,"visibility":"user-or-llm","description":"Revenue type (e.g., \\"purchase\\", \\"refund\\")"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_user_activity":{"id":"amplitude_user_activity","name":"Amplitude User Activity","description":"Get the event stream for a specific user by their Amplitude ID.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"amplitudeId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Amplitude internal user ID"},"offset":{"type":"string","required":false,"visibility":"user-or-llm","description":"Offset for pagination (default 0)"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of events to return (default 1000, max 1000)"},"direction":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort direction: \\"latest\\" or \\"earliest\\" (default: latest)"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_user_profile":{"id":"amplitude_user_profile","name":"Amplitude User Profile","description":"Get a user profile including properties, cohort memberships, and computed properties. Not available for EU data-residency projects.","version":"1.0.0","params":{"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"External user ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"getAmpProps":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include Amplitude user properties (true/false, default: false)"},"getCohortIds":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include cohort IDs the user belongs to (true/false, default: false)"},"getComputations":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include computed user properties (true/false, default: false)"}}},"amplitude_user_search":{"id":"amplitude_user_search","name":"Amplitude User Search","description":"Search for a user by User ID, Device ID, or Amplitude ID using the Dashboard REST API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"user":{"type":"string","required":true,"visibility":"user-or-llm","description":"User ID, Device ID, or Amplitude ID to search for"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"apify_get_dataset_items":{"id":"apify_get_dataset_items","name":"APIFY Get Dataset Items","description":"Retrieve items stored in an APIFY dataset","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"datasetId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Dataset ID to read items from. Example: \\"9RnD3Pql2vGZkc5H5\\""},"itemLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Max items to return (1-250000). Default: all items. Example: 500"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of items to skip at the start. Default: 0"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of fields to include. Example: \\"title,url,price\\""}}},"apify_get_run":{"id":"apify_get_run","name":"APIFY Get Run","description":"Get the status and details of an APIFY actor run","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"runId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor run ID to fetch. Example: \\"HG7ML7M8z78YcAPEB\\""}}},"apify_run_actor_async":{"id":"apify_run_actor_async","name":"APIFY Run Actor (Async)","description":"Run an APIFY actor asynchronously with polling for long-running tasks","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"actorId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor ID or username/actor-name. Examples: \\"apify/web-scraper\\", \\"janedoe/my-actor\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor input as JSON string. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}], \\"maxPages\\": 10}"},"waitForFinish":{"type":"number","required":false,"visibility":"user-or-llm","description":"Initial wait time in seconds (0-60) before polling starts. Example: 30"},"itemLimit":{"type":"number","required":false,"default":100,"visibility":"user-or-llm","description":"Max dataset items to fetch (1-250000). Default: 100. Example: 500"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\", \\"build-tag-name\\""}}},"apify_run_actor_sync":{"id":"apify_run_actor_sync","name":"APIFY Run Actor (Sync)","description":"Run an APIFY actor synchronously and get results (max 5 minutes)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"actorId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor ID or username/actor-name. Examples: \\"apify/web-scraper\\", \\"janedoe/my-actor\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor input as JSON string. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}], \\"maxPages\\": 10}"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\", \\"build-tag-name\\""}}},"apify_run_task":{"id":"apify_run_task","name":"APIFY Run Task","description":"Run a saved APIFY actor task synchronously and get dataset items (max 5 minutes)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task ID or username/task-name. Examples: \\"janedoe/my-task\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON string that overrides the task\'s saved input. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}]}"},"itemLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Max dataset items to return (1-250000). Example: 500"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the run (128-32768). Example: 1024 for 1GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the run. Example: 300 for 5 minutes"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\""}}},"apollo_account_bulk_create":{"id":"apollo_account_bulk_create","name":"Apollo Bulk Create Accounts","description":"Create up to 100 accounts at once in your Apollo database. Set run_dedupe=true to deduplicate by domain, organization_id, and name. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"accounts":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of accounts to create (max 100). Each account should include a name, and may optionally include domain, phone, phone_status_cd, raw_address, owner_id, linkedin_url, facebook_url, twitter_url, salesforce_id, and hubspot_id."},"append_label_names":{"type":"array","required":false,"visibility":"user-only","description":"Array of label names to add to ALL accounts in this request"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, performs aggressive deduplication by domain, organization_id, and name (defaults to false)"}}},"apollo_account_bulk_update":{"id":"apollo_account_bulk_update","name":"Apollo Bulk Update Accounts","description":"Update up to 1000 existing accounts at once in your Apollo database (higher limit than contacts!). Each account must include an id field. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"account_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of account IDs to update with the same values (max 1000). Use with name/owner_id for uniform updates. Use either this OR account_attributes."},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this name to all accounts"},"owner_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this owner to all accounts"},"account_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this account stage to all accounts"},"account_attributes":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of account objects with individual updates (each must include id). Example: [{\\"id\\": \\"acc1\\", \\"name\\": \\"Acme\\", \\"owner_id\\": \\"u1\\", \\"account_stage_id\\": \\"s1\\", \\"typed_custom_fields\\": {\\"field_id\\": \\"value\\"}}]"},"async":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, processes the update asynchronously. Only supported when using account_ids; returns 422 if used with account_attributes."}}},"apollo_account_create":{"id":"apollo_account_create","name":"Apollo Create Account","description":"Create a new account (company) in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Company name (e.g., \\"Acme Corporation\\")"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain without www. prefix (e.g., \\"acme.com\\")"},"phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number for the account"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo user ID of the account owner"},"account_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo ID for the account stage to assign this account to"},"raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate location (e.g., \\"San Francisco, CA, USA\\")"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_account_search":{"id":"apollo_account_search","name":"Apollo Search Accounts","description":"Search your team\'s accounts in Apollo. Display limit: 50,000 records (100 records per page, 500 pages max). Use filters to narrow results. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"q_organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter accounts by organization name (partial-match search)"},"account_stage_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by account stage IDs"},"account_label_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by account label IDs"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"account_last_activity_date\\", \\"account_created_at\\", or \\"account_updated_at\\""},"sort_ascending":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Sort ascending when true. Defaults to descending."},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_account_update":{"id":"apollo_account_update","name":"Apollo Update Account","description":"Update an existing account in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"account_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the account to update (e.g., \\"acc_abc123\\")"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company name (e.g., \\"Acme Corporation\\")"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain (e.g., \\"acme.com\\")"},"phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company phone number"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo user ID of the account owner"},"account_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo ID for the account stage to assign this account to"},"raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate location (e.g., \\"San Francisco, CA, USA\\")"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_contact_bulk_create":{"id":"apollo_contact_bulk_create","name":"Apollo Bulk Create Contacts","description":"Create up to 100 contacts at once in your Apollo database. Supports deduplication to prevent creating duplicate contacts. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"contacts":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of contacts to create (max 100). Each contact may include first_name, last_name, email, title, organization_name, account_id, owner_id, contact_stage_id, linkedin_url, phone (single string) or phone_numbers (array of {raw_number, position}), contact_emails, typed_custom_fields, and CRM IDs (salesforce_contact_id, hubspot_id, team_id) for cross-system matching"},"append_label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Label names to add to all contacts in this request (e.g., [\\"Hot Lead\\"])"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-only","description":"Enable deduplication to prevent creating duplicate contacts. When true, existing contacts are returned without modification"}}},"apollo_contact_bulk_update":{"id":"apollo_contact_bulk_update","name":"Apollo Bulk Update Contacts","description":"Update up to 100 existing contacts at once in your Apollo database. Each contact must include an id field. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"contact_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of contact IDs to update. Must be paired with an object-form contact_attributes specifying the fields to apply uniformly to all listed contacts."},"contact_attributes":{"type":"json","required":false,"visibility":"user-or-llm","description":"Required. Either an array of per-contact updates (each with id) — used standalone — or a single object of attributes to apply to all contact_ids. Supported fields: owner_id, email, organization_name, title, first_name, last_name, account_id, present_raw_address, linkedin_url, typed_custom_fields"},"async":{"type":"boolean","required":false,"visibility":"user-only","description":"Force asynchronous processing. Automatically enabled for >100 contacts"}}},"apollo_contact_create":{"id":"apollo_contact_create","name":"Apollo Create Contact","description":"Create a new contact in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"first_name":{"type":"string","required":true,"visibility":"user-or-llm","description":"First name of the contact"},"last_name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Last name of the contact"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address of the contact"},"title":{"type":"string","required":false,"visibility":"user-or-llm","description":"Job title (e.g., \\"VP of Sales\\", \\"Software Engineer\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo account ID to associate with (e.g., \\"acc_abc123\\")"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the contact owner (accepted by Apollo but not officially documented for POST /contacts)"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the contact\'s employer (e.g., \\"Apollo\\")"},"website_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate website URL (e.g., \\"https://www.apollo.io/\\")"},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Lists/labels to add the contact to (e.g., [\\"Prospects\\"])"},"contact_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the contact stage"},"present_raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal location for the contact (e.g., \\"Atlanta, United States\\")"},"direct_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number"},"corporate_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Work/office phone number"},"mobile_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Mobile phone number"},"home_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Home phone number"},"other_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Alternative phone number"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom field values keyed by custom field ID"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, Apollo deduplicates against existing contacts"}}},"apollo_contact_search":{"id":"apollo_contact_search","name":"Apollo Search Contacts","description":"Search your team\'s contacts in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"q_keywords":{"type":"string","required":false,"visibility":"user-or-llm","description":"Keywords to search for"},"contact_stage_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by contact stage IDs"},"contact_label_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by Apollo label IDs (lists)"},"sort_by_field":{"type":"string","required":false,"visibility":"user-only","description":"Sort field: contact_last_activity_date, contact_email_last_opened_at, contact_email_last_clicked_at, contact_created_at, or contact_updated_at"},"sort_ascending":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, sort ascending. Must be used together with sort_by_field"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_contact_update":{"id":"apollo_contact_update","name":"Apollo Update Contact","description":"Update an existing contact in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"contact_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the contact to update (e.g., \\"con_abc123\\")"},"first_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"First name of the contact"},"last_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Last name of the contact"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address"},"title":{"type":"string","required":false,"visibility":"user-or-llm","description":"Job title (e.g., \\"VP of Sales\\", \\"Software Engineer\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo account ID (e.g., \\"acc_abc123\\")"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the contact owner (accepted by Apollo but not officially documented for PATCH /contacts/{id})"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the contact\'s employer (e.g., \\"Apollo\\")"},"website_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate website URL (e.g., \\"https://www.apollo.io/\\")"},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Lists/labels to add the contact to (e.g., [\\"Prospects\\"])"},"contact_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the contact stage"},"present_raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal location for the contact (e.g., \\"Atlanta, United States\\")"},"direct_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number"},"corporate_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Work/office phone number"},"mobile_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Mobile phone number"},"home_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Home phone number"},"other_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Alternative phone number"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom field values keyed by custom field ID"}}},"apollo_email_accounts":{"id":"apollo_email_accounts","name":"Apollo Get Email Accounts","description":"Get list of team\'s linked email accounts in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"}}},"apollo_opportunity_create":{"id":"apollo_opportunity_create","name":"Apollo Create Opportunity","description":"Create a new deal for an account in your Apollo database (master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the opportunity/deal (e.g., \\"Enterprise License - Q1\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"ID of the account this opportunity belongs to (e.g., \\"acc_abc123\\")"},"amount":{"type":"string","required":false,"visibility":"user-or-llm","description":"Monetary value as a plain number string with no commas or currency symbols"},"opportunity_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the opportunity stage"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the opportunity owner"},"closed_date":{"type":"string","required":false,"visibility":"user-or-llm","description":"Expected close date in YYYY-MM-DD format"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_opportunity_get":{"id":"apollo_opportunity_get","name":"Apollo Get Opportunity","description":"Retrieve complete details of a specific deal/opportunity by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"opportunity_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the opportunity to retrieve (e.g., \\"opp_abc123\\")"}}},"apollo_opportunity_search":{"id":"apollo_opportunity_search","name":"Apollo Search Opportunities","description":"Search and list all deals/opportunities in your team\'s Apollo account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"amount\\", \\"is_closed\\", or \\"is_won\\""},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_opportunity_update":{"id":"apollo_opportunity_update","name":"Apollo Update Opportunity","description":"Update an existing deal/opportunity in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"opportunity_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the opportunity to update (e.g., \\"opp_abc123\\")"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the opportunity/deal (e.g., \\"Enterprise License - Q1\\")"},"amount":{"type":"string","required":false,"visibility":"user-or-llm","description":"Monetary value as a plain number string with no commas or currency symbols"},"opportunity_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the opportunity stage"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the opportunity owner"},"closed_date":{"type":"string","required":false,"visibility":"user-or-llm","description":"Expected close date in YYYY-MM-DD format"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_organization_bulk_enrich":{"id":"apollo_organization_bulk_enrich","name":"Apollo Bulk Organization Enrichment","description":"Enrich data for up to 10 organizations at once using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"domains":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of company domains to enrich (max 10, no www. or @, e.g., [\\"apollo.io\\", \\"stripe.com\\"])"}}},"apollo_organization_enrich":{"id":"apollo_organization_enrich","name":"Apollo Organization Enrichment","description":"Enrich data for a single organization using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"domain":{"type":"string","required":true,"visibility":"user-or-llm","description":"Company domain (e.g., \\"apollo.io\\", \\"acme.com\\")"}}},"apollo_organization_search":{"id":"apollo_organization_search","name":"Apollo Organization Search","description":"Search Apollo\'s database for companies using filters","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"organization_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Company HQ locations (cities, US states, or countries)"},"organization_not_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Exclude companies whose HQ is in these locations"},"organization_num_employees_ranges":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employee count ranges as \\"min,max\\" strings (e.g., [\\"1,10\\", \\"250,500\\", \\"10000,20000\\"])"},"q_organization_keyword_tags":{"type":"array","required":false,"visibility":"user-or-llm","description":"Industry or keyword tags"},"q_organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Organization name to search for (e.g., \\"Acme\\", \\"TechCorp\\")"},"organization_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Apollo organization IDs to include (e.g., [\\"5e66b6381e05b4008c8331b8\\"])"},"q_organization_domains_list":{"type":"array","required":false,"visibility":"user-or-llm","description":"Domain names to filter by (no www. or @, up to 1,000)"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_people_bulk_enrich":{"id":"apollo_people_bulk_enrich","name":"Apollo Bulk People Enrichment","description":"Enrich data for up to 10 people at once using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"people":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of people to enrich (max 10)"},"reveal_personal_emails":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal personal email addresses (uses credits)"},"reveal_phone_number":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal phone numbers (uses credits, requires webhook_url)"},"webhook_url":{"type":"string","required":false,"visibility":"user-only","description":"Webhook URL for async phone number delivery (required when reveal_phone_number is true)"}}},"apollo_people_enrich":{"id":"apollo_people_enrich","name":"Apollo People Enrichment","description":"Enrich data for a single person using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"first_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"First name of the person"},"last_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Last name of the person"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Full name of the person (alternative to first_name/last_name)"},"id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the person"},"hashed_email":{"type":"string","required":false,"visibility":"user-or-llm","description":"MD5 or SHA-256 hashed email"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address of the person"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company name where the person works"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain (e.g., \\"apollo.io\\", \\"acme.com\\")"},"linkedin_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"LinkedIn profile URL"},"reveal_personal_emails":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal personal email addresses (uses credits)"},"reveal_phone_number":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal phone numbers (uses credits, requires webhook_url)"},"webhook_url":{"type":"string","required":false,"visibility":"user-only","description":"Webhook URL for async phone number delivery (required when reveal_phone_number is true)"}}},"apollo_people_search":{"id":"apollo_people_search","name":"Apollo People Search","description":"Search Apollo\'s database for people using demographic filters","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"person_titles":{"type":"array","required":false,"visibility":"user-or-llm","description":"Job titles to search for (e.g., [\\"CEO\\", \\"VP of Sales\\"])"},"include_similar_titles":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to return people with job titles similar to person_titles"},"person_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Locations to search in (e.g., [\\"San Francisco, CA\\", \\"New York, NY\\"])"},"person_seniorities":{"type":"array","required":false,"visibility":"user-or-llm","description":"Seniority levels (one of: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)"},"organization_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Apollo organization IDs to filter by (e.g., [\\"5e66b6381e05b4008c8331b8\\"])"},"organization_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Company names to search within (legacy filter)"},"organization_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Headquarters locations of the people\'s current employer (e.g., [\'texas\', \'tokyo\', \'spain\'])"},"q_organization_domains_list":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employer domain names (e.g., [\\"apollo.io\\", \\"microsoft.com\\"]) — up to 1,000, no www. or @"},"organization_num_employees_ranges":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employee count ranges for the person\'s current employer. Each entry is \\"min,max\\" (e.g., [\\"1,10\\", \\"250,500\\", \\"10000,20000\\"])"},"contact_email_status":{"type":"array","required":false,"visibility":"user-or-llm","description":"Email statuses to filter by: \\"verified\\", \\"unverified\\", \\"likely to engage\\", \\"unavailable\\""},"q_keywords":{"type":"string","required":false,"visibility":"user-or-llm","description":"Keywords to search for"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination, default 1 (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, default 25, max 100 (e.g., 25, 50, 100)"}}},"apollo_sequence_add_contacts":{"id":"apollo_sequence_add_contacts","name":"Apollo Add Contacts to Sequence","description":"Add contacts to an Apollo sequence","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"sequence_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the sequence to add contacts to (e.g., \\"seq_abc123\\")"},"contact_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of contact IDs to add to the sequence (e.g., [\\"con_abc123\\", \\"con_def456\\"]). Either contact_ids or label_names must be provided."},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of label names to identify contacts to add to the sequence. Either contact_ids or label_names must be provided."},"send_email_from_email_account_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the email account to send from. Use the Get Email Accounts operation to look this up."},"send_email_from_email_address":{"type":"string","required":false,"visibility":"user-only","description":"Specific email address to send from within the email account."},"sequence_no_email":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if they have no email address"},"sequence_unverified_email":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts with unverified email addresses"},"sequence_job_change":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts who recently changed jobs"},"sequence_active_in_other_campaigns":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts active in other campaigns"},"sequence_finished_in_other_campaigns":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts who finished other campaigns"},"sequence_same_company_in_same_campaign":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if others from the same company are in the sequence"},"contacts_without_ownership_permission":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts without ownership permission"},"add_if_in_queue":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if they are in the queue"},"contact_verification_skipped":{"type":"boolean","required":false,"visibility":"user-only","description":"Skip contact verification when adding"},"user_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the user performing the action"},"status":{"type":"string","required":false,"visibility":"user-only","description":"Initial status for added contacts: \\"active\\" or \\"paused\\""},"auto_unpause_at":{"type":"string","required":false,"visibility":"user-only","description":"ISO 8601 datetime to automatically unpause contacts"}}},"apollo_sequence_search":{"id":"apollo_sequence_search","name":"Apollo Search Sequences","description":"Search for sequences/campaigns in your team\'s Apollo account (master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"q_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search sequences by name (e.g., \\"Outbound Q1\\", \\"Follow-up\\")"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_task_create":{"id":"apollo_task_create","name":"Apollo Create Task","description":"Create one or more tasks in Apollo (one task per contact_id, master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"user_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the Apollo user the task is assigned to"},"contact_ids":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of contact IDs. One task is created per contact."},"priority":{"type":"string","required":false,"visibility":"user-or-llm","description":"Task priority: \\"high\\", \\"medium\\", or \\"low\\" (defaults to \\"medium\\")"},"due_at":{"type":"string","required":true,"visibility":"user-or-llm","description":"Due date/time in ISO 8601 format (e.g., \\"2024-12-31T23:59:59Z\\")"},"type":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task type: \\"call\\", \\"outreach_manual_email\\", \\"linkedin_step_connect\\", \\"linkedin_step_message\\", \\"linkedin_step_view_profile\\", \\"linkedin_step_interact_post\\", or \\"action_item\\""},"status":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task status: \\"scheduled\\", \\"completed\\", or \\"skipped\\""},"note":{"type":"string","required":false,"visibility":"user-or-llm","description":"Free-form note providing context for the task"}}},"apollo_task_search":{"id":"apollo_task_search","name":"Apollo Search Tasks","description":"Search for tasks in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"task_due_at\\" or \\"task_priority\\""},"open_factor_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Filter by status. Common values: [\\"task_types\\"] for open tasks, [\\"task_completed_at\\"] for completed tasks."},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"appconfig_create_application":{"id":"appconfig_create_application","name":"AppConfig Create Application","description":"Create an application in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the application to create"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the application"}}},"appconfig_create_configuration_profile":{"id":"appconfig_create_configuration_profile","name":"AppConfig Create Configuration Profile","description":"Create a configuration profile in an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to create the configuration profile in"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the configuration profile"},"locationUri":{"type":"string","required":true,"visibility":"user-or-llm","description":"Where the configuration is stored. Use \\"hosted\\" for AppConfig-hosted configurations, or an SSM/S3 URI"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the configuration profile"},"retrievalRoleArn":{"type":"string","required":false,"visibility":"user-or-llm","description":"ARN of an IAM role to retrieve the configuration (required for non-hosted URIs)"},"type":{"type":"string","required":false,"visibility":"user-or-llm","description":"Profile type: AWS.Freeform (default) or AWS.AppConfig.FeatureFlags"}}},"appconfig_create_environment":{"id":"appconfig_create_environment","name":"AppConfig Create Environment","description":"Create an environment for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to create the environment in"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the environment to create"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the environment"}}},"appconfig_create_hosted_configuration_version":{"id":"appconfig_create_hosted_configuration_version","name":"AppConfig Create Hosted Configuration Version","description":"Create a new hosted configuration version for an AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to add the version to"},"content":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration content (e.g., a JSON or YAML document)"},"contentType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Content type of the configuration (e.g., application/json, text/plain)"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the configuration version"},"latestVersionNumber":{"type":"number","required":false,"visibility":"user-or-llm","description":"The version number of the latest version, used for optimistic concurrency"},"versionLabel":{"type":"string","required":false,"visibility":"user-or-llm","description":"A user-defined label for the configuration version"}}},"appconfig_delete_application":{"id":"appconfig_delete_application","name":"AppConfig Delete Application","description":"Delete an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to delete"}}},"appconfig_delete_configuration_profile":{"id":"appconfig_delete_configuration_profile","name":"AppConfig Delete Configuration Profile","description":"Delete an AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to delete"}}},"appconfig_delete_environment":{"id":"appconfig_delete_environment","name":"AppConfig Delete Environment","description":"Delete an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to delete"}}},"appconfig_delete_hosted_configuration_version":{"id":"appconfig_delete_hosted_configuration_version","name":"AppConfig Delete Hosted Configuration Version","description":"Delete a specific hosted configuration version from an AppConfig profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID that owns the version"},"versionNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The version number to delete"}}},"appconfig_get_application":{"id":"appconfig_get_application","name":"AppConfig Get Application","description":"Get details about a single AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to retrieve"}}},"appconfig_get_configuration":{"id":"appconfig_get_configuration","name":"AppConfig Get Configuration","description":"Retrieve the latest deployed configuration for an AppConfig application, environment, and profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID or name to retrieve configuration for"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID or name to retrieve configuration for"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID or name to retrieve"}}},"appconfig_get_configuration_profile":{"id":"appconfig_get_configuration_profile","name":"AppConfig Get Configuration Profile","description":"Get details about a single AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to retrieve"}}},"appconfig_get_deployment":{"id":"appconfig_get_deployment","name":"AppConfig Get Deployment","description":"Get details about a specific AWS AppConfig deployment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployment"},"deploymentNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The sequence number of the deployment"}}},"appconfig_get_environment":{"id":"appconfig_get_environment","name":"AppConfig Get Environment","description":"Get details about a single AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to retrieve"}}},"appconfig_get_hosted_configuration_version":{"id":"appconfig_get_hosted_configuration_version","name":"AppConfig Get Hosted Configuration Version","description":"Retrieve a specific hosted configuration version from an AppConfig profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to read the version from"},"versionNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The version number to retrieve"}}},"appconfig_list_applications":{"id":"appconfig_list_applications","name":"AppConfig List Applications","description":"List applications in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of applications to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_configuration_profiles":{"id":"appconfig_list_configuration_profiles","name":"AppConfig List Configuration Profiles","description":"List configuration profiles for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profiles"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of configuration profiles to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_deployment_strategies":{"id":"appconfig_list_deployment_strategies","name":"AppConfig List Deployment Strategies","description":"List deployment strategies available in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of deployment strategies to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_deployments":{"id":"appconfig_list_deployments","name":"AppConfig List Deployments","description":"List deployments for an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployments"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployments"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of deployments to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_environments":{"id":"appconfig_list_environments","name":"AppConfig List Environments","description":"List environments for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environments"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of environments to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_hosted_configuration_versions":{"id":"appconfig_list_hosted_configuration_versions","name":"AppConfig List Hosted Configuration Versions","description":"List hosted configuration versions for an AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to list versions for"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of versions to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_start_deployment":{"id":"appconfig_start_deployment","name":"AppConfig Start Deployment","description":"Start deploying a configuration version to an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to deploy in"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to deploy to"},"deploymentStrategyId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The deployment strategy ID to use"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to deploy"},"configurationVersion":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration version to deploy"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the deployment"}}},"appconfig_stop_deployment":{"id":"appconfig_stop_deployment","name":"AppConfig Stop Deployment","description":"Stop an in-progress AWS AppConfig deployment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployment"},"deploymentNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The sequence number of the deployment to stop"}}},"appconfig_update_application":{"id":"appconfig_update_application","name":"AppConfig Update Application","description":"Update the name or description of an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the application"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the application"}}},"appconfig_update_configuration_profile":{"id":"appconfig_update_configuration_profile","name":"AppConfig Update Configuration Profile","description":"Update the name, description, or retrieval role of an AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the configuration profile"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the configuration profile"},"retrievalRoleArn":{"type":"string","required":false,"visibility":"user-or-llm","description":"New ARN of the IAM role used to retrieve the configuration"}}},"appconfig_update_environment":{"id":"appconfig_update_environment","name":"AppConfig Update Environment","description":"Update the name or description of an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the environment"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the environment"}}},"arxiv_get_author_papers":{"id":"arxiv_get_author_papers","name":"ArXiv Get Author Papers","description":"Search for papers by a specific author on ArXiv.","version":"1.0.0","params":{"authorName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Author name to search for"},"maxResults":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 10, max: 2000)"}}},"arxiv_get_paper":{"id":"arxiv_get_paper","name":"ArXiv Get Paper","description":"Get detailed information about a specific ArXiv paper by its ID.","version":"1.0.0","params":{"paperId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ArXiv paper ID (e.g., \\"1706.03762\\")"}}},"arxiv_search":{"id":"arxiv_search","name":"ArXiv Search","description":"Search for academic papers on ArXiv by keywords, authors, titles, or other fields.","version":"1.0.0","params":{"searchQuery":{"type":"string","required":true,"visibility":"user-or-llm","description":"The search query to execute"},"searchField":{"type":"string","required":false,"visibility":"user-only","description":"Field to search in: all, ti (title), au (author), abs (abstract), co (comment), jr (journal), cat (category), rn (report number)"},"maxResults":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 10, max: 2000)"},"sortBy":{"type":"string","required":false,"visibility":"user-only","description":"Sort by: relevance, lastUpdatedDate, submittedDate (default: relevance)"},"sortOrder":{"type":"string","required":false,"visibility":"user-only","description":"Sort order: ascending, descending (default: descending)"}}},"asana_add_comment":{"id":"asana_add_comment","name":"Asana Add Comment","description":"Add a comment (story) to an Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana task GID (numeric string)"},"text":{"type":"string","required":true,"visibility":"user-or-llm","description":"The text content of the comment"}},"oauth":{"required":true,"provider":"asana"}},"asana_add_followers":{"id":"asana_add_followers","name":"Asana Add Followers","description":"Add one or more followers to an Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana task (numeric string)"},"followers":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of user GIDs to add as followers to the task"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_project":{"id":"asana_create_project","name":"Asana Create Project","description":"Create a new project in an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) where the project will be created"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the project"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the project"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_section":{"id":"asana_create_section","name":"Asana Create Section","description":"Create a new section in an Asana project","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana project (numeric string) to add the section to"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the section"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_subtask":{"id":"asana_create_subtask","name":"Asana Create Subtask","description":"Create a subtask under an existing Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the parent Asana task (numeric string)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the subtask"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the subtask"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"User GID to assign the subtask to"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_task":{"id":"asana_create_task","name":"Asana Create Task","description":"Create a new task in Asana","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) where the task will be created"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the task"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the task"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"User GID to assign the task to"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"asana_delete_task":{"id":"asana_delete_task","name":"Asana Delete Task","description":"Delete an Asana task by its GID (moves it to the trash)","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana task to delete (numeric string)"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_project":{"id":"asana_get_project","name":"Asana Get Project","description":"Retrieve a single Asana project by its GID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana project GID (numeric string) to retrieve"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_projects":{"id":"asana_get_projects","name":"Asana Get Projects","description":"Retrieve all projects from an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to retrieve projects from"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_task":{"id":"asana_get_task","name":"Asana Get Task","description":"Retrieve a single task by GID or get multiple tasks with filters","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":false,"visibility":"user-or-llm","description":"The globally unique identifier (GID) of the task. If not provided, will get multiple tasks."},"workspace":{"type":"string","required":false,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to filter tasks (required when not using taskGid)"},"project":{"type":"string","required":false,"visibility":"user-or-llm","description":"Asana project GID (numeric string) to filter tasks"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of tasks to return (default: 50)"}},"oauth":{"required":true,"provider":"asana"}},"asana_list_sections":{"id":"asana_list_sections","name":"Asana List Sections","description":"List all sections in an Asana project","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana project (numeric string) to list sections from"}},"oauth":{"required":true,"provider":"asana"}},"asana_list_workspaces":{"id":"asana_list_workspaces","name":"Asana List Workspaces","description":"List all Asana workspaces and organizations the authenticated user belongs to","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"}},"oauth":{"required":true,"provider":"asana"}},"asana_search_tasks":{"id":"asana_search_tasks","name":"Asana Search Tasks","description":"Search for tasks in an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to search tasks in"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Text to search for in task names"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter tasks by assignee user GID"},"projects":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of Asana project GIDs (numeric strings) to filter tasks by"},"completed":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Filter by completion status"}},"oauth":{"required":true,"provider":"asana"}},"asana_update_task":{"id":"asana_update_task","name":"Asana Update Task","description":"Update an existing task in Asana","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana task GID (numeric string) of the task to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated name for the task"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated notes or description for the task"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated assignee user GID"},"completed":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Mark task as completed or not completed"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"ashby_add_candidate_tag":{"id":"ashby_add_candidate_tag","name":"Ashby Add Candidate Tag","description":"Adds a tag to a candidate in Ashby and returns the updated candidate.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to add the tag to"},"tagId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the tag to add"}}},"ashby_change_application_stage":{"id":"ashby_change_application_stage","name":"Ashby Change Application Stage","description":"Moves an application to a different interview stage. Requires an archive reason when moving to an Archived stage.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the application to update the stage of"},"interviewStageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the interview stage to move the application to"},"archiveReasonId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Archive reason UUID. Required when moving to an Archived stage, ignored otherwise"}}},"ashby_create_application":{"id":"ashby_create_application","name":"Ashby Create Application","description":"Creates a new application for a candidate on a job. Optionally specify interview plan, stage, source, and credited user.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to consider for the job"},"jobId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the job to consider the candidate for"},"interviewPlanId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the interview plan to use (defaults to the job default plan)"},"interviewStageId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the interview stage to place the application in (defaults to first Lead stage)"},"sourceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the source to set on the application"},"creditedToUserId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the user the application is credited to"},"createdAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to set as the application creation date (defaults to now)"}}},"ashby_create_candidate":{"id":"ashby_create_candidate","name":"Ashby Create Candidate","description":"Creates a new candidate record in Ashby.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"The candidate full name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary email address for the candidate"},"phoneNumber":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number for the candidate"},"linkedInUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"LinkedIn profile URL"},"githubUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"GitHub profile URL"},"website":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal website URL"},"sourceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the source to attribute the candidate to"},"creditedToUserId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the Ashby user to credit with sourcing this candidate"},"createdAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"Backdated creation timestamp in ISO 8601 (e.g. 2024-01-01T00:00:00Z). Defaults to now."},"alternateEmailAddresses":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of additional email address strings to add to the candidate, e.g. [\\"a@x.com\\",\\"b@y.com\\"]"}}},"ashby_create_note":{"id":"ashby_create_note","name":"Ashby Create Note","description":"Creates a note on a candidate in Ashby. Supports plain text and HTML content (bold, italic, underline, links, lists, code).","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to add the note to"},"note":{"type":"string","required":true,"visibility":"user-or-llm","description":"The note content. If noteType is text/html, supports: , , , ,