View as Markdown
QuickBooks icon

QuickBooks ACTION

Create Purchase Order

Creates a purchase order. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's QuickBooks account once, then configure and run Create Purchase Order from your backend or agent.

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-create-purchase-order",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    quickbooks: { authProvisionId: "apn_xxxxxxx" },
    accountId: "Account ID",
    vendorRefValue: "Vendor Reference",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Purchase Order inputs
Property Type Description
accountId Account ID string
The ID of the account to use for the purchase order
Required Dynamic
vendorRefValue Vendor Reference string
Reference to a vendor
Required Dynamic
dueDate Due Date string
Date when the purchase order is due (YYYY-MM-DD)
Optional
currencyRefValue Currency Code string
A three letter string representing the ISO 4217 code for the currency. For example, USD, AUD, EUR, and so on. This must be defined if multicurrency is enabled for the company. Multicurrency is enabled for the company if Preferences.MultiCurrencyEnabled is set to true. Read more about multicurrency support here. Required if multicurrency is enabled for the company.
Optional Dynamic
docNumber Document Number string
Reference number for the transaction
Optional
shippingStreetAddress Shipping Street Address string
The street address of the shipping address
Optional
shippingCity Shipping City string
The city of the shipping address
Optional
shippingState Shipping State string
The state of the shipping address
Optional
shippingZip Shipping Zip string
The zip code of the shipping address
Optional
shippingLatitude Shipping Latitude string
The latitude of the shipping address
Optional
shippingLongitude Shipping Longitude string
The longitude of the shipping address
Optional
memo Memo string
Memo or note for the purchase order
Optional
lineItemsAsObjects Enter Line Items as Objects boolean
Enter line items as an array of objects
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
quickbooks-create-purchase-order
Version
0.0.5
App
QuickBooks
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes