Create Inventory | Papertracc Docs

curl -X POST https://api.papertracc.com/v1/sales/inventory \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Office Desk",
  "type": "GOODS",
  "usage": "SALE_AND_PURCHASE",
  "cost_prices": [
    {
      "rate": 100000,
      "currency_code": "NGN"
    }
  ],
  "sales_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
  "tax_inclusive": true,
  "selling_prices": [
    {
      "rate": 150000,
      "currency_code": "NGN"
    }
  ],
  "purchase_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
  "sales_account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
  "sales_description": "Office desk sold to customers",
  "purchase_vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
  "purchase_account_id": "e35f42b4-a6e2-4664-96df-d2cf3f1a6f33",
  "purchase_description": "Office desk purchased from vendors"
}'

{
  "data": {
    "id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
    "sku": "SKU-1001",
    "name": "Office Desk",
    "type": "GOODS",
    "usage": "SALE_AND_PURCHASE",
    "amount": "150000.00",
    "created_at": "2026-06-18T10:00:00Z",
    "project_id": "spruce-demo",
    "cost_prices": [
      {
        "rate": 100000,
        "currency_code": "NGN"
      }
    ],
    "sales_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
    "selling_prices": [
      {
        "rate": 150000,
        "currency_code": "NGN"
      }
    ],
    "purchase_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
    "is_tax_inclusive": true,
    "sales_account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
    "sales_description": "Office desk sold to customers",
    "purchase_vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "purchase_account_id": "e35f42b4-a6e2-4664-96df-d2cf3f1a6f33",
    "purchase_description": "Office desk purchased from vendors"
  },
  "status": true,
  "message": "Successfully created inventory"
}

Creates an inventory item with sales and purchase account/tax mappings.

Requires the can_create_sales_inventory permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Request

This endpoint expects an object.

namestringRequired

typestringRequired

usagestringRequired

cost_priceslist of objectsOptional

sales_tax_idstringOptionalformat: "uuid"

tax_inclusivebooleanOptional

selling_priceslist of objectsOptional

purchase_tax_idstringOptionalformat: "uuid"

sales_account_idstringOptionalformat: "uuid"

sales_descriptionstringOptional

purchase_vendor_idstringOptionalformat: "uuid"

purchase_account_idstringOptionalformat: "uuid"

purchase_descriptionstringOptional

Response

Created

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error