View as Markdown
Xero Accounting icon

Xero Accounting ACTION

Create Item

Creates a new item.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Xero Accounting account once, then configure and run Create Item 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: "xero_accounting_api-create-item",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    xero_accounting_api: { authProvisionId: "apn_xxxxxxx" },
    tenantId: "Tenant ID",
    code: "Code",
  },
})

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 Item inputs
Property Type Description
tenantId Tenant ID string
Select an organization tenant to use, or provide a tenant ID
Required Dynamic
code Code string
User defined item code (max length = 30)
Required
inventoryAssetAccountCode Inventory Asset Account Code string
The inventory asset account for the item. The account must be of type INVENTORY. The COGSAccountCode in PurchaseDetails is also required to create a tracked item
Optional
name Name string
The name of the item (max length = 50)
Optional
isSold Is Sold boolean
Boolean value, defaults to true. When IsSold is true the item will be available on sales transactions in the Xero UI. If IsSold is updated to false then Description and SalesDetails values will be nulled.
Optional
isPurchased Is Purchased boolean
Boolean value, defaults to true. When IsPurchased is true the item is available for purchase transactions in the Xero UI. If IsPurchased is updated to false then PurchaseDescription and PurchaseDetails values will be nulled.
Optional
description Description string
The sales description of the item (max length = 4000)
Optional
purchaseDescription Purchase Description string
The purchase description of the item (max length = 4000)
Optional
purchaseDetails Purchase Details string
See Purchases & Sales. The PurchaseDetails element can contain a number of individual sub-elements.
Optional
salesDetails Sales Details string
See Purchases & Sales. The SalesDetails element can contain a number of individual sub-elements.
Optional
unitdp Unitdp string
By default UnitPrice is returned to two decimal places.
Optional

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
xero_accounting_api-create-item
Version
0.1.4
App
Xero Accounting
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes