> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ApprovalMax

> How to set up the ApprovalMax connector, plus the actions that are available.

![ApprovalMax](https://stackone-logos.com/api/approvalmax/filled/svg)

v1.3.0[See changelog](https://docs.stackone.com/connectors/approvalmax/changelog.md)

[70 actions](#actions) · 1 auth method

Accounting
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/approvalmax/guides/connector-profile/oauth-2-0.md)
>
> Login to your ApprovalMax account to connect your data.

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/approvalmax/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

https\://​www\.approvalmax.com/scopes/public\_api/read

https\://​www\.approvalmax.com/scopes/public\_api/write

openid

No scopes found

70 actions

ActionDescriptionRequired scopes

Get Request Attachment`approvalmax_get_request_attachment`

Download an attachment file from an ApprovalMax approval request

`https://​www.approvalmax.com/scopes/public_api/read`

Upload Request Attachment`approvalmax_upload_request_attachment`

Upload a file attachment to an ApprovalMax approval request

`https://​www.approvalmax.com/scopes/public_api/write`

Delete Request Attachment`approvalmax_delete_request_attachment`

Permanently delete an attachment from an ApprovalMax approval request (irreversible)

`https://​www.approvalmax.com/scopes/public_api/write`

Get Request Comment Attachment`approvalmax_get_request_comment_attachment`

Download an attachment file from a comment on an ApprovalMax approval request

`https://​www.approvalmax.com/scopes/public_api/read`

List Companies`approvalmax_list_companies`

Retrieve all ApprovalMax companies (organisations) accessible to the authenticated user

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Vendor Bills`approvalmax_list_netsuite_vendor_bills`

Retrieve NetSuite vendor bills with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Vendor Bill`approvalmax_get_netsuite_vendor_bill`

Retrieve a single NetSuite vendor bill by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Purchase Orders`approvalmax_list_netsuite_purchase_orders`

Retrieve NetSuite purchase orders with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Purchase Order`approvalmax_get_netsuite_purchase_order`

Retrieve a single NetSuite purchase order by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Expense Reports`approvalmax_list_netsuite_expense_reports`

Retrieve NetSuite expense reports with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Expense Report`approvalmax_get_netsuite_expense_report`

Retrieve a single NetSuite expense report by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Sales Orders`approvalmax_list_netsuite_sales_orders`

Retrieve NetSuite sales orders with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Sales Order`approvalmax_get_netsuite_sales_order`

Retrieve a single NetSuite sales order by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Invoices`approvalmax_list_netsuite_invoices`

Retrieve NetSuite invoices with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Invoice`approvalmax_get_netsuite_invoice`

Retrieve a single NetSuite invoice by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Bill Payments`approvalmax_list_netsuite_bill_payments`

Retrieve NetSuite bill payments with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Bill Payment`approvalmax_get_netsuite_bill_payment`

Retrieve a single NetSuite bill payment by its request ID, including full payment details and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Journal Entries`approvalmax_list_netsuite_journal_entries`

Retrieve NetSuite journal entries with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Journal Entry`approvalmax_get_netsuite_journal_entry`

Retrieve a single NetSuite journal entry by its request ID, including debit/credit lines and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List NetSuite Item Receipts`approvalmax_list_netsuite_item_receipts`

Retrieve NetSuite item receipts with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get NetSuite Item Receipt`approvalmax_get_netsuite_item_receipt`

Retrieve a single NetSuite item receipt by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List QuickBooks Bills`approvalmax_list_qbooks_bills`

Retrieve QuickBooks Online bills with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get QuickBooks Bill`approvalmax_get_qbooks_bill`

Retrieve a single QuickBooks Online bill by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List QuickBooks Purchase Orders`approvalmax_list_qbooks_purchase_orders`

Retrieve QuickBooks Online purchase orders with optional filtering by reference, status, and date ranges. Supports pagin...

`https://​www.approvalmax.com/scopes/public_api/read`

Get QuickBooks Purchase Order`approvalmax_get_qbooks_purchase_order`

Retrieve a single QuickBooks Online purchase order by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List QuickBooks Expenses`approvalmax_list_qbooks_expenses`

Retrieve QuickBooks Online expenses with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get QuickBooks Expense`approvalmax_get_qbooks_expense`

Retrieve a single QuickBooks Online expense by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Standalone Documents`approvalmax_list_standalone_documents`

Retrieve standalone documents with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Standalone Document`approvalmax_get_standalone_document`

Retrieve a single standalone document by its request ID, including details, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

Create Standalone Document`approvalmax_create_standalone_document`

Create a draft standalone document in ApprovalMax that can then be submitted for approval

`https://​www.approvalmax.com/scopes/public_api/write`

Edit Standalone Document`approvalmax_edit_standalone_document`

Edit an existing standalone document in ApprovalMax (requires currentVersion for concurrency control)

`https://​www.approvalmax.com/scopes/public_api/write`

List Standalone Currencies`approvalmax_list_standalone_currencies`

Retrieve the supported currency codes for standalone documents in an ApprovalMax company

`https://​www.approvalmax.com/scopes/public_api/read`

List Standalone Workflows`approvalmax_list_standalone_workflows`

Retrieve the approval workflows available for standalone documents in an ApprovalMax company

`https://​www.approvalmax.com/scopes/public_api/read`

Submit Standalone Document`approvalmax_submit_standalone_document`

Submit a draft standalone document to trigger the configured approval workflow

`https://​www.approvalmax.com/scopes/public_api/write`

Mark Xero Purchase Order As Billed`approvalmax_mark_xero_purchase_order_as_billed`

Mark an approved Xero purchase order as billed to close it for matching

`https://​www.approvalmax.com/scopes/public_api/write`

List User Profiles`approvalmax_list_user_profiles`

Retrieve all user profiles (members and participants) for an ApprovalMax company

`https://​www.approvalmax.com/scopes/public_api/read`

Get User Profile`approvalmax_get_user_profile`

Retrieve a single user profile by user ID within an ApprovalMax company

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Bills`approvalmax_list_xero_bills`

Retrieve Xero bills with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Bill`approvalmax_get_xero_bill`

Retrieve a single Xero bill by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Purchase Orders`approvalmax_list_xero_purchase_orders`

Retrieve Xero purchase orders with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Purchase Order`approvalmax_get_xero_purchase_order`

Retrieve a single Xero purchase order by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Batch Payments`approvalmax_list_xero_batch_payments`

Retrieve Xero batch payments with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Batch Payment`approvalmax_get_xero_batch_payment`

Retrieve a single Xero batch payment by its request ID, including full payment details and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Credit Notes`approvalmax_list_xero_credit_notes`

Retrieve Xero credit notes with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Credit Note`approvalmax_get_xero_credit_note`

Retrieve a single Xero credit note by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Sales Invoices`approvalmax_list_xero_sales_invoices`

Retrieve Xero sales invoices with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Sales Invoice`approvalmax_get_xero_sales_invoice`

Retrieve a single Xero sales invoice by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Quotes`approvalmax_list_xero_quotes`

Retrieve Xero quotes with optional filtering by reference, status, and date ranges. Supports pagination.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Xero Quote`approvalmax_get_xero_quote`

Retrieve a single Xero quote by its request ID, including line items, attachments, and comments

`https://​www.approvalmax.com/scopes/public_api/read`

Create Xero Quote`approvalmax_create_xero_quote`

Create a draft Xero quote in ApprovalMax

`https://​www.approvalmax.com/scopes/public_api/write`

Edit Xero Quote`approvalmax_edit_xero_quote`

Edit an existing Xero quote in ApprovalMax (requires currentVersion for concurrency control)

`https://​www.approvalmax.com/scopes/public_api/write`

List Xero Accounts`approvalmax_list_xero_accounts`

Retrieve the Xero chart of accounts for use as accountId values in document line items

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Branding Themes`approvalmax_list_xero_branding_themes`

Retrieve Xero branding themes for use as brandingThemeId values in documents

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Contacts`approvalmax_list_xero_contacts`

Retrieve Xero contacts (suppliers and customers) for use as contactId values in documents. Supports pagination and filte...

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Currencies`approvalmax_list_xero_currencies`

Retrieve Xero currencies configured for the company, for use as currency values in documents

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Items`approvalmax_list_xero_items`

Retrieve Xero items (products and services) for use as itemId values in document line items. Supports pagination and fil...

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Taxes`approvalmax_list_xero_taxes`

Retrieve Xero tax rates for use as taxCode values in document line items

`https://​www.approvalmax.com/scopes/public_api/read`

List Xero Tracking Categories`approvalmax_list_xero_tracking_categories`

Retrieve Xero tracking categories and their options for line item tracking assignments

`https://​www.approvalmax.com/scopes/public_api/read`

Create Xero Bill`approvalmax_create_xero_bill`

Create a draft Xero bill in ApprovalMax

`https://​www.approvalmax.com/scopes/public_api/write`

Edit Xero Bill`approvalmax_edit_xero_bill`

Edit an existing Xero bill in ApprovalMax (requires currentVersion for concurrency control)

`https://​www.approvalmax.com/scopes/public_api/write`

Create Xero Purchase Order`approvalmax_create_xero_purchase_order`

Create a draft Xero purchase order in ApprovalMax that can then be submitted for approval

`https://​www.approvalmax.com/scopes/public_api/write`

Edit Xero Purchase Order`approvalmax_edit_xero_purchase_order`

Edit an existing Xero purchase order in ApprovalMax (requires currentVersion for concurrency control)

`https://​www.approvalmax.com/scopes/public_api/write`

Create Xero Sales Invoice`approvalmax_create_xero_sales_invoice`

Create a draft Xero sales invoice in ApprovalMax

`https://​www.approvalmax.com/scopes/public_api/write`

Edit Xero Sales Invoice`approvalmax_edit_xero_sales_invoice`

Edit an existing Xero sales invoice in ApprovalMax (requires currentVersion for concurrency control)

`https://​www.approvalmax.com/scopes/public_api/write`

Get Unified Credentials`approvalmax_unified_get_me`

Get the current ApprovalMax connection's unified credentials and identity.

`openid`

IAM Auth Test`approvalmax_auth_test`

Validate the current ApprovalMax OAuth token and return the raw, unmapped OIDC userinfo JSON. Bypasses the unified IAM c...

`openid`

List Unified Organizations`approvalmax_unified_list_organizations`

List unified organizations in ApprovalMax.

`https://​www.approvalmax.com/scopes/public_api/read`

Get Unified Organization`approvalmax_unified_get_organization`

Get a unified ApprovalMax organization by ID.

`https://​www.approvalmax.com/scopes/public_api/read`

List Unified Users`approvalmax_unified_list_users`

List the user profiles within a single ApprovalMax company, mapped to the IAM unified user schema. filter.organization\_i...

`https://​www.approvalmax.com/scopes/public_api/read`

Get Unified User`approvalmax_unified_get_user`

Get a unified ApprovalMax user by ID.

`https://​www.approvalmax.com/scopes/public_api/read`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.