Upload Product Categories

Replaces your account's category taxonomy used by Purchase Categorisation — both receipt-level and product-level. Review what's currently stored with Export Product Categories.

🚧

Uploads replace, not merge

Each upload replaces your entire stored category list — categories missing from the file are removed. Always upload the complete taxonomy.

A minimal sample CSV:

categoryName,description
Food & Drink,Food and non-alcoholic drink purchases
Medication,Prescription and over-the-counter medicines
Toiletries,Personal-care and hygiene products

description is optional. Leave it empty when the category name already says what it means — less input often produces better categorisation. Add one only where the name alone is ambiguous.

categoryName values define the category labels used by categorisation. The service does not case-normalise these labels, so treat the exact uploaded spelling and casing as canonical and use it consistently when handling response values.

📘

Availability

Available on Startup plans and above. Access is account-configured; if this operation is unavailable, contact [email protected]. See Plans & Feature Access.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

For more details, see our Purchase Categorisation Guide

Body Params
file
required

CSV or TSV file with your list of categories (columns: categoryName, description).

Responses

413

Request body exceeds the 20 MiB (20,971,520-byte) HTTP body limit. See Document Types & File Requirements.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json