View as Markdown
Zoho Books icon

Zoho Books ACTION

Create Item

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

IMPLEMENTATION

Call this tool

Connect a user's Zoho Books 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: "zoho_books-create-item",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoho_books: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    rate: "Rate",
  },
})

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
name Name string
Name of the item. Max-length [100]
Required
rate Rate string
Price of the item.
Required
description Description string
Description for the item. Max-length [2000]
Optional
taxId Tax Id string
ID of the tax to be associated to the item.
Optional Dynamic
taxPercentage Tax Percentage string
Percent of the tax.
Optional
sku SKU string
SKU value of item,should be unique throughout the product
Optional
productType Product Type string
Specify the type of an item.
Optional
hsnOrSac HSN Or SAC string
HSN Code.
Optional
isTaxable Is Taxable boolean
Boolean to track the taxability of the item.
Optional
taxExemptionId Tax Exemption Id string
ID of the tax exemption. Mandatory, if is_taxable is false.
Optional
accountId Account Id string
ID of the account to which the item has to be associated with.
Optional Dynamic
itemType Item Type string
Type of the item. Default value will be sales.
Optional
purchaseDescription Purchase Description string
Purchase description for the item.
Optional
purchaseRate Purchase Rate string
Purchase price of the item.
Optional
purchaseAccountId Purchase Account Id string
ID of the COGS account to which the item has to be associated with. Mandatory, if item_type is purchase / sales and purchase / inventory.
Optional
inventoryAccountId Inventory Account Id string
ID of the stock account to which the item has to be associated with. Mandatory, if item_type is inventory.
Optional
vendorId Vendor Id string
Preferred vendor ID.
Optional
reorderLevel Reorder Level string
Reorder level of the item.
Optional
initialStock Initial Stock string
Opening stock of the item.
Optional
initialStockRate Initial Stock Rate string
Unit price of the opening stock.
Optional
itemTaxPreferences Item Tax Preferences string[]
A list of item tax objects. Format: {"tax_id":"12312312031200","tax_specification":"intra"}
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
zoho_books-create-item
Version
0.3.1
App
Zoho Books
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes