Create product

Creates a new record.

POSThttps://api.tracksales.co/api/v1/products

Required scope: products:create

Body Params

namestringrequired

Product name

codestring

SKU / item code

retailPricenumber

Retail price

costPricenumber

Cost price

categoryIdinteger

Category ID

isServiceItemboolean

Service item flag

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Products was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/api/v1/products' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Widget A","code":"WGT-001","retailPrice":1200,"costPrice":800}'

{
    "success": true,
    "data": {
        "item_id": 101,
        "name": "Widget A",
        "code": "WGT-001",
        "retailPrice": 1200,
        "quantity": 45
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Products not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}