POST Item

Insert an inventory item.

Request Information

URI Parameters

Name	Description	Type	Additional information
WsAccessKey	The Web Service access key for this user and file which allows access to the API for the associated file (found in File - Settings). Using OAuth authentication mechanism is the preferred method to allow API access.	string	Optional. Legacy authentication method and only required if not using OAuth. OAuth is preferred.
FileId	Specifies the file id of the file to perform the operation upon.	integer	Required

Body Parameters

Inventory item details.

ItemDetail

Name	Description	Type	Additional information
Notes	Custom notes associated with this item.	string	None.
BuildItems	The items that constitute or form the 'build' of this item.	Collection of BuildItem	None.
Id	The Unique Id/key for the resource.	integer	None.
Code	The code for this item.	string	None.
Description	The description for this item.	string	None.
Type	The type of this item. Supported types are 'I' = Inventory item, 'C' = Combo item.	string	None.
IsActive	Indicates if the item is active.	boolean	None.
IsInventoried	Indicates if the item is inventoried.	boolean	None.
AssetAccountId	The associated asset account id.	integer	None.
IsSold	Indicates if the item is sold.	boolean	None.
SaleIncomeAccountId	The associated sale income account id.	integer	None.
SaleTaxCodeId	The associated sale tax code id.	integer	None.
SaleCoSAccountId	The associated cost of sale account id.	integer	None.
IsBought	Indicates if the item is bought.	boolean	None.
PurchaseExpenseAccountId	The associated purchase expense account id.	integer	None.
PurchaseTaxCodeId	The associated purchase tax code id.	integer	None.
MinimumStockLevel	The minimumm stock level allowed.	decimal number	None.
StockOnHand	The current stock on hand. This data is returned only and cannot be added or updated when issuing a POST or PUT.	decimal number	None.
CurrentValue	The current value of the item. This data is returned only and cannot be added or updated when issuing a POST or PUT.	decimal number	None.
PrimarySupplierContactId	The primary supplier's contact id (if any).	integer	None.
PrimarySupplierItemCode	The primary supplier's item code.	string	None.
DefaultReOrderQuantity	The default re-order quantity when the minimum stock level is reached.	decimal number	None.
LastUpdatedId	The unique id generated after an update that is required to be passed in when next updating this resource to ensure consistency.	string	None.
IsVisible	Indicates if this item is visible.	boolean	None.
IsVirtual	Indicate if this is a virtual item.	boolean	None.
VType	Indicates the 'virtual type' of the item.	string	None.
SellingPrice	The selling price of the item.	decimal number	None.
IsSellingPriceIncTax	Indicates if the selling price includes tax.	boolean	None.
CreatedDateUtc	The date and time that the item was created in UTC.	date	None.
LastModifiedDateUtc	The date and time that the item was modified in UTC.	date	None.
LastModifiedBy	The user id that last modified this item.	integer	None.
BuyingPrice	The buying price of this item.	decimal number	None.
IsBuyingPriceIncTax	Indicates if the buying price includes tax.	boolean	None.
IsVoucher	Indicates if the item represens a voucher.	boolean	None.
ValidFrom	If this item is a voucher (IsVoucher = true), this indicates the date and time that the voucher item is valid from.	date	None.
ValidTo	If this item is a voucher (IsVoucher = true), this indicates the date and time that the voucher item is valid to.	date	None.
OnOrder	The number of items currently on order.	decimal number	None.
Committed	The number of items currently committed.	decimal number	None.
_links	Hypermedia links. Contains contextual links to possible next actions related to this resource. Only present in responses. This data is not to be sent to the server.	Collection of Link	None.

Request Formats

application/json, text/json

Sample:

{
  "Notes": "Some custom notes",
  "BuildItems": [
    {
      "Id": 1,
      "Code": "Code1",
      "Description": "Build Item 1",
      "Quantity": 5.0,
      "_links": [
        {
          "rel": "detail",
          "href": "https://api.saasu.com/Item/1?FileId=123",
          "method": "GET",
          "title": null
        }
      ]
    },
    {
      "Id": 2,
      "Code": "Code2",
      "Description": "Build Item 2",
      "Quantity": 15.0,
      "_links": [
        {
          "rel": "detail",
          "href": "https://api.saasu.com/Item/2?FileId=123",
          "method": "GET",
          "title": null
        }
      ]
    }
  ],
  "Id": 12,
  "Code": "ABC",
  "Description": "Some item",
  "Type": "I",
  "IsActive": true,
  "IsInventoried": false,
  "AssetAccountId": 123,
  "IsSold": true,
  "SaleIncomeAccountId": 789,
  "SaleTaxCodeId": 112,
  "SaleCoSAccountId": 456,
  "IsBought": true,
  "PurchaseExpenseAccountId": 567,
  "PurchaseTaxCodeId": 123,
  "MinimumStockLevel": 2.0,
  "StockOnHand": 10.0,
  "CurrentValue": 10.1,
  "PrimarySupplierContactId": 123,
  "PrimarySupplierItemCode": "XYZ",
  "DefaultReOrderQuantity": 5.0,
  "LastUpdatedId": "AAAAAKgc=",
  "IsVisible": true,
  "IsVirtual": false,
  "VType": "ZYX",
  "SellingPrice": 20.99,
  "IsSellingPriceIncTax": true,
  "CreatedDateUtc": "2025-10-27T18:00:11.9620876Z",
  "LastModifiedDateUtc": "2025-10-17T18:00:11.9620876Z",
  "LastModifiedBy": 123,
  "BuyingPrice": 10.2,
  "IsBuyingPriceIncTax": true,
  "IsVoucher": false,
  "ValidFrom": "2025-10-07T18:00:11.9620876Z",
  "ValidTo": "2025-11-16T18:00:11.9620876Z",
  "OnOrder": null,
  "Committed": null,
  "_links": []
}

application/xml, text/xml

Sample:

<ItemDetail xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <_links />
  <Id>12</Id>
  <Code>ABC</Code>
  <Description>Some item</Description>
  <Type>I</Type>
  <IsActive>true</IsActive>
  <IsInventoried>false</IsInventoried>
  <AssetAccountId>123</AssetAccountId>
  <IsSold>true</IsSold>
  <SaleIncomeAccountId>789</SaleIncomeAccountId>
  <SaleTaxCodeId>112</SaleTaxCodeId>
  <SaleCoSAccountId>456</SaleCoSAccountId>
  <IsBought>true</IsBought>
  <PurchaseExpenseAccountId>567</PurchaseExpenseAccountId>
  <PurchaseTaxCodeId>123</PurchaseTaxCodeId>
  <MinimumStockLevel>2</MinimumStockLevel>
  <StockOnHand>10</StockOnHand>
  <CurrentValue>10.10</CurrentValue>
  <PrimarySupplierContactId>123</PrimarySupplierContactId>
  <PrimarySupplierItemCode>XYZ</PrimarySupplierItemCode>
  <DefaultReOrderQuantity>5</DefaultReOrderQuantity>
  <LastUpdatedId>AAAAAKgc=</LastUpdatedId>
  <IsVisible>true</IsVisible>
  <IsVirtual>false</IsVirtual>
  <VType>ZYX</VType>
  <SellingPrice>20.99</SellingPrice>
  <IsSellingPriceIncTax>true</IsSellingPriceIncTax>
  <CreatedDateUtc>2025-10-27T18:00:11.9620876Z</CreatedDateUtc>
  <LastModifiedDateUtc>2025-10-17T18:00:11.9620876Z</LastModifiedDateUtc>
  <LastModifiedBy>123</LastModifiedBy>
  <BuyingPrice>10.20</BuyingPrice>
  <IsBuyingPriceIncTax>true</IsBuyingPriceIncTax>
  <IsVoucher>false</IsVoucher>
  <ValidFrom>2025-10-07T18:00:11.9620876Z</ValidFrom>
  <ValidTo>2025-11-16T18:00:11.9620876Z</ValidTo>
  <OnOrder xsi:nil="true" />
  <Committed xsi:nil="true" />
  <Notes>Some custom notes</Notes>
  <BuildItems>
    <BuildItem>
      <_links>
        <Link>
          <rel>detail</rel>
          <href>https://api.saasu.com/Item/1?FileId=123</href>
          <method>GET</method>
        </Link>
      </_links>
      <Id>1</Id>
      <Code>Code1</Code>
      <Description>Build Item 1</Description>
      <Quantity>5</Quantity>
    </BuildItem>
    <BuildItem>
      <_links>
        <Link>
          <rel>detail</rel>
          <href>https://api.saasu.com/Item/2?FileId=123</href>
          <method>GET</method>
        </Link>
      </_links>
      <Id>2</Id>
      <Code>Code2</Code>
      <Description>Build Item 2</Description>
      <Quantity>15</Quantity>
    </BuildItem>
  </BuildItems>
</ItemDetail>

Response Information

Resource Description

InsertItemResult

Name	Description	Type	Additional information
InsertedItemId	The id of the newly created/inserted inventory item.	integer	None.
LastUpdatedId	The unique identifier generated as part of the update. This value is required when submitting subsequent update to prevent concurrency errors.	string	None.
UtcLastModified	The date and time this resource was modified in UTC.	date	None.
_links	Hypermedia links. Contains contextual links to possible next actions related to this resource. Only present in responses. This data is not to be sent to the server.	Collection of Link	None.

Response Formats

application/json, text/json

Sample:

{
  "InsertedItemId": 123,
  "LastUpdatedId": "AAAAAFwWAN8=",
  "UtcLastModified": "2025-10-27T18:00:11.9620876Z",
  "_links": [
    {
      "rel": "self",
      "href": "https://api.saasu.com/Item/123?FileId=123",
      "method": "POST",
      "title": null
    },
    {
      "rel": "list",
      "href": "https://api.saasu.com/Items?FileId=123",
      "method": "GET",
      "title": null
    },
    {
      "rel": "update",
      "href": "https://api.saasu.com/Item/123?FileId=123",
      "method": "PUT",
      "title": null
    },
    {
      "rel": "delete",
      "href": "https://api.saasu.com/Item/123?FileId=123",
      "method": "DELETE",
      "title": null
    }
  ]
}

application/xml, text/xml

Sample:

<InsertItemResult xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <_links>
    <Link>
      <rel>self</rel>
      <href>https://api.saasu.com/Item/123?FileId=123</href>
      <method>POST</method>
    </Link>
    <Link>
      <rel>list</rel>
      <href>https://api.saasu.com/Items?FileId=123</href>
      <method>GET</method>
    </Link>
    <Link>
      <rel>update</rel>
      <href>https://api.saasu.com/Item/123?FileId=123</href>
      <method>PUT</method>
    </Link>
    <Link>
      <rel>delete</rel>
      <href>https://api.saasu.com/Item/123?FileId=123</href>
      <method>DELETE</method>
    </Link>
  </_links>
  <LastUpdatedId>AAAAAFwWAN8=</LastUpdatedId>
  <UtcLastModified>2025-10-27T18:00:11.9620876Z</UtcLastModified>
  <InsertedItemId>123</InsertedItemId>
</InsertItemResult>