# Create Item Creates a new item (product or service). When omitted, unit defaults to service, the tax defaults to the account's default tax and rrp is computed from unit_price and the tax. Endpoint: POST /api/v3/items Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `item` (object, required) Item fields accepted on create and update. Any other key inside item is ignored. - `item.code` (string, required) Item name/code. Values longer than 60 characters are rejected with HTTP 422 (Code for the item is too long (maximum should be 60 characters)) — they are not truncated. On update, it cannot be changed once the item is used in a non-draft document (HTTP 422 Code can't be changed because it is already associated with invoices). Example: "Item name" - `item.description` (string,null) Values longer than 200 characters are rejected with HTTP 422 (Description is too long (maximum is 200 characters)) — they are not truncated. Example: "Item description" - `item.unit_price` (number, required) A missing or non-numeric value is rejected with HTTP 422 (Price is not valid. Check the decimal mark and if you are inserting only numbers.). Example: 9.99 - `item.rrp` (number) Recommended retail price. On create, when omitted, it is computed as unit_price plus the item's tax. On update, an omitted value is left unchanged. Example: 12.29 - `item.unit` (string) One of: hour, day, month, unit, service, tax, other, product, article. On create, defaults to service when omitted; on update, an omitted unit is left unchanged. Example: "service" - `item.tax` (object) Tax of the item, by name. When omitted, create uses the account's default tax and update keeps the current tax. An unknown name is rejected on create with HTTP 422 (Tax must exist); on update it is ignored and the current tax is kept. - `item.tax.name` (string) Example: "IVA23" - `item.retention` (number) Retention rate (%). Defaults to 0 when omitted. Example: 2 ## Response 201 fields (application/json): - `item` (object) - `item.id` (integer) Example: 1 - `item.code` (string) Example: "Item name" - `item.description` (string,null) Example: "Item description" - `item.unit_price` (number) Example: 9.99 - `item.rrp` (number) Example: 12.29 - `item.unit` (string) One of: hour, day, month, unit, service, tax, other, product, article. Example: "service" - `item.tax` (object) - `item.tax.name` (string) Example: "IVA23" - `item.tax.value` (number) Example: 23 - `item.retention` (number) Example: 2 ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)