# QuickBooks Sandbox — Pipedream Connect

> Online accounting software

- API slug: `quickbooks_sandbox` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Commerce
- Website: https://quickbooks.com
- Managed OAuth scopes: `com.intuit.quickbooks.accounting` · `openid` · `profile` · `email`
- This page (HTML): https://pipedream.com/apps/quickbooks-sandbox
- Tools: 43 actions · 10 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: quickbooks_sandbox`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "quickbooks_sandbox",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create AP Aging Detail Report:
const result = await mcp.callTool({
  name: "quickbooks_sandbox-create-ap-aging-report",
  arguments: {
    shipvia: "Ship Via",
    termIds: ["Term IDs"],
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a QuickBooks Sandbox endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "quickbooks_sandbox-create-ap-aging-report",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    quickbooks_sandbox: { authProvisionId: "apn_xxxxxxx" },
    shipvia: "Ship Via",
    termIds: ["Term IDs"],
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (43)

### `quickbooks_sandbox-create-ap-aging-report` — Create AP Aging Detail Report (Write)

Creates an AP aging report in Quickbooks Online. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-ap-aging-report.md

### `quickbooks_sandbox-create-bill` — Create Bill (Write)

Creates a bill. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-bill.md

### `quickbooks_sandbox-create-customer` — Create Customer (Write)

Creates a customer. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-customer.md

### `quickbooks_sandbox-create-estimate` — Create Estimate (Write)

Creates an estimate. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-estimate.md

### `quickbooks_sandbox-create-invoice` — Create Invoice (Write)

Creates an invoice. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-invoice.md

### `quickbooks_sandbox-create-payment` — Create Payment (Write)

Creates a payment. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-payment.md

### `quickbooks_sandbox-create-pl-report` — Create Profit and Loss Detail Report (Write)

Creates a profit and loss report in Quickbooks Online. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-pl-report.md

### `quickbooks_sandbox-create-purchase` — Create Purchase (Write)

Creates a new purchase. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-purchase.md

### `quickbooks_sandbox-create-purchase-order` — Create Purchase Order (Write)

Creates a purchase order. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-purchase-order.md

### `quickbooks_sandbox-create-sales-receipt` — Create Sales Receipt (Write)

Creates a sales receipt. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/create-sales-receipt.md

### `quickbooks_sandbox-delete-purchase` — Delete Purchase (Write)

Delete a specific purchase. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/delete-purchase.md

### `quickbooks_sandbox-get-balance-sheet-report` — Get Balance Sheet Report (Read-only)

Retrieves the balance sheet report from Quickbooks Online. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-balance-sheet-report.md

### `quickbooks_sandbox-get-bill` — Get Bill (Write)

Returns info about a bill. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-bill.md

### `quickbooks_sandbox-get-cash-flow-report` — Get Cash Flow Report (Read-only)

Retrieves the cash flow report from Quickbooks Online. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-cash-flow-report.md

### `quickbooks_sandbox-get-customer` — Get Customer (Write)

Returns info about a customer. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-customer.md

### `quickbooks_sandbox-get-invoice` — Get Invoice (Write)

Returns info about an invoice. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-invoice.md

### `quickbooks_sandbox-get-my-company` — Get My Company (Write)

Gets info about a company. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-my-company.md

### `quickbooks_sandbox-get-payment` — Get Payment (Write)

Returns info about a payment. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-payment.md

### `quickbooks_sandbox-get-purchase` — Get Purchase (Write)

Returns info about a purchase. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-purchase.md

### `quickbooks_sandbox-get-purchase-order` — Get Purchase Order (Write)

Returns details about a purchase order. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-purchase-order.md

### `quickbooks_sandbox-get-sales-receipt` — Get Sales Receipt (Write)

Returns details about a sales receipt. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-sales-receipt.md

### `quickbooks_sandbox-get-time-activity` — Get Time Activity (Write)

Returns info about an activity. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/get-time-activity.md

### `quickbooks_sandbox-list-open-invoices` — List Open Invoices (Read-only)

Lists invoices with an outstanding balance (open invoices). Optionally supply a full query to override the default filter. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/list-open-invoices.md

### `quickbooks_sandbox-list-past-due-invoices` — List Past Due Invoices (Read-only)

Lists open invoices whose due date is before today in the company's time zone (from CompanyInfo.DefaultTimeZone when available). Optionally supply a full Invoice query to override the default filter. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/list-past-due-invoices.md

### `quickbooks_sandbox-search-account` — Search Account (Write)

Searches for accounts.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-account.md

### `quickbooks_sandbox-search-accounts` — Search Accounts (Write)

Search for accounts. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-accounts.md

### `quickbooks_sandbox-search-customers` — Search Customers (Write)

Searches for customers. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-customers.md

### `quickbooks_sandbox-search-invoices` — Search Invoices (Write)

Searches for invoices. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-invoices.md

### `quickbooks_sandbox-search-items` — Search Items (Write)

Searches for items. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-items.md

### `quickbooks_sandbox-search-products` — Search Products (Write)

Search for products. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-products.md

### `quickbooks_sandbox-search-purchases` — Search Purchases (Write)

Searches for purchases. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-purchases.md

### `quickbooks_sandbox-search-query` — Search Query (Write)

Performs a search query against a Quickbooks entity. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-query.md

### `quickbooks_sandbox-search-services` — Search Services (Write)

Search for services. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-services.md

### `quickbooks_sandbox-search-time-activities` — Search Time Activities (Write)

Searches for time activities. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-time-activities.md

### `quickbooks_sandbox-search-vendors` — Search Vendors (Write)

Searches for vendors. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/search-vendors.md

### `quickbooks_sandbox-send-estimate` — Send Estimate (Write)

Sends an estimate by email. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/send-estimate.md

### `quickbooks_sandbox-send-invoice` — Send Invoice (Write)

Sends an invoice by email. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/send-invoice.md

### `quickbooks_sandbox-sparse-update-invoice` — Sparse Update Invoice (Write)

Sparse updating provides the ability to update a subset of properties for a given object; only elements specified in the request are updated. Missing elements are left untouched. The ID of the object to update is specified in the request body.​ See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/sparse-update-invoice.md

### `quickbooks_sandbox-update-customer` — Update Customer (Write)

Updates a customer. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/update-customer.md

### `quickbooks_sandbox-update-estimate` — Update Estimate (Write)

Updates an estimate. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/update-estimate.md

### `quickbooks_sandbox-update-invoice` — Update Invoice (Write)

Updates an invoice. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/update-invoice.md

### `quickbooks_sandbox-update-item` — Update Item (Write)

Updates an item. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/update-item.md

### `quickbooks_sandbox-void-invoice` — Void Invoice (Write)

Voids an invoice. See the documentation

Full schema: https://pipedream.com/apps/quickbooks-sandbox/actions/void-invoice.md

## Triggers (10)

### `quickbooks_sandbox-new-customer-created` — New Customer Created (Polling)

Emit new event when a new customer is created.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-customer-created.md

### `quickbooks_sandbox-new-customer-updated` — New Customer Updated (Polling)

Emit new event when a customer is updated.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-customer-updated.md

### `quickbooks_sandbox-new-employee-created` — New Employee Created (Polling)

Emit new event when a new employee is created.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-employee-created.md

### `quickbooks_sandbox-new-employee-updated` — New Employee Updated (Polling)

Emit new event when an employee is updated.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-employee-updated.md

### `quickbooks_sandbox-new-invoice-created` — New Invoice Created (Polling)

Emit new event when a new invoice is created.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-invoice-created.md

### `quickbooks_sandbox-new-invoice-updated` — New Invoice Updated (Polling)

Emit new event when an invoice is updated.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-invoice-updated.md

### `quickbooks_sandbox-new-item-created` — New Item Created (Polling)

Emit new event when a new item is created.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-item-created.md

### `quickbooks_sandbox-new-item-updated` — New Item Updated (Polling)

Emit new event when an item is updated.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-item-updated.md

### `quickbooks_sandbox-new-purchase-created` — New Purchase Created (Polling)

Emit new event when a new purchase is created.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-purchase-created.md

### `quickbooks_sandbox-new-purchase-updated` — New Purchase Updated (Polling)

Emit new event when a purchase is updated.

Full schema: https://pipedream.com/apps/quickbooks-sandbox/triggers/new-purchase-updated.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt