View as Markdown
Zoho Inventory icon

Zoho Inventory ACTION

Create Item

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

IMPLEMENTATION

Call this tool

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

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
organization Organization string
Select the organization
Required Dynamic
name Name string
Name of the item.
Required
groupId Item Group string
The item group to which this item belongs.
Optional Dynamic
groupName Group Name string
Name of the product group.
Optional
unit Unit string
Unit of measurement for the item (e.g., kg, box, pcs).
Optional
itemType Item Type string
Item type. If the item is associated with a group, type should be inventory.
Optional
productType Product Type string
Type of the product.
Optional
isTaxable Is Taxable boolean
Whether the item is taxable.
Optional
taxId Tax string
The tax to associate with the item.
Optional Dynamic
description Description string
Description of the item.
Optional
purchaseAccountId Purchase Account string
Unique ID generated by the server for the purchase account.
Optional Dynamic
inventoryAccountId Inventory Account string
Unique ID generated by the server for the inventory account.
Optional Dynamic
vendorId Vendor string
The preferred vendor for purchasing this item.
Optional Dynamic
vendorName Vendor Name string
Name of the preferred vendor for purchasing this item.
Optional
rate Rate string
Sales price of the item.
Optional
purchaseRate Purchase Rate string
Purchase price of the item.
Optional
reorderLevel Reorder Level string
Reorder level of the item.
Optional
sku SKU string
The Stock Keeping Unit (SKU) of the item. Must be unique across all items.
Optional
upc UPC string
The 12-digit Unique Product Code (UPC) of the item.
Optional
ean EAN string
Unique EAN value for the item.
Optional
isbn ISBN string
Unique ISBN value for the item.
Optional
partNumber Part Number string
Part number of the item.
Optional
attributeName1 Attribute Name string
Name of the attribute present in the item group.
Optional
attributeOptionName1 Attribute Option Name string
Name of the attribute's option.
Optional
purchaseDescription Purchase Description string
Description displayed to the vendor in purchase orders.
Optional
documents Documents string[]
List of documents associated with the item. Each entry should be a JSON string, e.g. {"name":"manual.pdf","document_type":"pdf"}.
Optional
locations Locations string[]
List of locations for the item. Each entry should be a JSON string, e.g. {"warehouse_id":"WH123","quantity":10}.
Optional
itemTaxPreferences Item Tax Preferences string[]
🇮🇳 List of tax preferences for the item. Each entry should be a JSON string, e.g. {"tax_name":"GST","tax_percentage":18}.
Optional
hsnOrSac HSN or SAC Code string
🇮🇳 HSN code of the item.
Optional
satItemKeyCode SAT Item Key Code string
🇲🇽 SAT item key code for goods/services.
Optional
unitKeyCode Unit Key Code string
🇲🇽 Unit key code for goods/services.
Optional
customFields Custom Fields string[]
Custom fields for the item. Each entry should be a JSON string, e.g. {"customfield_id":"cf_1","value":"foo"}.
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_inventory-create-item
Version
0.0.1
App
Zoho Inventory
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes